Rehber

Minecraft plugin hataları nasıl düzeltilir

18 Ekim 2026 güncellendi

Bir plugin yüklenmediğinde sunucu neredeyse her zaman nedenini söyler: neden, açılış sırasında konsolda, plugin'in adının birkaç satır üstünde veya altında yazar. Günlüğün o kısmını okumayı öğrenirsen çoğu hatayı bir dakikada düzeltirsin. İşte yaygın olanlar ve anlamları.

Sunucu sürümünü ve plugin'in ne yapması gerektiğini söyle.

Bunu Codexe ile oluştur

Adım adım

1.Açılışın günlüğünü aç
Konsolu ya da sunucu klasöründeki logs/latest.log dosyasını oku. Bir barındırma panelinde onun konsolunu veya dosya yöneticisini kullan.
2.Plugin'in adını ara
Ondan bahseden ilk hatayı bul. Önemli olanlar [ERROR] veya [WARN] ile başlayan ve altında bir stack trace bulunan satırlardır.
3.İlk satırı ve "Caused by" satırlarını oku
İlk satır neyin başarısız olduğunu söyler; son Caused by: satırı genellikle nedenini söyler. Plugin'in kendi paket adını içeren satırlar kodunun neresinde olduğunu gösterir.
4.Aşağıdaki listeyle eşleştir
Açılış hatalarının çoğu bir sürüm, Java veya bağımlılık sorunudur ve mesaj hangisi olduğunu söyler.
5.Bir şeyi düzelt ve yeniden başlat
Tek bir şeyi değiştir, yeniden başlat (/reload değil) ve günlüğü tekrar oku. Bir plugin'in hataları diğerlerinde de hatalara yol açabilir.

Yaygın hatalar

Gördüğün	Anlamı	Çözüm
`Unsupported API version 1.21`	Plugin'in `api-version` değeri sunucundan daha yeni.	Sunucun için olan sürümü edin ya da sunucuyu güncelle.
`Invalid plugin.yml` veya `Jar does not contain plugin.yml` ile birlikte `Could not load 'plugins/X.jar'`	Plugin'in tanımlayıcısı eksik ya da bir YAML hatası içeriyor veya dosya bir plugin değil.	Kaynağını, bir mod'u veya bir zip'i değil, plugin'in kendisini indirdiğini kontrol et. Kendin derlediysen `plugin.yml` dosyasını düzelt.
`UnsupportedClassVersionError`, "class file version 65.0"	Plugin, sunucunun çalıştırdığından daha yeni bir Java gerektiriyor (61 = Java 17, 65 = Java 21, 69 = Java 25).	Sunucuyu o Java ile çalıştır ya da plugin'i kendi Java'n için yeniden derle.
`NoClassDefFoundError` veya `ClassNotFoundException`	Plugin'in ihtiyaç duyduğu bir sınıf orada değil: bir bağımlılık plugin'i eksik, bir kütüphane .jar'ın içine gömülmemiş ya da API bu sürümde yok.	Hatada adı geçen plugin'i (Vault, ProtocolLib) kur ya da kendi sürümün için yapılmış bir derlemeyi kullan.
`Unknown/missing dependency plugins`	`depend` içinde listelenen bir plugin kurulu değil.	Onu `plugins/` içine kur.
`Error occurred while enabling X (Is it up to date?)`	Plugin yüklendi ama `onEnable` içinde çöktü.	`Caused by` satırını oku: çoğu zaman bir yapılandırma hatası veya eksik bir bağımlılıktır.
`Ambiguous plugin name`	`plugins/` içinde aynı plugin'in iki .jar dosyası var.	Eskisini sil.

Yüklemeyle ilgili olmayan hatalar

Plugin yeşil ama bir komut "Unknown command" diyor: komut plugin.yml içinde yok ya da başka bir plugin aynı adı kullanıyor.
"I'm sorry, but you do not have permission": oyuncunun izin düğümü yok. Düğümü plugin sayfasında bul ve izin plugin'inle ver.
config.yml düzenledikten sonra hatalar: YAML sekme değil boşluk ister, başında : veya & bulunan metinlerin etrafında da tırnak ister.
Yeniden başlatınca çalışıyor, /reload sonrası bozuluyor: plugin /reload desteklemiyor. Bunun yerine yeniden başlat.

Sunucunun hangi Java'ya ihtiyacı var

Minecraft 1.20.5 ve sonrası Java 21, 26.x Java 25 ister; 1.18 ile 1.20.4 arası Java 17 ister. java -version komutunu sunucunun kullandığı Java ile çalıştır (barındırma panelinde genellikle Docker image veya Java version adlı bir ayardır). Eski bir Java için derlenmiş bir plugin yenisinde çalışır, tersi geçerli değildir.

Codexe ile yapılan plugin'leri düzeltme

Codexe'te yapılan plugin'ler seçtiğin sürüm için derlenir ve Hazır olmadan önce geçerli bir plugin.yml içerip içermediği kontrol edilir. Bir test sunucusunda Günlükler sekmesi günlüğü hatalar vurgulanmış olarak canlı gösterir, Günlükleri dışa aktar da onu dosya olarak kaydeder. Gördüğünü proje sohbetinde anlat ("plugin /plugins listesinde kırmızı ve günlükte ... yazıyor"), Codexe kodu değiştirip yeniden derlesin. Dosyalar tam olarak Codexe'in teslim ettiği hâldeyken bir Derle işlemi başarısız olursa Yapay zekayla düzelt onları ücretsiz onarır.

Sorular

Sunucu günlüğü nerede?

Geçerli çalışma için sunucu klasöründeki logs/latest.log. Önceki çalışmalar aynı klasörde .log.gz dosyaları olarak durur.

Bir plugin başka birini bozabilir mi?

Evet: eksik veya bozuk bir bağımlılık ona ihtiyaç duyan her plugin'i durdurur. Diğerlerinden önce günlükteki ilk hatayı düzelt.

Günlüğümü paylaşmak güvenli mi?

Çoğunlukla evet, ama önce kontrol et: günlükler IP adresleri ve bazı plugin'lerde hatalardan gelen veritabanı şifreleri içerebilir.

Bozuk bir plugin'i sunucun için yeniden derle

Bu prompt göndermeye hazır açılır:

“Artık yüklenmeyen eski plugin'imin yerini alacak, SimpleWarps adlı bir Paper 1.21.4 plugin'i: adla /setwarp, /warp ve /delwarp, /warps onları bir GUI'de listeler, ayarlama ve silme için warps.admin izni, warp'lar yeniden başlatmalarda korunur, mesajlar config.yml içinde.”