Minecraft eklentilerinin çoğu, ayarlarını YAML formatında (.yml) saklar. YAML, insan tarafından okunması kolay ama küçük hatalara karşı oldukça hassas bir formattır.

En Sık Yapılan Hatalar

1. Tab (Sekme) Kullanmak

YAML'de Tab tuşu kesinlikle kullanılmamalıdır YAML formatı yalnızca boşluk (space) karakterini girinti için kabul eder. Tab tuşuna bastığınızda, çoğu editör görsel olarak boşluğa benziyormuş gibi gösterse de, arka planda farklı bir karakter kaydedilir ve dosya "malformed" (bozuk) hale gelir. Notepad++ gibi editörlerde Tab tuşunu otomatik boşluğa çeviren bir ayar bulunur — bunu etkinleştirin.

2. Tutarsız Girinti

Aynı seviyedeki satırlar, birebir aynı sayıda boşlukla girintili olmalıdır. Bir satırda 2 boşluk, altındaki aynı seviyedeki satırda 3 boşluk kullanmak hataya yol açar.

3. İki Nokta Üst Üste Sonrası Boşluk Unutmak

# Yanlış
mesaj:"Merhaba"

# Doğru
mesaj: "Merhaba"

YAML'de : işaretinden sonra her zaman bir boşluk olmalıdır.

4. Özel Karakter İçeren Metni Tırnaksız Bırakmak

:, #, & gibi özel karakterler içeren metinleri tırnak içine almadan yazmak, YAML'in bunu yanlış yorumlamasına sebep olabilir.

Hata Nasıl Fark Edilir?

Sunucu başlarken konsolda genelde "could not load config" veya "YAML syntax error" gibi bir mesaj görürsünüz — bazen hatanın hangi satırda olduğu da belirtilir.

Hızlı Çözüm: Online YAML Doğrulayıcı

Dosya içeriğini bir online YAML doğrulayıcıya (arama motorunda "YAML validator" araması yeterli) yapıştırarak, hangi satırda söz dizimi hatası olduğunu hızlıca bulabilirsiniz.

Son Çare: Varsayılana Dönme

Dosyayı tamamen bozduysanız, o config dosyasını silip sunucuyu yeniden başlatarak eklentinin varsayılan ayarlarla yeni bir dosya oluşturmasını sağlayabilir, değişikliklerinizi daha dikkatli şekilde tekrar uygulayabilirsiniz.