Minecraft Sunucusuna Eklenti Nasıl Yüklenir (Paper ve Spigot)

Eklenti ile mod arasındaki fark nedir?

Herhangi bir şey indirmeden önce, gerçekten istediğiniz şeyin bir eklenti olduğundan emin olun. İnsanlar eklenti ve mod kelimelerini birbirinin yerine kullanır, ancak bir sunucuda bunlar tamamen farklı iki şeydir.

Eklentiler, Paper ve Spigot'un sunduğu Bukkit API'ye bağlanır. Tamamen sunucuda yaşarlar, bu yüzden oyuncularınız standart bir Minecraft istemcisiyle bağlanır ve asla bir dosya indirmez — eklenti sunucularının bu kadar kolay çalıştırılıp büyütülebilmesinin nedeni tam olarak budur.

Modlar ise farklı bir dünyadır: oyun istemcisinin kendisini değiştirirler, bu yüzden sunucu ve her tek oyuncu aynı loader'ı ve aynı mod listesini çalıştırmak zorundadır, genellikle bir modpack olarak birlikte dağıtılır. Aradığınız buysa, bu yanlış rehber — bunun yerine modlu bir Minecraft sunucusu nasıl kurulur sayfasına bakın. Loader'ların tam karşılaştırması ve her birinin nereye uyduğu için en iyi Minecraft sunucu yazılımı rehberine bakın.

Başlamadan önce: Paper veya Spigot çalıştırın

Eklentiler yalnızca Bukkit API'yi destekleyen bir sunucuda yüklenir. Mojang'ın vanilla server.jar dosyası bunu desteklemez — yanına bir eklenti koyun, hiçbir şey olmaz. Şunlardan birine ihtiyacınız var:

• Paper — standart seçim. Ailenin en hızlısıdır, aktif olarak geliştirilir ve devasa Bukkit/Spigot eklenti ekosistemiyle uyumludur. Buradan başlayın.
• Spigot — çoğu eklentinin hâlâ hedeflediği ve test edildiği daha eski temel. Paper bunun genişletilmiş bir üst kümesidir, bu yüzden "Spigot için" etiketli bir eklenti Paper'da da çalışır.
• Purpur — Paper'ın ekstra oynanış anahtarlarına sahip bir çatalı. Aynı eklentiler, birkaç ekstra ayar.

Hâlâ vanilla kullanıyorsanız, geçiş hızlıdır. Bir HytHost Minecraft planında GameCP paneli yerleşik bir sürüm değiştiriciye sahiptir: Paper'ı (veya Spigot/Purpur'u) ve Minecraft sürümünü seçin, bir kez tıklayın ve doğru sürüm kendini kurar — dünyanız hiç dokunulmamış kalır. Kendi sunucunuzu mu barındırıyorsunuz? Paper jar'ını indirin ve vanilla olanın yerine başlatın. Vanilla, Paper, Forge ve Fabric arasında seçim yapmak için yardıma ihtiyacınız varsa en iyi Minecraft sunucu yazılımı rehberini okuyun; henüz bir sunucu kurmadıysanız Minecraft sunucusu nasıl kurulur ile başlayın.

Bir eklenti adım adım nasıl kurulur

Paper veya Spigot çalışırken bir eklenti kurmak birkaç kısa adımdan oluşur. İşin tamamı birkaç dakika sürer.

1. Eklenti JAR dosyasını güvenilir bir kaynaktan indirin. Eklentiler için saygın kaynaklar SpigotMC, Modrinth ve Hangar (PaperMC)'dır. .jar dosyasını indirin ve sayfanın Minecraft sürümünüz için destek listelediğini doğrulayın — 1.20 için oluşturulmuş bir eklenti genellikle 1.21'de yüklenmeyi reddeder.
2. Onu plugins klasörüne yükleyin. Panelin Files sekmesini açın, plugins dizinine gidin ve JAR'ı yükleyin — sürükle bırak çalışır. Birden fazlasını aynı anda mı kuruyorsunuz? Panelinizdeki kimlik bilgileriyle SFTP üzerinden bağlanın ve doğrudan plugins içine kopyalayın. Kendiniz mi barındırıyorsunuz? plugins klasörü server.jar'ınızın yanında bulunur.
3. Sunucuyu yeniden başlatın. Eklentiler yalnızca başlangıçta yüklenir, bu yüzden panelde Restart'a basın — basit bir reload yeni bir eklentiyi algılamaz. Konsolu başlarken izleyin: her eklenti etkinleştikçe kendini duyurur.
4. Yüklendiğini doğrulayın. Konsol komut kutusuna /plugins (veya kısa biçimi /pl) yazın. Yeni eklentiniz listede yeşil renkte görünmelidir. Yeşil, yüklendi ve çalışıyor anlamına gelir; kırmızı ise başarısız olduğu anlamına gelir — bunu görürseniz sorun giderme bölümüne geçin.
5. Yapılandırın. İlk başarılı başlatma plugins/<PluginName>/config.yml dosyasını oluşturur. Eklentiyi ayarlamak için bu dosyayı dosya yöneticisinde düzenleyin, ardından reload komutunu çalıştırın veya yeniden başlatın. YAML boşluklar konusunda titizdir — girinti için her zaman boşluk kullanın, asla sekme (tab) kullanmayın, aksi takdirde dosya ayrıştırılamaz.

İlk olarak kurulmaya değer temel eklentiler

Eklentilere göz atarak bir hafta sonu geçirebilirsiniz, ancak iyi yönetilen hemen hemen her survival veya SMP sunucusu aynı kısa listenin üzerine kuruludur. Önce şunları kurun:

• EssentialsX — İsviçre çakısı: /home, /spawn, /tpa, kitler, warp'lar, başlangıç ekonomisi ve düzinelerce günlük komut. Sadece bir eklenti kuracaksanız, bunu kurun.
• LuckPerms — izin yöneticisi. Kimin hangi komutları çalıştırabileceğine karar verir ve size rütbeler ve gruplar verir. Diğer birçok eklenti buna bağlanır, bu yüzden birden fazla yöneticiniz olduğu anda fiilen zorunludur.
• WorldEdit + WorldGuard — WorldEdit, araziyi hızlıca inşa etmenizi ve düzenlemenizi sağlar; WorldGuard bölgeleri (spawn, mağazalar, arenalar) griefingden korur ve PvP bölgelerini kontrol eder. Çift olarak gelirler.
• Vault — ekonomi, izin ve sohbet eklentilerinin birbiriyle konuşmasını sağlayan sessiz bir köprü eklenti. Birçok eklenti onu bağımlılık olarak listeler; kurun ve unutun.
• CoreProtect — blok kaydı ve geri alma. Bir griefer spawn'ınıza saldırdığında, CoreProtect tam olarak kimin ne yaptığını gösterir ve saniyeler içinde geri alır. İhtiyacınız olmadan önce kurun.

İzinler hakkında bir not: kutudan çıktığı haliyle, çoğu komut eklentisi yalnızca sunucu operatörlerine yanıt verir. Normal bir rütbenin /home gibi bir şeyi kullanmasına izin vermek için, LuckPerms'te ilgili izin düğümünü (burada essentials.home) gruplarına verirsiniz. Bu neredeyse herkesi bir kez yakalar — bir komut sıradan bir oyuncu için "hiçbir şey yapmıyorsa", bu neredeyse her zaman eksik bir izindir, bozuk bir eklenti değil.

Eklediğiniz her eklenti biraz bellek kullanır, bu yüzden yoğun bir eklenti sunucusu çıplak vanilladan daha fazla boşluğa ihtiyaç duyar — yukarıdaki temelleri çalıştıran bir Paper sunucusu için 4-6 GB planlayın. Ne kadar vermeniz gerektiğinden emin değilseniz, bir Minecraft sunucusunun ne kadar RAM'e ihtiyacı olduğu rehberimiz bunu oyuncu sayısına ve kuruluma göre ayrıştırır.

Eklentileri güncelleme ve kaldırma

Eklentiler yalnızca tek bir klasördeki dosyalardır, bu da bakımı basit hale getirir.

Bir eklentiyi güncelleme

Yeni sürümü indirin, eski JAR'ı plugins klasöründen silin (ayarlarınızın kalması için eklentinin yapılandırma klasörüne dokunmayın), yeni JAR'ı yükleyin ve yeniden başlatın. Eklentileri güncel tutmak önemlidir: bir Minecraft sürüm güncellemesinden hemen sonra bir sunucu bozulduğunda genellikle suçlu güncel olmayan bir eklentidir, bu yüzden Minecraft sürümünüzü her değiştirdiğinizde eklentilerinizi de güncelleyin.

Bir eklentiyi kaldırma

Sunucuyu yeniden başlatın veya durdurun, eklentinin JAR'ını plugins'ten silin ve bir sonraki başlatmada ortadan kalkar. plugins/<PluginName> altındaki yapılandırma klasörü, onu da silmediğiniz sürece geride kalır — bırakmak zararsızdır, ama eklentiyle işiniz tamamen bittiyse temizlemek daha düzenlidir.

Eklenti yüklenmiyor mu? Nasıl düzeltilir

Bir eklenti /plugins'te kırmızı göründüğünde veya hiçbir şey yapmadığında, neden neredeyse her zaman birkaç şeyden biridir. Bunları sırayla inceleyin:

1. Sürüm uyumsuzluğu. Bir numaralı neden. Eklenti sayfasını sunucunuzun Minecraft sürümüyle karşılaştırın — 1.20 için oluşturulmuş bir JAR genellikle 1.21'de etkinleşmez, tersi de aynı derecede doğrudur. Eşleşen sürümü indirin veya eklentiyle eşleşecek şekilde sunucu sürümünüzü değiştirin.
2. Eksik bir bağımlılık. Birçok eklenti yanlarında kurulmuş bir yardımcıya ihtiyaç duyar — ekonomi eklentileri için Vault, bir mağaza için bir ekonomi eklentisi, belirli bir kütüphane. Konsol bunu sizin için adlandırır: Unknown/missing dependency plugins: [Vault] gibi bir satır arayın. İstediğini kurun ve yeniden başlatın.
3. Yanlış sunucu türü. Hiçbir şey yüklenmiyorsa, vanilla değil gerçekten Paper veya Spigot üzerinde olduğunuzu doğrulayın — eklentiler Bukkit API'ye ihtiyaç duyar. Sürüm değiştirici ne çalıştırdığınızı gösterir.
4. Bozuk bir yapılandırma. config.yml'deki tek bir yanlış girintili satır bir eklentiyi tamamen durdurabilir. Konsol hatası genellikle satırı ve sütunu gösterir. YAML'ı düzeltin (boşluklar, asla sekme değil) veya yapılandırma dosyasını silin ve eklentinin bir sonraki yeniden başlatmada temiz bir tane yeniden oluşturmasına izin verin.

Konsol burada en iyi arkadaşınızdır. Ne başarısız olursa olsun, sunucu başlangıçta nedeni yazdırır — eklentiyi ve sorunu adlandıran kırmızı bir ERROR veya WARN satırı. Yukarıdan aşağıya okuyun; ilk hata genellikle gerçek olandır.