Plugin Paketi Kurduktan Sonra Hiçbir Şey Çalışmıyor? 15 Yaygın Hata ve Çözümü

Plugin paketini sunucunuza yüklediniz, stop komutuyla restart ettiniz, konsolu açtınız... Gözünüz kırmızı ERROR satırlarına takıldı. Pluginler ya hiç yüklenmiyor, ya yüklendi gözüküp komut yazınca çalışmıyor, ya da sunucu başlangıçta crash atıyor. Bu sayfa, plugin paketi yükledikten sonra karşınıza çıkabilecek 15 en yaygın sorunu ayrıntılı olarak ele alır: her sorun için tipik log çıktısı, kök nedeni ve adım adım çözümü.

Log okuma, Minecraft sunucu yöneticisinin en değerli becerisidir. ERROR ile başlayan her satırın bir nedeni vardır ve bu neden 9/10 durumda direkt orada yazılıdır. Log''u görmezden gelmek sorunları büyütür; her zaman önce logs/latest.log dosyasını açın.

# Sorun 1: NoClassDefFoundError

[ERROR]: Could not load plugin ChestShop.jar
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
    at com.Acrobot.ChestShop.ChestShop.onEnable()
    ... (stack trace)

Neden: Plugin başka bir plugin''in class''ına erişmeye çalışıyor ama o plugin yok. Örnekte ChestShop, Vault''a bağımlı ama Vault yüklenmemiş.

Çözüm: Eksik bağımlılığı plugins/ klasörüne ekleyin, sunucuyu tam restart edin. Her plugin''in plugin.yml''ini kontrol edip depend: alanını inceleyin:

# Tüm pluginlerin bağımlılıklarını topluca göster
for jar in plugins/*.jar; do
  echo "=== $jar ==="
  unzip -p "$jar" plugin.yml | grep -E "^(name|depend|softdepend):"
  echo
done

# Sorun 2: UnsupportedClassVersionError

[ERROR]: has been compiled by a more recent version of the Java Runtime
(class file version 65.0), this version of the Java Runtime only recognizes
class file versions up to 61.0

Neden: Plugin, sizin Java sürümünüzden daha yenisi ile derlenmiş. 61.0 = Java 17, 65.0 = Java 21. Plugin Java 21 ile yapılmış, siz Java 17 kullanıyorsunuz.

Çözüm: Java sürümünüzü yükseltin.

# Mevcut Java sürümünü kontrol
java -version

# Ubuntu/Debian için Java 21 kurulumu
apt update
apt install -y openjdk-21-jre-headless

# Varsayılan Java''yı ayarlama
update-alternatives --config java

# Kontrol
java -version  # openjdk 21.x.x olmalı

# Sorun 3: YAML Parse Error (config hatası)

[ERROR]: Could not load 'plugins/EssentialsX/config.yml'
while parsing a block mapping
  in 'reader', line 45, column 3:
      message: 'Test
      ^
expected <block end>, but found '<scalar>''

Neden: Config dosyası YAML formatında bozuk. Tipik nedenler: eksik tırnak, yanlış girinti (tab kullanımı), kapatılmamış string.

Çözüm: Belirtilen satıra bakın. YAML validator kullanın:

# Yerel dosyayı doğrulama
python3 -c "import yaml; yaml.safe_load(open('plugins/EssentialsX/config.yml'))"

# Online: https://www.yamllint.com/
# VSCode: YAML eklentisi kırmızı altı çizerek hataları gösterir

# Sorun 4: Sunucu Başlamıyor, Java Hata Veriyor

Error occurred during initialization of VM
Could not reserve enough space for 4194304KB object heap

Neden: Sunucunun istediği RAM''i sistem ayıramıyor. Ya sunucuda yeterli RAM yok ya Java 32-bit.

Çözüm:

# Toplam RAM kontrolü
free -h

# Java mimarisi kontrolü
java -d64 -version  # 64-bit ise "Running in 64-bit mode" görünür

# Başlatma komutundaki -Xmx değerini düşürün
# Örnek: 4GB yerine 2GB
# -Xms2G -Xmx2G

# Sorun 5: Port Zaten Kullanımda

[ERROR]: The exception was: java.net.BindException: Address already in use
[ERROR]: Perhaps a server is already running on that port?

Neden: 25565 (veya server.properties''te ne yazdıysa) portu başka bir process tarafından tutuluyor.

Çözüm:

# Portu kim tutuyor?
sudo lsof -i :25565
sudo netstat -tulpn | grep 25565

# Process öldür
sudo kill -9 <PID>

# Alternatif: server.properties''te port değiştir
# server-port=25566

# Sorun 6: MySQL Bağlantı Hatası

[ERROR] Failed to connect to database
com.mysql.cj.jdbc.exceptions.CommunicationsException:
Communications link failure

Neden: MySQL/MariaDB servisine bağlanılamıyor. Yanlış host, port, şifre veya MySQL kapalı.

Çözüm kontrol listesi:

• systemctl status mariadb — servis çalışıyor mu?
• mysql -u user -p ile komut satırından bağlantı deneyin
• Config''teki host localhost veya 127.0.0.1 mi?
• Uzak MySQL için bind-address açık mı?
• Firewall 3306 portunu engelliyor mu?
• Kullanıcıya yetki verilmiş mi? SHOW GRANTS FOR 'user'@'localhost';

# Sorun 7: Plugin Yüklenmiş Gibi Gözüküyor Ama Komutlar Çalışmıyor

/home komutunu yazınca: Unknown command. Type "/help" for help.

Neden: Plugin yüklendi ama permission verilmemiş ya da başka plugin aynı komutu kapsıyor.

Çözüm:

# 1. Önce permission kontrolü
/lp user <oyuncu> permission check essentials.home

# 2. Komut çakışması var mı?
/version  # her plugin listeyse orada görünür
/plugin info EssentialsX  # hangi komutları sağlıyor?

# 3. Plugin aktif mi?
/plugins  # EssentialsX yeşil mi?

# 4. Alternatif: plugin adıyla komut çalıştır
/essentials:home

# Sorun 8: Dünya Yüklenmiyor (World Corruption)

[ERROR]: Couldn't load chunk [10, 20]: Region file not found.
[ERROR]: Failed to load world 'world': null

Neden: Dünya dosyaları bozuk veya eksik. Genelde sunucuyu zorla kapatmak (Ctrl+C, kill -9) sonrası olur.

Çözüm:

• Yedek varsa yedekten geri dön
• MCEdit veya Amulet ile world''ü aç, problem chunk''ı sil
• world/level.dat bozuksa world/level.dat_old''dan kopyala
• En son çare: yeni dünya oluştur, eski dünyadan kritik yapıları WorldEdit ile taşı

# Sorun 9: TPS Sürekli Düşük

Konsolda sık sık Can''t keep up! Is the server overloaded? mesajı, oyuncular lag''den şikayetçi, TPS 15 civarında.

Neden: Sunucu kapasitesinin üstünde iş yapıyor. Genelde: fazla entity (mob, item), fazla chunk yüklü, ağır plugin veya disk I/O sorunu.

Çözüm: Spark ile profil alıp kök nedeni bulun.

/spark profiler --timeout 120
# 120 saniye sonra otomatik bitecek, sonuç bir link olacak
# Link üzerinden hangi plugin CPU harcıyor görünür

# Sorun 10: Plugin Crash Atıyor

[SEVERE]: Error occurred while enabling PluginAdi v1.0.0
java.lang.NullPointerException
    at com.example.plugin.Main.onEnable(Main.java:45)

Neden: Plugin kod hatası. Genelde config dosyasında eksik alan, yanlış format veya API değişikliği.

Çözüm:

• Config''i silin, sunucu yeniden başlat → plugin default config oluşturur
• Plugin versiyonunu güncelle, belki bu bir bug''tı
• Developer GitHub Issues''a git, aynı hata var mı?
• Minecraft sürümünüz desteklenmiyor olabilir

# Sorun 11: Menü (GUI) Açılmıyor

Konsola hata düşmez ama oyuncu /shop yazınca hiçbir şey olmaz veya boş envanter açılır.

Neden: Genelde ProtocolLib sürümü yanlış veya PAPI eksik. Modern GUI pluginlerinin çoğu PAPI placeholder''ları ile item lore''una veri basar; PAPI yoksa menü kırılır.

Çözüm:

# PlaceholderAPI güncel mi?
/papi version
# Gerekirse: /papi ecloud download <genişletme>
/papi ecloud download Player
/papi ecloud download Vault
/papi reload

# ProtocolLib güncel mi?
/version ProtocolLib
# Güncel sürümü: https://www.spigotmc.org/resources/protocollib/

# Sorun 12: Oyuncu Veriler Kayboluyor

Oyuncular çıkıp girince inventory, homeları, ekonomisi kaybolur. Rastgele değil, düzenli.

Neden: Veri kaydetme sırasında hata veya duplicate player data.

• İki ekonomi plugini açık: EssentialsXEcon + CMIEcon gibi. Birini devre dışı bırak
• MySQL autocommit kapalı: Config''te auto-commit: true olduğundan emin ol
• UUID değişken: Offline mode''da UUID isime göre oluşur; isim değişti mi veri kayıp
• World corruption: Player data world/playerdata/''da, corrupt ise okunmaz

# Sorun 13: Chat Mesajları İki Defa Gözüküyor

Oyuncu merhaba yazıyor, chat''te merhaba merhaba görünüyor.

Neden: İki chat formatter plugini birden çalışıyor. EssentialsXChat + DeluxeChat + CMI chat gibi.

Çözüm: Tek bir chat plugin''i bırakın, diğerini plugins klasöründen çıkarın.

# Sorun 14: Kick Atıldım/Bağlanamıyorum: Internal Exception

Client disconnected: Internal Exception:
io.netty.handler.codec.DecoderException: java.io.IOException:
Payload may not be larger than 1048576 bytes

Neden: Paket boyutu limiti aşıldı. Genelde ProtocolLib veya disguise plugini çok büyük paket gönderiyor.

Çözüm:

• ProtocolLib''i güncelle
• plugins/ProtocolLib/config.yml''de compression-threshold''ı düşür
• Disguise plugini eski sürümü ise güncelle
• paper-global.yml''de max-bytes-per-second''ı artır

# Sorun 15: Sunucu Zaman Zaman Donuyor ve Sonra Normale Dönüyor

TPS sürekli 20 ama her 5 dakikada bir 10 saniye donuyor. Garbage Collection spike''ı.

Neden: JVM GC ayarları suboptimal. Büyük -Xmx değeri ile varsayılan GC kullanıyorsanız 10-15 saniyelik stop-the-world pause''ları normaldir.

Çözüm: Aikar''s Flags ile G1GC ayarlarını kullanın:

# Aikar''s flags (Paper için optimize)
java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 \
  -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M \
  -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 \
  -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 \
  -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 \
  -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true \
  -jar paper.jar nogui

# Log Okuma Sanatı

Her sorunu çözmenin formülü aynı: log''u aç, ERROR veya WARN satırlarını bul, stack trace''i oku. Log dosyası yapısı:

logs/
├── latest.log          # Şu an çalışan sunucunun logu
├── 2026-04-15-1.log.gz # Dünkü log (sıkıştırılmış)
├── 2026-04-14-1.log.gz
└── ...

Log formatı:

[16:23:45 INFO]: [EssentialsX] Loading EssentialsX v2.20.1
[16:23:45 WARN]: [ChestShop] Could not find Vault, disabling...
[16:23:46 ERROR]: Plugin PluginAdi generated an exception:
    java.lang.NullPointerException
        at com.example.plugin.Main.onEnable(Main.java:45)

[timestamp] [seviye]: [plugin] mesaj

INFO: bilgi, göz ardı edilebilir. WARN: uyarı, dikkatli olun. ERROR: hata, çözülmeli. SEVERE / FATAL: kritik, sunucu düştü veya düşecek.

# Teşhisi Hızlandıran Araçlar

• Spark: TPS, MSPT, thread profili, memory
• mcstatus / mcping: Sunucu dışardan erişilebilir mi?
• pastebin log upload: Log''u paylaşıp başkalarından yardım alma
• Minecraft Server Status Checker: Port açık mı, SRV kaydı var mı
• JStack (Java): Thread dump, deadlock tespit
• VisualVM: JVM memory profiling

# Hata Çözüm Akış Şeması

Herhangi bir sorunla karşılaştığınızda izleyin:

1. Sunucu kapalı mı? → Başlat
     ↓ (evet, çalışıyor)
2. logs/latest.log''u aç
     ↓
3. En eski ERROR satırını bul
     ↓
4. Stack trace''in ilk satırı plugin adını söyler
     ↓
5. Hata mesajını Google''da ara (örn: "NoClassDefFoundError Vault")
     ↓
6. Çözümü uygula, sunucuyu restart et
     ↓
7. Log''u tekrar oku, ERROR var mı?
     ↓ (evet)  ↓ (hayır)
  Adım 3''e     → Sorun çözüldü

# Ne Zaman Destek Talep Etmeli?

Yukarıdaki 15 sorunu çözmeyi deneyip hâlâ takıldıysanız, profesyonel destek zamanı geldi. Destek talep etmeden önce hazırlayın:

• Sunucu versiyonu (örn: Paper 1.20.4)
• Java sürümü (java -version)
• İşletim sistemi (uname -a)
• RAM/CPU bilgisi (free -h, nproc)
• Plugin listesi (/plugins çıktısı)
• Son 100 satır log (tail -n 100 logs/latest.log)
• Spark raporu linki (varsa)
• Sorunun ne olduğuna dair net açıklama

# Plugin Paketi Kurulumundan Sonra İlk Hafta

Paket kurulumundan sonraki ilk hafta en kritik dönemdir. Genelde sorunların %80''i bu dönemde ortaya çıkar. Günlük kontrol listesi:

# Günlük Yapılması Gerekenler (İlk 7 Gün)

• Sabah: Log''u aç, yeni ERROR var mı kontrol et
• Öğle: /tps ile performans kontrolü
• Akşam: Oyunculardan feedback topla, sorun var mı?
• Gece: Backup al, disk doluluk kontrol et

# Haftalık Yapılması Gerekenler

• Spark profiler ile detaylı performans analizi
• Plugin update kontrolü (PluginUpdater plugini kurarak otomatikleştirebilirsiniz)
• MySQL database''inin büyüklüğü ve index optimizasyonu
• World backup''ların başka bir konuma (S3, başka VPS) taşınması
• Oyuncu ban/mute loglarının gözden geçirilmesi

# Profesyonel Log Analizi: Grep ile Hızlı Teşhis

Log dosyaları büyüdükçe manuel okumak imkansız hale gelir. Linux''ta grep, awk ve tail kombinasyonları saatlerce iş tasarrufu sağlar:

# Son 1 saatteki tüm ERROR''ları göster
grep -E "\[.{5} ERROR\]" logs/latest.log

# Her ERROR''un plugin''ini bul ve say
grep -E "ERROR" logs/latest.log | grep -oP "\[\w+\]" | sort | uniq -c | sort -rn

# Son 1 saatteki TPS warning''leri
grep "Can''t keep up" logs/latest.log

# Bir plugin hakkındaki tüm log satırları
grep "EssentialsX" logs/latest.log | tail -100

# Stack trace''in ilk 5 satırını göster
grep -A 5 "Exception" logs/latest.log | head -50

# Tüm gzip''li logların birleşimi (eski loglar)
zgrep -h "OutOfMemoryError" logs/*.log.gz logs/latest.log

# Yardım Alırken Nasıl Doğru Açıklarsınız?

Discord''da plugin çalışmıyor yazmak size cevap getirmez. Profesyonel bir yardım talebinin formatı:

# Kısa Özet
EssentialsX pluginim yüklendikten sonra oyuncular /home yazamıyor.

# Ortam
- Paper 1.20.4 build 497
- Java 21.0.1
- Ubuntu 22.04, 4 GB RAM
- 38 plugin toplam

# Hata
Oyuncu /home yazdığında:
> Unknown command. Type "/help" for help.

# Log (/plugins çıktısı)
EssentialsX v2.20.1 - GREEN (çalışıyor gibi)

# Denenenler
- /lp user TestUser permission check essentials.home → denied
- LuckPerms''te default grubuna essentials.home eklendi
- /lp reload yapıldı

# Beklenen
/home komutunun çalışması

Bu formatta bir soru 10 dakikada çözülür; çalışmıyor sorusuna günlerce yanıt gelmeyebilir.

# Sık Sorulan Sorular

# Logda ERROR var ama sunucu düzgün çalışıyor gibi, umursamayayım mı?

Hayır, her ERROR bir şeylerin yanlış gittiğini gösterir. Şu anda sunucu çalışıyor olabilir ama 2 hafta sonra sorunun patlaması çok yaygın. Her ERROR''un nedenini bulun, hatta tek tek çözüm yazın. Bu pratik size sunucu yönetiminde uzmanlaşma kazandırır.

# Birkaç plugin aynı anda hata veriyor. Önce hangisini çözmeliyim?

Bağımlılık zincirini takip edin. Vault, ProtocolLib gibi core pluginler başta yüklenir; bunların hataları diğerlerini tetikler. Önce başkasına bağımlı olmayan pluginlerin hatalarını çözün; sonra üstlerindeki pluginler otomatik düzelebilir.

# Plugin''i tamamen silsem de veri kalır mı?

Plugin''in jar''ını silmek plugin''i devre dışı bırakır. Ancak plugins/PluginAdi/ klasöründeki config, data ve YAML dosyaları kalır. Veritabanında (MySQL) oluşturduğu tablolar da silinmez; manuel olarak DROP TABLE ile kaldırmanız gerekir. Tamamen temizlemek için jar + klasör + database tablolarını ayrı ayrı silin.

# OutOfMemoryError alıyorum, RAM''i artırmak mı gerek?

Hemen RAM artırmayın. Önce memory leak var mı araştırın. Spark ile heap dump alın: /spark heapdump. Eğer belirli bir plugin''in class''ları heap''in %40''ını kaplıyorsa o plugin''de leak var demektir. Plugin''i güncelleyin veya alternatifle değiştirin. Sadece leak yoksa RAM artırma anlamlıdır.

# Sunucu rastgele kapanıyor, neden?

Birkaç olası neden: (1) OOM killer (Linux memory''siz kalınca process öldürür), (2) JVM crash (hs_err_pid*.log oluşturur), (3) Process limit (ulimit), (4) VPS host''un kendisi sorunlu. dmesg | grep -i kill Linux memory killer''ın öldürdüklerini gösterir.

# Hata Önleme: Kurulum Öncesi Checkpoint

Çoğu hata önceden önlenebilir. Plugin paketi yüklemeden önce checkpoint''leri geç:

• Java sürümü doğru mu? (java -version)
• Sunucu yazılımı Paper mı, güncel mi?
• RAM yeterli mi? (istenen 4 GB, mevcut 4 GB)
• Disk alanı yeterli mi? (20 GB+ boş)
• Ağ portları açık mı? (25565 TCP)
• MySQL/MariaDB çalışıyor mu? (systemctl status)
• Backup son 24 saatte alındı mı?
• Test sunucusunda paket önceden denendi mi?

Bu checkpoint''leri atlayıp kurulum yapmak hataların %60''ını davet eder.

# Acil Durum Müdahale Planı

Sunucu büyüdükçe, beklenmedik sorunlar için önceden hazırlanmış bir acil plan gerekir. 3 AM''de sunucu çöktüğünde soğuk kanlı kararlar alabilmek için:

# Seviye 1: Hafif — TPS düşüklüğü, plugin hatası

• /tps ve /mem kontrol et
• Spark ile hızlı profil al (60 saniye)
• Ağır plugin''i tespit et, config değişikliği yap
• Sunucuyu 5-10 dakikada düzelt

# Seviye 2: Orta — Sunucu crash, plugin çalışmıyor

• Log''u oku, ERROR''ların listesini çıkar
• Sunucuyu güvenli modda başlat (minimum plugin)
• Sorun yaratan plugini izole et
• Yedekten plugin config''i geri yükle
• 30-60 dakikada düzelt

# Seviye 3: Ağır — Disk bozulması, OutOfMemory, dünya kaybı

• Sunucuyu durdur (daha fazla veri kaybetmeden)
• Oyunculara bildirim (Discord üzerinden)
• Yedekten tam geri yükleme
• Disk sağlığı kontrolü (smartctl)
• RAM artırma veya sunucu migration
• 2-24 saat arası downtime

# Seviye 4: Felaket — DDoS, hack, toplu veri kaybı

• Acil bildirim: Discord, oyuncular
• Sunucuyu kapat, IP''yi koru
• Forensik: kim saldırdı? Nasıl girdi?
• Son temiz yedekten kurtarma
• Güvenlik sertleştirmesi
• Gerekirse yeni sunucuya migration

# Monitoring: Proaktif Hata Tespiti

Sunucu sorun çıkardığında öğrenmek geç. Gerçek profesyoneller sorun olmadan önce bilir. Kurabileceğiniz monitoring sistemleri:

• Prometheus + Grafana: TPS, MSPT, RAM, CPU, player count metrikleri dashboard''ta
• Discord Webhook: Her ERROR''u Discord kanalına otomatik gönder
• PagerDuty / Opsgenie: Kritik alerte telefona SMS
• UptimeRobot: Sunucunuz online mı? 5 dakikada bir kontrol
• Loki + Promtail: Merkezi log yönetimi, arama
• Sentry: Exception tracking, deduplikation

# Özet

Plugin paketi kurulum sonrası karşılaşılan 15 yaygın sorun: bağımlılık eksik, Java uyumsuzluğu, YAML hata, RAM yetersiz, port çakışması, MySQL erişim, permission, dünya corruption, TPS düşük, plugin crash, GUI çalışmıyor, veri kayıp, chat double, kick, GC donma. Her biri için log''ta işaret vardır; log''u okumadan hiçbir sorun çözülmez. Teşhis sırası: Sunucuyu başlat → log''u aç → ERROR bul → stack trace oku → çözümü uygula → restart et → tekrar kontrol et. İlk hafta günlük takip yapın, log analizi için grep kullanmayı öğrenin, yardım talep ederken profesyonel format kullanın. Seviyeli acil durum planı hazırlayın, monitoring altyapınızı kurun. Bu akış ile sorunların %90''ını kendi başınıza çözebilirsiniz.

Sunucu sorunları karşısında en önemli beceri sabırdır. Her sorun çözülür; önce panik yapıp sunucuyu sıfırlamak uzun vadede daha fazla zarar verir. Log okumayı öğrenmek, Google''da hata mesajını aramak, topluluktan yardım istemek — bunlar profesyonel sunucu yönetimi becerileridir.