Discord sunucumuzda destek talebi oluşturmadan önce lütfen bu sayfadaki yaygın sorunları ve çözüm yollarını inceleyin. Hataların %90’ı genellikle sürüm veya config uyumsuzluklarından kaynaklanmaktadır.
⚙️ Kurulum ve Konsol Hataları
Eklentiyi klasöre attım ama /pl yazınca kırmızı gözüküyor veya hiç çalışmıyor.
Eklentiyi klasöre attım ama /pl yazınca kırmızı gözüküyor veya hiç çalışmıyor.
Bu durum eklentinin başlatılamadığını gösterir. Konsol loglarını (
latest.log) kontrol edin. Başlıca sebepleri:- Eski Java Sürümü: Konsolda
UnsupportedClassVersionErrorgörüyorsanız, Java sürümünüz yetersizdir. Java 17 veya 21 kullanmanız gerekir. - Eksik Bağımlılık (Dependency): Eklentinin çalışması için Vault, PlaceholderAPI gibi eklentilerin sunucunuzda kurulu ve güncel olması gerekebilir.
Konsolda 'Could not pass event...' hatası alıyorum.
Konsolda 'Could not pass event...' hatası alıyorum.
Bu hata genellikle eklenti oyun içi bir tetikleyiciyi (örn: oyuncu ölmesi, blok kırılması) işlerken bir veriye ulaşamadığında çıkar.
config.ymldosyanızda sildiğiniz veya eksik bıraktığınız bir satır olabilir.- Olayın yaşandığı Minecraft sürümü ile eklentinin desteklediği API arasında uyuşmazlık olabilir. Config dosyanızı yedekleyip silin ve eklentinin yeni bir config oluşturmasına izin verin.
Eklentiyi kurdum ama komutları yazdığımda 'Bilinmeyen Komut' hatası veriyor.
Eklentiyi kurdum ama komutları yazdığımda 'Bilinmeyen Komut' hatası veriyor.
Eklenti konsolda başarılı bir şekilde aktifleştiği (
[AtlantisProject] Plugin Enabled!) halde komutlar çalışmıyorsa, kullandığınız yetki eklentisinde (LuckPerms vb.) kendinize gerekli admin yetkilerini (permissions) vermemiş olabilirsiniz veya eklentinin başka bir eklentiyle komut çakışması (örn: /klan komutunu başka bir pluginin de kullanması) yaşanıyor olabilir.💾 Veritabanı (MySQL & SQLite) Sorunları
Verilerim kaydedilmiyor veya sunucu yeniden başlayınca sıfırlanıyor.
Verilerim kaydedilmiyor veya sunucu yeniden başlayınca sıfırlanıyor.
Eğer varsayılan veritabanı olarak SQLite (yerel dosya) kullanıyorsanız ve sunucunuz crash yiyip aniden kapanırsa (veya panelden zorla durdurulursa), veriler
.db dosyasına yazılamadan kaybolabilir. Sunucuyu her zaman /stop komutu ile güvenli bir şekilde kapatın. BungeeCord/Velocity gibi büyük ağlarda mutlaka MySQL kullanın.MySQL bağlantısı kuramıyorum, 'Communications link failure' veriyor.
MySQL bağlantısı kuramıyorum, 'Communications link failure' veriyor.
Bu tamamen makinenizin ağ ayarlarıyla ilgili bir durumdur. Şunları kontrol edin:
config.ymliçindeki veritabanı adı, kullanıcı adı, şifre ve port (genelde 3306) bilgilerinin doğruluğu.- Eğer veritabanı farklı bir makinedeyse, o makinenin dış bağlantılara (Remote MySQL) açık olup olmadığı.
- Güvenlik duvarınızın (Firewall) 3306 portunu engelleyip engellemediği.
🧩 PlaceholderAPI ve Değişkenler
Scoreboard veya Tab'da değişkenler (örn: %atlantis_klan%) çalışmıyor, olduğu gibi metin olarak gözüküyor.
Scoreboard veya Tab'da değişkenler (örn: %atlantis_klan%) çalışmıyor, olduğu gibi metin olarak gözüküyor.
Değişkenlerin çalışması için öncelikle sunucunuzda PlaceholderAPI eklentisinin yüklü olması gerekir. Ardından, oyun içinden
/papi reload komutunu yazarak sistemin yeni değişkenleri tanımasını sağlamalısınız. Eğer eklentimiz harici bir PAPI eklentisi (expansion) gerektiriyorsa, kurulum adımlarını doğru uyguladığınızdan emin olun.Sohbet (Chat) formatında renk kodları veya klan tagı gözükmüyor.
Sohbet (Chat) formatında renk kodları veya klan tagı gözükmüyor.
Kullandığınız sohbet yönetim eklentisi (örn: EssentialsChat, LPC, ChatControl) PlaceholderAPI değişkenlerini doğrudan desteklemiyor olabilir. Sohbet eklentinizin config dosyasından PlaceholderAPI desteğinin aktif (
true) olup olmadığını kontrol edin.🎨 Özelleştirme ve Config (YAML) Ayarları
Config dosyasını düzenledikten sonra eklenti bozuldu veya sıfırlandı.
Config dosyasını düzenledikten sonra eklenti bozuldu veya sıfırlandı.
YAML dosyaları karakter hatalarına karşı çok hassastır. Büyük ihtimalle:
- Boşluk bırakmak yerine TAB tuşunu kullandınız (YAML dosyalarında TAB tuşu kullanılmaz, sadece boşluk tuşu kullanılır).
- Metinlerin başındaki veya sonundaki tırnak işaretlerini (
'...'veya"...") yanlışlıkla sildiniz. - Türkçe karakter sorunu olmaması için dosyayı UTF-8 formatında kaydettiğinizden emin olun. (YAML Validator sitelerini kullanarak dosyanızı test edebilirsiniz).
Hex (RGB) ve Gradient (Geçişli) renk kodlarını nasıl kullanırım?
Hex (RGB) ve Gradient (Geçişli) renk kodlarını nasıl kullanırım?
Eklentilerimiz 1.16+ üstü sürümler için modern renk kodlarını destekler. Genellikle
&#RRGGBB formatını kullanabilirsiniz. Örneğin: turuncu gölgeli veya özel renkli bir metin yapmak için &#FFA500Bu bir turuncu metindir şeklinde yazabilirsiniz. Klasik Minecraft renk kodları (&a, &b, &l) her zaman desteklenmektedir.⚡ Performans (TPS & Lag)
Eklentileriniz sunucumda TPS düşüşüne veya lag'a sebep olur mu?
Eklentileriniz sunucumda TPS düşüşüne veya lag'a sebep olur mu?
Kesinlikle hayır. AtlantisProject eklentilerinin mimarisi tamamen optimizasyon odaklıdır. Veritabanı kayıtları (MySQL/SQLite) ve oyuncu veri çekme işlemleri Asenkron (Async) olarak ayrı iş parçacıklarında (threads) yapılır. Bu sayede sunucunun ana thread’i (Main Thread) meşgul edilmez ve oyun akışında donma yaşanmaz.
📞 Hâlâ Çözüm Bulamadınız Mı?
Yukarıdaki çözümler işinize yaramadıysa veya karşılaştığınız sorun burada yer almıyorsa, doğrudan geliştirici ekibimizden destek alabilirsiniz.Destek Talebi (Ticket) Oluşturun
Discord sunucumuza katılarak ‘Destek’ kanalından bilet oluşturun. Lütfen sorununuzu açıklarken konsol loglarınızı (latest.log) göndermeyi unutmayın.