Minecraft sunucusuna plugin eklemek için plugin'in .jar dosyasını sunucunun kök dizinindeki plugins klasörüne atmanız ve sunucuyu yeniden başlatmanız yeterlidir. Buradaki asıl iş kurulum değil, doğru dosyayı seçmektir: sunucu yazılımınızın türü, Minecraft sürümü ve Java sürümü birbiriyle uyumlu olmak zorundadır. Bu rehberde plugin'in nereden indirileceğini, nasıl kurulup güncelleneceğini, hangi komutun sunucunuzu bozacağını ve hata aldığınızda log dosyasında neye bakacağınızı adım adım anlatıyoruz.
Bu üçünü karıştırmak, yeni sunucu sahiplerinin en sık yaptığı hatadır ve doğrudan "sunucu açılmıyor" sonucunu doğurur.
Halka açık bir sunucu işletiyorsanız neredeyse her zaman plugin istersiniz — çünkü oyuncularınızdan hiçbir kurulum talep etmez ve katılım engelini sıfırda tutar.
Plugin ekosistemi bir zincir üzerine kuruludur. Bukkit orijinal plugin API'sini tanımladı; Spigot Bukkit'i temel alıp performans iyileştirmeleri ekledi; Paper ise Spigot'u temel alarak çok daha agresif optimizasyonlar ve genişletilmiş bir API sundu.
Pratik sonuç şudur: Bukkit için yazılmış bir plugin Spigot ve Paper'da çalışır, Spigot plugin'i Paper'da çalışır, ancak yalnızca Paper API'si kullanan bir plugin Spigot'ta çalışmaz. Bu yüzden bugün çoğu sunucu sahibi doğrudan Paper kullanır: hem daha hızlıdır hem de tüm plugin yelpazesini destekler.
Vanilla sunucu yazılımı plugin desteklemez. Vanilla bir sunucunuz varsa önce Paper'a geçmeniz gerekir. Sunucuyu sıfırdan kuruyorsanız Minecraft sunucusu nasıl kurulur yazımızdaki adımları takip edebilirsiniz.
Bu, şu anda en çok hata üreten konudur çünkü gereksinim yakın zamanda değişti. Minecraft yıl tabanlı sürüm numaralandırmasına geçti ve Paper'ın resmî gereksinimleri şu şekilde:
Java 21 üzerinde 26.1 veya 26.2 çalıştırmayı denerseniz sunucu açılmaz ve konsolda UnsupportedClassVersionError hatası görürsünüz. Kurulu sürümü java -version komutuyla doğrulayabilirsiniz.
Plugin tarafında da sürüm uyumu geçerlidir: 1.21 için derlenmiş bir plugin, 26.2 üzerinde çalışmayabilir. Özellikle eşya, mob, paket veya dünya verisiyle çalışan plugin'ler sürüm atlamalarından sonra güncellenmek zorundadır. Paper'ın 26.2 sürümü Adventure 5 ile geldiği ve daha önce kullanımdan kaldırılmış API'leri sildiği için, 26.1'de sorunsuz çalışan bazı plugin'ler 26.2'de bozulabilir.
Kaynak seçimi bir güvenlik meselesidir. Paper'ın kendi dokümantasyonunun uyarısı açıktır: plugin'lere yalnızca sunucunuza değil, sunucunun çalıştığı makineye de tam ve kısıtlamasız erişim verilir. Yani güvenmediğiniz bir kaynaktan indirdiğiniz bir .jar, sunucunuzun tamamını devralabilir.
Güvenilir kaynaklar:
Kaçınmanız gerekenler: ücretli bir plugin'i bedava dağıttığını iddia eden siteler, dosya kısaltma/reklam yönlendirmeli indirme linkleri ve .jar yerine .exe veya kurulum sihirbazı sunan sayfalar. Bazı plugin'ler .zip olarak dağıtılır; bu durumda arşivi açıp içindeki .jar dosyasını kullanmanız gerekir.
Kurulum beş adımdan oluşur:
Plugin sayfasında sunucunuzun Minecraft sürümünü destekleyen dosyayı seçin. "Son sürüm" her zaman sizin sürümünüz için doğru sürüm değildir.
Konsoldan stop komutunu çalıştırın. Çalışan bir sunucuda dosya değiştirmek bozulmaya yol açar.
.jar dosyasını sunucu kök dizinindeki plugins klasörüne kopyalayın. Önemli bir ayrıntı: alt klasörler taranmaz. Dosyayı plugins/EssentialsX/ gibi bir alt klasöre koyarsanız plugin yüklenmez.
Sunucu ilk açılışta plugin'in yapılandırma klasörünü otomatik oluşturur.
Konsolda veya oyun içinde /plugins komutunu çalıştırın. Plugin adı yeşil görünüyorsa yüklenmiştir; kırmızıysa bir hata vardır ve logs/latest.log dosyasına bakmanız gerekir.
Plugin güncellemek için eski .jar'ı silip yenisini atmak yerine Paper'ın update klasörü özelliğini kullanın: yeni sürümü plugins/update/ klasörüne koyun ve sunucuyu yeniden başlatın. Paper eski dosyayı otomatik olarak yenisiyle değiştirir. Bu yöntem, aynı plugin'in iki farklı sürümünün aynı anda yüklü kalması sorununu ortadan kaldırır.
/reload komutunu kullanmayın. Bu komut plugin'leri düzgün biçimde kapatmadan yeniden yükler; açık kalan veritabanı bağlantıları, zamanlanmış görevler ve bellek sızıntıları üretir. Sonuç genellikle anında değil, saatler sonra açıklanamayan TPS düşüşü ve çökme olarak ortaya çıkar. Doğrusu her zaman sunucuyu tamamen yeniden başlatmaktır.
Sürüm yükseltmelerinde ise sıralama şudur: önce yedek al, sonra plugin'leri güncelle, en son sunucu yazılımını güncelle. Paper'ın kendi dokümantasyonu yedeklemeyi "en önemli ve en sık atlanan adım" olarak tanımlar. Ayrıca bir dünyayı yeni sürüme yükselttikten sonra geri düşürmek mümkün değildir — bu yüzden yükseltme öncesi dünya klasörünün kopyası şart.
Plugin ilk kez çalıştığında plugins/PluginAdi/ klasörünü ve içinde bir config.yml dosyası oluşturur. Bu dosya YAML formatındadır ve iki kuralı vardır: girintiler boşlukla yapılır, sekme (tab) karakteri kullanılmaz ve iki nokta üst üsteden sonra bir boşluk bırakılır. Bu iki kuraldan birini bozmak plugin'in yüklenmemesine yol açar.
Yapılandırmayı değiştirdikten sonra çoğu plugin kendi yeniden yükleme komutunu sunar (örneğin /pluginadi reload). Bu komut sunucu genelindeki /reload ile aynı şey değildir ve güvenlidir.
İzinler konusunda ise erken bir karar vermeniz gerekir: plugin'lerin çoğu izin düğümleri (permission node) üzerinden çalışır ve bunları yönetmek için bir izin plugin'i gerekir. LuckPerms bugün fiilî standarttır; grup tanımlayıp oyuncuları bu gruplara atayarak tüm plugin izinlerini tek yerden yönetirsiniz. İzin sistemi kurmadan plugin biriktirmek, ilerleyen aşamada çözülmesi zor bir karmaşa yaratır.
Her sorun giderme logs/latest.log dosyasıyla başlar. Konsolda kaybolan hata mesajı bu dosyada durur.
Türkiye (Türkçe)
Worldwide (English)
UnsupportedClassVersionError hatası doğrudan Java sürümünü işaret eder. 26.1 ve sonrası için Java 25 gerekir.plugins klasörünün doğrudan içinde mi? Alt klasörler taranmaz.Plugin biriktirmek performansın en büyük düşmanıdır. Sağlam bir başlangıç için şu kategoriler yeterlidir:
Her yeni plugin'i tek tek ekleyin ve her eklemeden sonra sunucuyu bir süre izleyin. Beş plugin'i aynı anda kurup sorun yaşarsanız hangisinin sebep olduğunu bulmak saatlerinizi alır.
Plugin'ler RAM ve CPU tüketir; özellikle arazi koruma ve kayıt plugin'leri veritabanı işlemleriyle birlikte belirgin yük üretir. Minecraft sunucusu tek çekirdek performansına duyarlı olduğu için işlemcinin frekansı, çekirdek sayısından daha belirleyicidir.
Nubitro Minecraft sunucuları Türkiye / İstanbul lokasyonunda, NVMe M.2 SSD disk ve 1 Gbps sınırsız trafik ile sunulur. Paketler 2 çekirdek / 4 GB RAM / 50 GB NVMe seviyesindeki Starter'dan başlar; Silver 4 CPU / 8 GB, Gold 6 CPU / 16 GB ve Premium 6 CPU / 32 GB RAM ile 100 GB NVMe yapılandırmasına kadar çıkar.
Türkiye lokasyonu, yurt içi oyuncu kitlesi için doğrudan ping avantajı demektir — plugin optimizasyonuyla kazanamayacağınız bir farktır. Güncel paketleri Minecraft sunucu kiralama sayfasından inceleyebilirsiniz. Hazır paket yerine tam kontrol istiyorsanız VDS ile VPS arasındaki fark yazımız hangi altyapının size uygun olduğunu netleştirir.
Hayır. Plugin'ler yalnızca sunucuda çalışır; oyuncular standart Minecraft istemcisiyle bağlanır. İstemci tarafında kurulum gerektiren şey mod'dur, plugin değil.
Sunucuyu durdurun, plugins klasöründeki .jar dosyasını silin ve yeniden başlatın. Plugin'in yapılandırma klasörü yerinde kalır; tamamen temizlemek isterseniz onu da silin. Ancak plugin veri saklıyorsa (arazi koruma, ekonomi) klasörü silmek verileri kalıcı olarak yok eder.
Sayı değil, yük önemlidir. Hafif 30 plugin, kötü yazılmış 5 plugin'den daha az sorun çıkarabilir. Doğru yaklaşım, bir performans izleme aracıyla hangi plugin'in tick süresini yediğini ölçmektir.
Evet. Paper, Spigot API'siyle uyumludur ve Spigot plugin'lerini çalıştırır. Tersi geçerli değildir: yalnızca Paper API'si kullanan bir plugin Spigot'ta çalışmaz.
Bazıları bozulabilir. Eşya, mob, paket veya dünya verisiyle çalışan plugin'ler sürüm atlamalarından sonra güncellenmek zorundadır. Yükseltmeden önce her plugin'in yeni sürümü desteklediğini kontrol edin ve mutlaka yedek alın.
Test ortamı dışında hayır. Plugin'leri düzgün kapatmadığı için bellek sızıntısı ve zamanlanmış görev çakışması üretir; belirtiler genellikle saatler sonra ortaya çıkar. Canlı sunucuda her zaman tam yeniden başlatma yapın.
.jar dosyası doğrudan plugins klasörüne konur; alt klasörler taranmaz./plugins komutuyla doğrulayın — yeşil isim başarılı demektir.plugins/update/ klasörünü kullanın./reload kullanmayın; her zaman tam yeniden başlatma yapın.logs/latest.log ile başlar.