Minecraft eklentilerinin büyük çoğunluğu ayarlarını YAML dosyalarında tutar: config.yml, messages.yml, permissions.yml vb. Tek bir girinti hatası bile eklentinin yüklenmemesine veya ayarların yok sayılmasına neden olur.
YAML hiyerarşiyi boşluklarla belirler. Aynı seviyedeki anahtarlar aynı hizada olmalıdır:
# Doğru
settings:
enabled: true
debug: false
messages:
welcome: "Hoş geldin!"
Alt öğe, üst öğeden 2 boşluk (veya tutarlı bir miktar) içeride olmalıdır.
⚠ En yaygın hata: YAML dosyalarında Tab tuşu kullanmayın. Yalnızca boşluk (space) kullanın. Editörünüzde "Tab → boşluk dönüştür" seçeneğini açın.
Tab ve boşluk karışımı görünmezdir; dosya düzgün görünür ama parser hata verir:
settings:
enabled: true # 4 boşluk
debug: false # tab + boşluk — HATA!
İki nokta sonrası boşluk eksikliği
# Yanlış
name:Değer
# Doğru
name: Değer
Tırnak gerektiren değerler
İki nokta, süslü parantez veya # içeren metinler tırnak içine alınmalıdır:
message: "Sunucu: play.ornek.com"
motd: "§aAktif §7• §e%online% oyuncu"
Liste girintisi
worlds:
- world
- world_nether
- world_the_end
- işaretinden sonra bir boşluk bırakın.
- Yedek alın: Düzenlemeden önce orijinal dosyayı kopyalayın.
- Tab temizleyin: Tüm tab karakterlerini 2 boşlukla değiştirin.
- Konsol hatasını okuyun: Satır numarası genelde gösterilir.
- Kontrol edin: Metni YAML Kontrol Aracına yapıştırın.
- Test edin:
/reloadyerine mümkünse sunucuyu yeniden başlatın.
✓ İpucu: VS Code, Notepad++ veya YAML eklentili editörler girinti hatalarını renkle gösterir.