v1.0
EklentiKararlı

Yapılandırma Dosyaları

Config, menü, dil ve veri klasörlerinin görevleriyle güvenli YAML düzenleme kuralları.

v1.0·Minecraft 1.21.11·Paper·Java 21

Klasör düzeni

text
plugins/AeroOneBlock/
├─ config/
│  ├─ general.yml
│  ├─ worlds.yml
│  ├─ island-settings.yml
│  ├─ oneblock.yml
│  ├─ upgrades.yml
│  ├─ generators.yml
│  ├─ upgrade-requirements.yml
│  ├─ bossbar.yml
│  ├─ block-levels.yml
│  ├─ tiers.yml
│  └─ messages.yml
├─ menus/
│  ├─ settings.yml
│  ├─ main.yml
│  └─ pages.yml
├─ lang/
│  ├─ en.yml
│  ├─ tr.yml
│  ├─ de.yml
│  ├─ fr.yml
│  └─ custom.yml
└─ data/
   ├─ islands.yml
   ├─ players.yml
   └─ player-progress.yml

Dosyaların sorumluluğu

DosyaSorumluluk
general.ymlDil, genel periyotlar ve üst düzey özellik anahtarları.
worlds.ymlYönetilen dünyaların adları ve dünya ayarları.
island-settings.ymlSpacing, başlangıç, platform, trust, silme, kurtarma ve ön üretim.
oneblock.ymlMerkez blok, destek bloğu ve yenileme davranışı.
tiers.ymlOneBlock blok/mob/kasa ilerleme havuzları.
upgrades.ymlUpgrade değerleri, ortak koşullar, maliyetler ve menü kartları.
generators.ymlLav-su jeneratörü tierleri ve ağırlıkları.
upgrade-requirements.ymlOyuncuya özel gelişmiş upgrade gereksinimleri.
block-levels.ymlBlok puanları, audit ve event güncellemeleri.
bossbar.ymlİlerleme çubuğu görünümü ve yenileme aralığı.
messages.ymlGenel mesaj geçersiz kılmaları ve mesaj kapatma.
menus/*.ymlGUI durumu, düzeni, itemları, slotları ve sesleri.
lang/*.ymlOyuncu mesajları, dil adları ve menü cümleleri.

YAML kuralları

  • Girintide sekme değil boşluk kullanın.
  • Material ve entity adlarını hedef Minecraft sürümündeki enum adıyla yazın.
  • Ondalıklı değerlerde virgül değil nokta kullanın.
  • : içeren serbest metinleri tırnak içine alın.
  • Paralel upgrade listelerinin uzunluğunu değiştirdiğinizde ilişkili listeleri birlikte güncelleyin.
  • Canlı data/ dosyalarını sunucu çalışırken elle düzenlemeyin.

Mesaj kapatma

Bir mesajı '' yapmak bilinçli kapatma sayılır. config/messages.yml içindeki boş değer bütün dilleri; yalnız belirli lang/<dil>.yml içindeki boş değer o dili etkiler. Anahtarın silinmesi aynı davranış değildir; eksik anahtar varsayılan metinle tamamlanabilir.

Reload ve fiziksel ayarlar

/aerooneblock reload, yapılandırma, menü ve dilleri yeniden okur. Hatalı YAML veya geçersiz değer kabul edilmezse çalışan yapılandırma korunur. Dünya adı, spacing ve merkez koordinatı gibi fiziksel alanlar reload ile mevcut adaları taşımaz. Bu değerler canlı kurulumdan sonra yalnız planlı bakım ve yedekle değiştirilmelidir.

Eski yapılandırma geçişi

Eski kök dosyalar ve stages: biçimi tanınır. Yeni hedef dosya yoksa içerik kategorili klasörlere kopyalanabilir; eski dosyalar otomatik silinmez. Mevcut yeni dosyalar ezilmez ve özel tier/boş blok listelerine varsayılan içerik zorla eklenmez.