Plugin Config Dosyası Nasıl Düzenlenir?

Minecraft eklenti yapılandırma dosyalarını güvenli ve doğru şekilde düzenlemenin temel kuralları.

📖 3 dk okuma ⛏ Sunucu sahipleri için

Her Minecraft eklentisi ayarlarını plugins/EklentiAdi/ klasöründeki dosyalarda saklar. En yaygın dosya config.yml'dir; ayrıca messages.yml, data.yml gibi dosyalar da olabilir. Bu dosyalar eklentinin davranışını belirler.

⚠ İlk kural: Her düzenlemeden önce dosyanın kopyasını alın. Hatalı config eklentiyi veya sunucuyu çökertebilir.
  1. Sunucuyu durdurun veya dosyayı FTP/panel üzerinden indirin.
  2. config.yml.bak gibi bir yedek adıyla kaydedin.
  3. Değişiklikleri uygulayın ve test edin.
  4. Sorun olursa yedeği geri yükleyin.

Tipik bir config hiyerarşik YAML yapısındadır:

# Eklenti ayarları
enabled: true
debug: false

# Alt bölüm
economy:
  starting-balance: 1000
  currency-symbol: "₺"

# Liste
disabled-worlds:
  - world_nether
  - world_the_end

Yorum satırları # ile başlar; parser bunları yok sayar. Açıklayıcı yorumlar ileride işinize yarar.

  • Boşluk kullanın, tab kullanmayın. Girinti tutarlı olmalı (genelde 2 boşluk).
  • İki noktadan sonra boşluk: anahtar: değer
  • Boolean değerler: true veya false (tırnaksız)
  • Sayılar: Tırnaksız yazın — port: 25565
  • Metinler: Özel karakter varsa tırnak içine alın — message: "Merhaba: dünya"
  • Renk kodları: & veya § kullanımı eklentiye göre değişir; dokümantasyona bakın.

Detaylı girinti kuralları için YAML Girinti Hataları rehberine bakın.

Bazı ayarlar anında, bazıları yeniden başlatma gerektirir:

  • /reload — hızlı ama riskli; eklenti bellek sızıntılarına yol açabilir.
  • Tam yeniden başlatma — config değişiklikleri için önerilen yöntem.
  • Birçok eklenti kendi reload komutunu sunar: /eklentiadi reload
✓ İpucu: Canlı sunucuda büyük config değişikliklerini düşük oyuncu sayısında veya bakım modunda yapın.

Dosyayı kaydettikten sonra:

  1. Metni YAML Kontrol Aracına yapıştırıp sözdizimini kontrol edin.
  2. Sunucuyu başlatın ve konsol loglarını izleyin.
  3. Could not load config veya YAMLException görürseniz satır numarasına gidin.
  4. Çalışmıyorsa yedeği geri yükleyin ve değişiklikleri küçük adımlarla tekrarlayın.