Minecraft Sunucuya Eklenti Yükleme: Paper, Güvenli İndirme ve Sorun Giderme
Kısa cevap
Minecraft sunucuya eklenti yüklemek için sunucunun Paper, Purpur ya da Spigot gibi eklenti destekleyen bir yazılımla çalışması gerekir. Eklentinin .jar dosyasını Hangar, Modrinth ya da SpigotMC gibi resmi kaynaklardan indirir, sunucunun plugins klasörüne koyar ve sunucuyu yeniden başlatırsın; /reload kullanmazsın. İlk açılışta eklenti kendi klasöründe ayar dosyasını oluşturur. Eklenti yüklenmezse logs/latest.log dosyasında adını arar, eksik bağımlılık, yanlış Minecraft sürümü ya da eski Java gibi sebepleri oradan bulursun.
Minecraft eklentisi ile mod arasındaki fark nedir?
Eklenti (plugin) yalnızca sunucuda çalışır ve oyuncuların hiçbir şey kurmasını gerektirmez; normal Minecraft istemcisiyle bağlanan herkes eklentili sunucuya girebilir. Eklentiler oyuna yeni blok ya da eşya eklemez, mevcut oyunu kurallar, komutlar, menüler ve korumalarla genişletir. Mod ise oyunun kodunu değiştirir, çoğu zaman yeni içerik ekler ve büyük kısmı oyuncuların da aynı modları kurmasını ister.
Bu ayrım hangi sunucu yazılımını kullanacağını da belirler. Eklentiler Bukkit API'si üzerine kurulu Paper, Purpur ve Spigot gibi yazılımlarda çalışır; Fabric ve NeoForge ise mod yükleyicidir. Birini diğerine kurmaya çalışmak işe yaramaz: bir Fabric modunu Paper'ın plugins klasörüne koyarsan sunucu onu görmez bile. Sunucuyu sıfırdan kurmayı Minecraft sunucu kurma rehberimizde anlattık; bu rehber, çalışan bir sunucuya eklenti eklemeye odaklanıyor.
| Özellik | Eklenti (plugin) | Mod |
|---|---|---|
| Nerede çalışır | Yalnızca sunucuda | Çoğunlukla sunucuda ve istemcide |
| Oyuncu bir şey kurar mı | Hayır | Çoğu modda evet |
| Sunucu yazılımı | Paper, Purpur, Spigot | Fabric, NeoForge, Forge |
| Yeni blok ve eşya | Hayır, vanilla içerikle çalışır | Evet |
| Tipik kullanım | Yetki, koruma, ekonomi, mini oyun | Yeni boyutlar, makineler, içerik paketleri |
Eklenti için Paper, Purpur mu Spigot mu seçmeliyim?
Bugün eklentili bir sunucu için en yaygın tercih Paper'dır. Paper, Spigot'un üzerine kurulmuş, performans iyileştirmeleri ve hata düzeltmeleri getiren bir yazılımdır ve Spigot için yazılmış eklentilerin büyük çoğunluğunu çalıştırır. Purpur ise Paper'ın bir çatalıdır: Paper'ın her şeyini taşır ve üstüne binilebilen yaratıklar, ayarlanabilir oyun mekanikleri gibi purpur.yml üzerinden açılıp kapanan çok sayıda ek seçenek sunar.
Spigot hâlâ çalışır ve bazı eski eklentiler için tek seçenek olabilir, ama Paper'a özgü API kullanan yeni eklentiler Spigot'ta çalışmaz. Kısa kural şu: özel bir sebebin yoksa Paper ile başla, oyun mekaniğinde ince ayar istiyorsan Purpur'a geç. Paper'dan Purpur'a geçiş genellikle yalnızca sunucu .jar dosyasını değiştirmekten ibarettir, ama yine de önce yedek al.
Minecraft eklentileri güvenli olarak nereden indirilir?
Eklentileri yalnızca tanınmış kaynaklardan indir: PaperMC ekibinin işlettiği Hangar, hem mod hem eklenti barındıran Modrinth, SpigotMC'nin kaynaklar bölümü ve eklentinin kendi resmi sitesi ya da GitHub sürüm sayfası. Bu platformlar dosyaları geliştirici hesaplarına bağlar, sürüm geçmişini ve desteklenen Minecraft sürümlerini gösterir. Yine de indirme sayısına, son güncelleme tarihine ve yorumlara bakmak iyi bir alışkanlıktır.
Ücretli eklentilerin crack'li ya da sızdırılmış kopyaları ciddi bir risk taşır. Bir eklenti sunucuda Java kodu olarak tam yetkiyle çalışır; içine yerleştirilmiş zararlı kod oyunculara operatör yetkisi verebilir, dosyaları silebilir ya da sunucuyu başka işler için kullanabilir. 2023'te ortaya çıkan fractureiser vakası, ele geçirilmiş hesaplar üzerinden yayılan zararlı dosyaların bilinen platformlarda bile görülebileceğini gösterdi. Bir eklentiye para ödemek istemiyorsan ücretsiz bir alternatif ara, kopya sürüm kullanma.
- Hangar: hangar.papermc.io, Paper ekosistemi için
- Modrinth: modrinth.com, eklenti ve modlar için
- SpigotMC Resources: Spigot ve Paper uyumlu eklentiler
- Geliştiricinin kendi sitesi ya da GitHub Releases sayfası
Eklenti plugins klasörüne nasıl yüklenir?
Kurulum basittir: eklentinin .jar dosyasını sunucunun ana klasöründeki plugins klasörüne koyar ve sunucuyu yeniden başlatırsın. Kiralık bir sunucuda bunu panelin dosya yöneticisiyle ya da SFTP ile yaparsın; TheCrewHost'un oyun panelinde .jar dosyasını doğrudan plugins klasörüne sürükleyip bırakabilirsin. Zip olarak gelen bir eklentiyi önce aç, plugins klasörüne yalnızca .jar dosyası girmelidir.
Sunucu açıldığında eklenti, plugins klasörü içinde kendi adıyla bir klasör ve genellikle bir config.yml dosyası oluşturur. Kurulumun başarılı olduğunu oyunda ya da konsolda /plugins komutuyla kontrol edersin: yeşil görünen eklentiler çalışıyor, kırmızı görünenler yüklenmiş ama devre dışı demektir. Listede hiç görünmeyen bir eklenti ise hiç yüklenememiştir.
Eklentileri tek tek ekle. On eklentiyi aynı anda atıp sunucuyu açtığında bir sorun çıkarsa hangisinin sebep olduğunu bulmak zorlaşır. Her eklentiden sonra sunucuyu başlat, logu kontrol et ve temel komutlarını dene.
Neden /reload yerine sunucuyu yeniden başlatmalısın?
/reload komutu bütün eklentileri kapatıp yeniden yükler, ama çoğu eklenti bu senaryoya göre yazılmamıştır. Sonuç bellekte kalan eski veriler, iki kez çalışan olay dinleyicileri, kopan veritabanı bağlantıları ve hiçbir hata mesajı vermeden bozulan özellikler olabilir. Paper bu yüzden komutu bir uyarıyla karşılar ve onay ister; uyarı, ciddiye alınması gereken bir uyarıdır.
Doğru yol sunucuyu tamamen yeniden başlatmaktır. Yalnızca bir eklentinin ayarını değiştirdiysen, birçok eklentinin kendi yeniden yükleme komutu vardır; örneğin EssentialsX için /essentials reload gibi. Bu komutlar yalnızca o eklentinin ayarlarını okur ve genellikle güvenlidir. PlugMan gibi araçlarla eklentiyi canlı yükleyip kaldırmak da aynı riskleri taşır, test sunucusu dışında önerilmez.
Eklenti ayar dosyaları nasıl düzenlenir?
Eklenti ayarlarının çoğu YAML formatındadır ve YAML girintiye duyarlıdır. Girintide sekme (tab) değil boşluk kullan, iki nokta üst üsteden sonra bir boşluk bırak ve özel karakter içeren metinleri tırnak içine al. Tek bir girinti hatası eklentinin ayar dosyasını okuyamamasına ve varsayılanlarla açılmasına, bazen de dosyayı sıfırlamasına yol açar.
Düzenlemeden önce dosyanın bir kopyasını al, değişiklikten sonra eklentinin kendi reload komutunu ya da sunucu yeniden başlatmasını kullan ve logda o eklentiden gelen uyarılara bak. Emin olamadığın bir dosyayı çevrimiçi bir YAML doğrulayıcıyla kontrol etmek dakikalar kazandırır. Mesaj dosyalarını Türkçeleştirirken de aynı kurallar geçerlidir; dosyayı UTF-8 olarak kaydet ki ğ, ş ve ı gibi harfler bozulmasın.
Bağımlılık eklentileri ve sürüm uyumu neden önemlidir?
Bazı eklentiler başka eklentiler olmadan çalışmaz. Ekonomi eklentileri ile dükkân ve rütbe eklentileri arasında köprü kuran Vault (ve onun güncel çatalı VaultUnlocked), yetki sistemi LuckPerms, paket düzeyinde değişiklik yapan eklentilerin kullandığı ProtocolLib ya da PacketEvents bu türün en bilinen örnekleridir. Eklenti sayfası hangi bağımlılıkları istediğini yazar; plugin.yml dosyasında depend olarak geçenler zorunlu, softdepend olanlar isteğe bağlıdır.
Sürüm uyumu ikinci büyük konudur. Her eklenti belirli Minecraft sürümleri için yazılır ve özellikle paketlerle ya da sunucu iç yapısıyla uğraşan eklentiler her büyük Minecraft güncellemesinde yeni sürüm ister. Sunucuyu yeni bir Minecraft sürümüne geçirmeden önce bütün eklentilerinin o sürümü desteklediğini kontrol et; tek bir kritik eklenti hazır değilse beklemek, yarım çalışan bir sunucudan iyidir. Yeni Minecraft sürümleri daha yeni bir Java sürümü de isteyebilir, bu yüzden sunucunun Java sürümünü de gözden geçir.
Hangi eklentiler gerçekten gerekli?
Her sunucunun ihtiyacı farklıdır ama çoğu topluluk sunucusu aynı temel ihtiyaçları paylaşır: kimin neyi yapabileceğini belirleyen bir yetki sistemi, yapıları koruyan bir araç, kötü niyetli oyunculara karşı kayıt ve geri alma imkânı ve performans sorunlarını teşhis edecek bir profil aracı. Aşağıdaki tablo her ihtiyaç için yaygın ve aktif geliştirilen seçenekleri gösterir.
Daha az eklenti genellikle daha kararlı bir sunucu demektir. Aynı işi yapan iki eklentiyi birlikte kurma, örneğin iki farklı koruma sistemi ya da iki ekonomi eklentisi çakışır. Performans tarafında spark, Paper'ın 1.21'den itibaren sunucuyla birlikte gelir; /spark tps ve /spark profiler komutlarıyla hangi eklentinin yük oluşturduğunu görebilirsin. Lag'in genel sebeplerini ayrı bir rehberde ele aldık; burada önemli olan, yeni bir eklentinin sunucuyu yavaşlatıp yavaşlatmadığını spark ile ölçmektir.
| Amaç | Yaygın eklentiler | Not |
|---|---|---|
| Yetki ve rütbeler | LuckPerms | Web editörüyle yetki yönetimi |
| Temel komutlar | EssentialsX | Ev, ışınlanma, kit, mesajlaşma |
| Bölge koruma | WorldGuard + WorldEdit | Spawn ve özel alanlar için |
| Oyuncu arazisi | GriefPrevention | Oyuncuların kendi alanını korumasını sağlar |
| Anti-grief kayıt | CoreProtect | Blok kayıtları ve geri alma |
| Ekonomi köprüsü | Vault / VaultUnlocked | Ekonomi eklentileri için bağımlılık |
| Performans profili | spark | Paper ile birlikte gelir |
| Bedrock oyuncuları | Geyser + Floodgate | Telefon ve konsol oyuncuları için |
Eklentiler nasıl güvenle güncellenir?
Güncellemeden önce plugins klasörünün ve dünya dosyalarının yedeğini al, sonra yeni sürümün değişiklik notlarını oku. Bazı güncellemeler ayar dosyasının formatını değiştirir ya da veritabanını dönüştürür; bu tür sürümlerden geri dönmek yedek olmadan zordur. Sunucuyu durdur, eski .jar dosyasını sil, yenisini koy ve sunucuyu başlat. Aynı eklentinin iki sürümünü klasörde bırakmak, hangisinin yükleneceğini belirsiz hale getirir.
Bukkit tabanlı sunucularda plugins/update klasörü de vardır: buraya aynı dosya adıyla koyduğun bir .jar, bir sonraki açılışta eskisinin yerine geçer. Çok sayıda eklentin varsa güncellemeleri toplu yapmak yerine kritik olanlardan başlayıp tek tek ilerlemek, sorun çıktığında suçluyu bulmayı kolaylaştırır.
Yüklenmeyen bir eklentinin sebebi logdan nasıl bulunur?
Sunucu her açılışta logs/latest.log dosyasına yazar. Eklenti /plugins listesinde yoksa ya da kırmızı görünüyorsa bu dosyada eklentinin adını ara ve ilk ERROR ya da WARN satırına odaklan; altındaki uzun Java hata yığınının en üstteki birkaç satırı genellikle sebebi söyler. Çoğu sorun aşağıdaki birkaç kalıptan birine uyar.
Hata mesajından bir şey çıkaramıyorsan eklentinin sayfasındaki destek kanalına, GitHub sorunlarına ya da Discord sunucusuna hatanın tamamını, sunucu yazılımını ve sürümünü ve eklenti sürümünü yazarak başvur. Log paylaşırken içinde IP adresi ya da şifre bulunmadığından emin ol.
| Logda gördüğün | Muhtemel sebep | Çözüm |
|---|---|---|
| Unknown dependency veya missing dependency | Gerekli bağımlılık eklentisi yok | Belirtilen eklentiyi kur ve yeniden başlat |
| UnsupportedClassVersionError | Sunucunun Java sürümü eski | Eklentinin istediği Java sürümüne geç |
| Invalid plugin.yml / Invalid description | Bozuk ya da yanlış dosya, belki bir mod | Doğru dosyayı resmi kaynaktan yeniden indir |
| NoSuchMethodError / NoClassDefFoundError | Eklenti farklı bir Minecraft sürümü için yazılmış | Uyumlu sürümü bul ya da eklentiyi kaldır |
| Ambiguous plugin name | Aynı eklentiden iki .jar var | Eski sürümü sil |
| Error loading config veya YAML hatası | Ayar dosyasında girinti hatası | YAML'ı düzelt ya da yedeği geri yükle |
Minecraft sunucuna eklentiyi 7 adımda kur
- 1
Sunucu yazılımını kontrol et
Sunucunun Paper, Purpur ya da Spigot ile çalıştığından ve Minecraft sürümünü bildiğinden emin ol; Fabric ya da NeoForge eklenti çalıştırmaz.
- 2
Eklentiyi resmi kaynaktan indir
Hangar, Modrinth, SpigotMC ya da geliştiricinin sitesinden sunucu sürümünü destekleyen .jar dosyasını indir.
- 3
Bağımlılıkları belirle
Eklenti sayfasında istenen Vault, LuckPerms, ProtocolLib ya da PacketEvents gibi bağımlılıkları da indir.
- 4
Yedek al
plugins klasörünün ve dünyanın bir yedeğini al ki bir şey ters giderse geri dönebilesin.
- 5
Dosyayı plugins klasörüne koy
Sunucuyu durdur, .jar dosyalarını plugins klasörüne yükle ve sunucuyu yeniden başlat; /reload kullanma.
- 6
Yüklendiğini doğrula
/plugins komutuyla eklentinin yeşil göründüğünü kontrol et ve logs/latest.log dosyasında hata olup olmadığına bak.
- 7
Ayarları düzenle
plugins klasöründe oluşan config.yml dosyasını YAML girinti kurallarına dikkat ederek düzenle ve eklentinin reload komutuyla ya da yeniden başlatmayla uygula.
Sık Sorulan Sorular
Eklenti kurmak için oyuncuların bir şey indirmesi gerekir mi?
Hayır. Eklentiler yalnızca sunucuda çalışır, oyuncular normal Minecraft istemcisiyle bağlanır. Tek istisna kaynak paketleridir: bazı eklentiler özel görseller ya da sesler için bir kaynak paketi gönderir ve oyuncudan onay ister. Bu durumda da oyuncu bir şey kurmaz, paket bağlanırken otomatik iner.
Bir sunucuya kaç eklenti kurulabilir?
Belirli bir sayı sınırı yok; önemli olan eklentilerin ne yaptığıdır. Sadece komut ekleyen yirmi eklenti, her tick çalışan tek bir kötü yazılmış eklentiden daha az yük getirebilir. Her yeni eklentiden sonra spark ile tick sürelerini ölçmek, sayıdan çok daha güvenilir bir göstergedir. Kullanmadığın eklentileri kaldırmak da açılışı hızlandırır.
Spigot eklentisi Paper'da çalışır mı?
Büyük çoğunluğu çalışır, çünkü Paper Spigot'un API'sini taşır. Paper ve Purpur için yazılmış eklentiler ise Spigot'ta çalışmayabilir, çünkü Paper'a özgü özellikler kullanırlar. Çok eski ya da sunucunun iç yapısına doğrudan erişen eklentilerde sorun çıkabilir; eklenti sayfasında Paper uyumluluğunun belirtilip belirtilmediğine bak.
Eklentiyi nasıl tamamen kaldırırım?
Sunucuyu durdur, eklentinin .jar dosyasını plugins klasöründen sil ve sunucuyu başlat. Eklentinin oluşturduğu klasör ayarları ve verileri tutar; ileride geri dönebileceksen bırak, tamamen temizlemek istiyorsan onu da sil. Başka eklentilerin ona bağımlı olup olmadığını kontrol et, yoksa onlar da yüklenmeyi bırakır.
Fabric sunucuma eklenti kurabilir miyim?
Bukkit eklentileri Fabric ya da NeoForge üzerinde doğrudan çalışmaz. Fabric tarafında aynı işleri yapan sunucu taraflı modlar vardır; LuckPerms ve spark gibi bazı projelerin Fabric sürümleri de bulunur. Hem mod hem eklenti isteyenler için iki dünyayı birleştirmeye çalışan melez yazılımlar var, ama bunlar uyumluluk sorunlarına daha açıktır.
Ücretli bir eklentinin ücretsiz indirme linkini buldum, kullanmalı mıyım?
Kullanma. Sızdırılmış ya da crack'li eklentiler zararlı kod taşımak için en sık kullanılan yollardan biridir ve bu kod sunucunda tam yetkiyle çalışır. Oyunculara gizli yetki veren arka kapılar ya da dosyaları silen kodlar bu tür kopyalarda görülmüştür. Ayrıca güncelleme ve destek de alamazsın. Ücretsiz ve açık kaynaklı bir alternatif neredeyse her zaman vardır.
Eklentiler sunucuyu yavaşlatır mı?
Yavaşlatabilir. Sık çalışan zamanlayıcılar, büyük veritabanı sorguları ya da her blok olayını işleyen eklentiler tick süresini uzatır. spark profili, yükün hangi eklentiden geldiğini net biçimde gösterir. Lag'in eklentiler dışındaki sebepleri, yani görüş mesafesi, varlık sayısı ve dünyanın önceden oluşturulması (pre-generation) gibi konular ise ayrı bir performans rehberinin konusudur.
