Bilgi Bankası

Minecraft sunucunuzu yeni aldıysanız ve sunucuya plugin yüklemek istiyorsanız işlem aslında oldukça basittir.

En basit haliyle:

Sunucuyu kapat
↓
plugins klasörünü aç
↓
Plugin .jar dosyasını yükle
↓
Sunucuyu tekrar başlat

Hepsi bu kadar.

Ancak pluginin çalışabilmesi için kullandığınız Minecraft sunucu yazılımının da plugin desteklemesi gerekir.

Bu rehberde Paper, Spigot ve Purpur sunucularına plugin kurmayı, plugin çalışmıyorsa neyi kontrol etmeniz gerektiğini ve yeni başlayanların yaptığı en sık hataları çok basit şekilde anlatacağız.

30 saniyelik çözüm: Minecraft plugin nasıl kurulur?

Sunucunuzu kapatın.

Sunucu dosyalarında:

plugins

isimli klasörü açın.

İndirdiğiniz plugin dosyasını bu klasörün içine yükleyin.

Plugin dosyası genellikle:

PluginAdi.jar

şeklinde olur.

Örneğin:

EssentialsX.jar

Dosyayı:

plugins/EssentialsX.jar

şeklinde yükleyin.

Sonra sunucuyu yeniden başlatın.

Bitti.

1. Minecraft plugin nedir?

Plugin, Minecraft sunucusuna yeni özellikler ekleyen küçük yazılımlardır.

Örneğin plugin kullanarak:

• /home komutu ekleyebilirsiniz,
• /spawn komutu ekleyebilirsiniz,
• ekonomi sistemi kurabilirsiniz,
• yetki sistemi kurabilirsiniz,
• oyunculara rank verebilirsiniz,
• claim sistemi ekleyebilirsiniz,
• anti-cheat kullanabilirsiniz,
• mini oyun sistemleri kurabilirsiniz.

Yani pluginleri Minecraft sunucusuna özellik ekleyen eklentiler olarak düşünebilirsiniz.

2. Her Minecraft sunucusuna plugin kurulabilir mi?

Hayır.

Bu en önemli noktadır.

Normal Vanilla Minecraft sunucusu Bukkit tipi pluginleri doğrudan çalıştırmaz.

Plugin kullanmak için genellikle:

Paper
Spigot
Purpur

gibi plugin destekleyen bir server yazılımı kullanmanız gerekir.

Yeni başlayan kullanıcı için en basit seçeneklerden biri genellikle Paper kullanmaktır.

3. Paper nedir?

Paper, Minecraft Java sunucuları için kullanılan ve plugin desteği bulunan bir server yazılımıdır.

Paper kullanıyorsanız sunucu klasörünüzde genellikle:

plugins

isimli klasör bulunur.

Plugin dosyalarınızı buraya yükleyebilirsiniz.

4. Spigot nedir?

Spigot da Minecraft sunucularında plugin çalıştırmak için kullanılan server yazılımlarından biridir.

Spigot sunucularda da pluginler:

plugins

klasörüne yüklenir.

5. Purpur nedir?

Purpur da Paper tabanlı, plugin desteği bulunan bir Minecraft server yazılımıdır.

Purpur kullanıyorsanız da temel plugin kurulumu değişmez.

plugins/PluginAdi.jar

şeklinde yükleme yapılır.

6. Paper, Spigot ve Purpur arasında plugin kurma farkı var mı?

Yeni başlayan kullanıcı açısından temel işlem aynıdır.

Sunucuyu kapat
↓
plugins klasörüne gir
↓
.jar dosyasını yükle
↓
Sunucuyu aç

Bu kadar.

7. Plugin dosyası nasıl görünür?

Minecraft pluginleri genellikle:

.jar

uzantılıdır.

Örneğin:

EssentialsX-2.21.0.jar
LuckPerms-Bukkit.jar
WorldEdit-Bukkit.jar

gibi dosyalar görebilirsiniz.

Plugin olarak yüklemeniz gereken dosya genellikle bu .jar dosyasıdır.

8. ZIP dosyasını plugins klasörüne atacak mıyım?

Genellikle hayır.

Örneğin indirdiğiniz dosya:

PluginPaketi.zip

şeklindeyse önce ZIP dosyasını açmanız gerekebilir.

İçerisinden:

PluginAdi.jar

dosyasını bulun.

Sunucunun plugins klasörüne esas olarak bu JAR dosyasını yükleyin.

9. plugins klasörü nerede?

Minecraft sunucunuzun ana klasöründe bulunur.

Örneğin:

server.jar
server.properties
eula.txt
world
logs
plugins

gibi dosya ve klasörler görebilirsiniz.

Buradaki:

plugins

klasörünü açın.

10. plugins klasörü yoksa ne yapacağım?

Sunucunuzu daha önce hiç başlatmadıysanız klasör henüz oluşmamış olabilir.

Önce Paper, Spigot veya Purpur sunucunuzu bir kez başlatın.

Sunucu başarılı şekilde açıldıktan sonra:

plugins

klasörü otomatik olarak oluşabilir.

Sunucu yazılımınız Vanilla ise plugins klasörünün oluşmaması normaldir.

11. Vanilla sunucuya plugin kurabilir miyim?

Normal Vanilla Minecraft serverına Bukkit, Spigot veya Paper pluginlerini doğrudan kuramazsınız.

Örneğin:

Vanilla Server
+
EssentialsX.jar

şeklinde sadece dosyayı klasöre atmak pluginin çalışmasını sağlamaz.

Plugin kullanmak istiyorsanız sunucu yazılımınızı Paper, Spigot veya Purpur gibi plugin destekleyen bir yapı ile çalıştırmanız gerekir.

12. Plugin yüklemeden önce sunucuyu kapatmalı mıyım?

Evet, en güvenli yöntem budur.

Önce konsola:

stop

yazarak Minecraft sunucusunu düzgün şekilde kapatın.

Daha sonra plugin dosyasını yükleyin.

Sonra sunucuyu yeniden başlatın.

Bu yöntem yeni başlayan kullanıcılar için en temiz yöntemdir.

13. Sunucuyu direkt kapatırsam ne olur?

Mümkünse Minecraft konsolunda:

stop

komutunu kullanın.

Bu komut Minecraft'ın dünyayı düzgün şekilde kaydedip kapanmasını sağlar.

Sunucuyu sürekli zorla kapatmak önerilmez.

14. Plugin kurduktan sonra ne yapacağım?

Sunucuyu tekrar başlatın.

Sunucu açılırken konsolu takip edin.

Plugin başarılı şekilde yüklenirse plugin kendisine ait klasörü oluşturabilir.

Örneğin:

plugins/
    Essentials/
    EssentialsX.jar

gibi bir yapı görebilirsiniz.

Pluginin klasörü genellikle ilk çalıştırmadan sonra oluşur.

15. Plugin çalışıyor mu nasıl kontrol ederim?

Sunucuda yeterli yetkiniz varsa oyun içerisinde:

/plugins

komutunu kullanabilirsiniz.

Panel konsolunda ise:

plugins

yazabilirsiniz.

Sunucu yüklü pluginleri listeleyebilir.

Ancak bazı sunucularda bu komut güvenlik veya ayarlar nedeniyle değiştirilebilir veya kapatılabilir.

16. Plugin listede görünüyor ama çalışmıyor

Plugin adının listede görünmesi tek başına bütün özelliklerinin sorunsuz çalıştığı anlamına gelmeyebilir.

Öncelikle sunucu konsolunu kontrol edin.

Şu kelimelere dikkat edin:

ERROR
Exception
Failed
Could not load
Could not enable
Unsupported
Dependency

Bu tür mesajlar pluginin neden çalışmadığı hakkında bilgi verebilir.

17. Plugin kırmızı görünüyorsa ne anlama gelir?

Bazı Bukkit tabanlı sunucu yazılımlarında /plugins çıktısında düzgün çalışan pluginler yeşil, yüklenemeyen veya devre dışı kalan pluginler kırmızı görünebilir.

Ancak yalnızca renge güvenmeyin.

Asıl hata sebebini sunucu konsolu ve:

logs/latest.log

dosyasından kontrol edin.

18. Pluginin Minecraft sürümü uyumlu olmalı mı?

Evet.

Örneğin sunucunuz:

Minecraft 1.21.x

ise pluginin de kullandığınız Minecraft sürümüyle uyumlu olması gerekir.

Çok eski bir plugin yeni Minecraft sürümünde çalışmayabilir.

Örneğin:

Sunucu: Minecraft 1.21.x
Plugin: sadece Minecraft 1.12 için

ise plugin büyük ihtimalle problem çıkarabilir.

19. Plugin indirirken hangi sürümü seçeceğim?

Pluginin indirme sayfasında desteklediği Minecraft sürümlerini kontrol edin.

Örneğin sunucunuz:

1.21.8

ise plugin sayfasında:

1.21
1.21.x
1.21.8

gibi uyumluluk bilgileri bulunabilir.

Kullandığınız sürüme uygun dosyayı indirin.

20. Bukkit, Spigot veya Paper yazıyorsa hangisini indireceğim?

Çoğu klasik Minecraft plugininde indirme sayfasında:

Bukkit
Spigot
Paper

ifadelerinden biri veya birkaçı bulunabilir.

Paper, Bukkit/Spigot ekosistemindeki birçok pluginle uyumludur.

Ancak her pluginin kendi indirme sayfasındaki uyumluluk bilgisi kontrol edilmelidir.

21. Forge sunucuya normal plugin kurulabilir mi?

Normal Forge sunucusu Bukkit/Spigot/Paper pluginlerini doğrudan çalıştırmaz.

Forge esas olarak:

mod

çalıştırmak için kullanılır.

Yani:

Forge
→ mods klasörü

Paper
→ plugins klasörü

şeklinde düşünmek yeni başlayan kullanıcı için en basit ayrımdır.

22. NeoForge sunucuya plugin kurabilir miyim?

Normal NeoForge sunucu da Bukkit pluginlerini doğrudan çalıştırmak için tasarlanmamıştır.

NeoForge sunucuda genellikle:

mods

klasörüne NeoForge uyumlu modlar yüklenir.

Bir dosyanın "Minecraft eklentisi" olması onun Paper plugin olduğu anlamına gelmez.

23. Fabric sunucuya Paper plugin kurulabilir mi?

Normal Fabric sunucuda da Paper/Spigot pluginleri doğrudan çalışmaz.

Fabric için genellikle Fabric uyumlu modlar kullanılır.

Yani basit şekilde:

Paper / Spigot / Purpur
→ Plugin

Forge / NeoForge / Fabric
→ Mod

şeklinde düşünebilirsiniz.

24. Hem mod hem plugin kullanmak istiyorum

İnternette hem mod hem Bukkit plugin çalıştırmayı amaçlayan bazı hibrit server yazılımları görebilirsiniz.

Ancak bunlar standart Paper veya standart Forge davranışından farklıdır ve plugin/mod uyumluluğu konusunda ek problemler oluşturabilir.

Minecraft sunucu yönetimine yeni başladıysanız önce ihtiyacınızı belirlemek daha sağlıklıdır:

Plugin ağırlıklı sunucu
→ Paper / Purpur

Mod ağırlıklı sunucu
→ Forge / NeoForge / Fabric

25. Plugin dependency nedir?

Bazı pluginler tek başına çalışmaz.

Başka bir plugine ihtiyaç duyabilir.

Buna:

Dependency

denir.

Örneğin bir plugin:

Vault required

diyorsa çalışmak için Vault pluginine ihtiyaç duyuyor olabilir.

Başka bir plugin:

ProtocolLib required

diyebilir.

Bu durumda gerekli dependency pluginini de yüklemeniz gerekir.

26. Dependency eksikse ne olur?

Sunucu konsolunda buna benzer mesajlar görebilirsiniz:

Could not load plugin
Unknown dependency
Missing dependency

Bu durumda plugin bozuk olmayabilir.

Sadece gerekli başka bir plugin eksik olabilir.

Pluginin indirme sayfasındaki:

Dependencies
Requirements
Required plugins

bölümlerini kontrol edin.

27. Soft dependency nedir?

Bazı pluginler başka bir plugin olmadan da çalışabilir ancak o plugin varsa ek özellikler kullanabilir.

Buna genellikle:

Soft dependency

denir.

Yeni başlayan kullanıcı olarak bunu bilmeniz yeterlidir.

Her dependency zorunlu değildir.

28. Plugin yükledim ama config dosyası yok

Pluginin config dosyası çoğu zaman ilk başarılı çalıştırmadan sonra oluşur.

Örneğin:

plugins/Essentials/config.yml

gibi bir dosya ancak sunucu pluginle birlikte bir kez başlatıldıktan sonra oluşabilir.

Yani:

Plugini yükle
↓
Sunucuyu başlat
↓
Plugin klasörü oluşsun
↓
Config dosyasını düzenle

şeklinde ilerleyin.

29. config.yml nedir?

Birçok plugin ayarlarını:

config.yml

dosyasında tutar.

Örneğin:

plugins/PluginAdi/config.yml

dosyasından pluginin ayarlarını değiştirebilirsiniz.

Ancak yeni kullanıcıysanız anlamadığınız satırları rastgele değiştirmeyin.

YAML dosyalarında boşluklar önemlidir.

30. Plugin ayarını değiştirdim, ne yapacağım?

En güvenli yöntem:

Sunucuyu stop ile kapat
↓
config dosyasını düzenle
↓
Kaydet
↓
Sunucuyu tekrar başlat

şeklindedir.

31. /reload komutunu kullanmalı mıyım?

Yeni başlayan kullanıcılara genel olarak:

/reload

yerine sunucuyu düzgün şekilde yeniden başlatmalarını öneriyoruz.

Bazı pluginler tam reload işlemlerinde beklenmeyen davranış gösterebilir.

En temiz yöntem:

stop

ile kapatıp yeniden başlatmaktır.

32. Plugin JAR dosyasını değiştirdim ama eski sürüm de duruyor

Bu sık yapılan bir hatadır.

Örneğin:

EssentialsX-2.20.jar
EssentialsX-2.21.jar

iki dosyayı birden plugins klasöründe bırakmayın.

Aynı pluginin eski ve yeni JAR dosyalarının birlikte bulunması sorun çıkarabilir.

Plugin güncellerken:

Sunucuyu kapat
↓
Eski JAR dosyasını kaldır
↓
Yeni JAR dosyasını yükle
↓
Sunucuyu aç

şeklinde ilerleyin.

Pluginin veri klasörünü ise ne yaptığınızı bilmiyorsanız silmeyin.

33. Plugin kurdum, sunucu artık açılmıyor

İlk yapmanız gereken paniğe kapılmak değil, son yüklediğiniz plugini düşünmektir.

Örneğin sunucu plugin yüklemeden önce açılıyordu ama:

PluginX.jar

yükledikten sonra açılmıyorsa plugin sürümü veya dependency problemi olabilir.

Sunucuyu kapatın.

Son yüklediğiniz plugin JAR dosyasını geçici olarak plugins klasöründen çıkarın.

Sunucuyu tekrar başlatın.

Sunucu açılırsa problem büyük ihtimalle o plugin veya onun gereksinimleriyle ilgilidir.

34. latest.log dosyasına nasıl bakarım?

Sunucu klasöründe:

logs/latest.log

dosyası bulunur.

Plugin yükleme problemlerinde özellikle:

ERROR
Exception
Could not load
Could not enable
dependency
Unsupported

kelimelerini arayabilirsiniz.

Gerçek hata çoğu zaman burada yazar.

35. Windows VDS üzerinde plugin nasıl kurulur?

Minecraft sunucunuzu Windows VDS üzerinde çalıştırıyorsanız önce Minecraft konsoluna:

stop

yazın.

Sunucunun bulunduğu klasörü Windows Explorer ile açın.

Örneğin:

C:\MinecraftServer\

içerisinde:

plugins

klasörüne girin.

Plugin JAR dosyanızı buraya kopyalayın.

Örneğin:

C:\MinecraftServer\plugins\EssentialsX.jar

Sonra sunucuyu tekrar başlatın.

36. Hosting panelinden plugin nasıl kurulur?

Sunucu panelinizi açın.

Minecraft sunucunuzu kapatın.

Dosya Yöneticisi / File Manager bölümüne girin.

Şu klasörü açın:

plugins

İndirdiğiniz:

PluginAdi.jar

dosyasını yükleyin.

Yükleme tamamlandıktan sonra Minecraft sunucunuzu tekrar başlatın.

37. Linux sunucuda plugin nasıl kurulur?

Linux kullanıyorsanız mantık yine aynıdır.

Sunucuyu:

stop

komutuyla kapatın.

Plugin JAR dosyasını:

plugins/

klasörüne yükleyin.

Sonra Minecraft sunucusunu tekrar başlatın.

Windows veya Linux kullanmanız pluginin temel kurulum mantığını değiştirmez.

38. Plugin kurmak için FTP kullanabilir miyim?

Evet.

Hosting sağlayıcınız FTP veya SFTP erişimi veriyorsa plugin dosyasını dosya transfer programıyla da yükleyebilirsiniz.

Yine hedef klasör:

plugins

olmalıdır.

39. Pluginin çalıştığını en basit nasıl anlarım?

Şu dört şeyi kontrol edin:

1. Sunucu açılıyor mu?

2. Konsolda plugin hatası var mı?

3. /plugins listesinde plugin görünüyor mu?

4. Pluginin komutu çalışıyor mu?

Örneğin kurduğunuz plugin:

/home

komutu ekliyorsa oyunda komutu deneyebilirsiniz.

40. Plugin komutu çalışıyor ama "no permission" diyor

Bu durumda plugin yüklenmiş olabilir ancak sizin o komutu kullanma yetkiniz olmayabilir.

Örneğin:

You do not have permission

mesajı alabilirsiniz.

Test amacıyla kendinize OP vermeniz gerekebilir.

Konsola:

op OyuncuAdi

yazabilirsiniz.

Daha gelişmiş sunucularda ise LuckPerms gibi permission sistemleri kullanılır.

41. Plugin ile mod arasındaki fark nedir?

Yeni kullanıcıların en fazla karıştırdığı konu budur.

Çok basit şekilde:

Paper / Spigot / Purpur
→ plugins klasörü
→ Plugin

Forge / NeoForge / Fabric
→ mods klasörü
→ Mod

Örneğin:

EssentialsX
LuckPerms
WorldEdit Bukkit
Vault

genellikle plugin tarafındadır.

Bir Forge modu ise doğrudan:

plugins

klasörüne atılmaz.

42. Plugin oyuncunun bilgisayarına da kurulmalı mı?

Çoğu klasik Paper/Spigot/Purpur plugini için hayır.

Plugin sunucu tarafında çalışır.

Oyuncu normal Minecraft istemcisiyle bağlanabilir.

Bu, modlardan önemli bir farktır.

Birçok modlu sunucuda aynı modların oyuncunun bilgisayarında da bulunması gerekebilir.

Pluginlerde ise çoğu zaman oyuncunun ekstra dosya yüklemesi gerekmez.

43. Plugin yüklemek oyuncuların sunucu adresini değiştirir mi?

Hayır.

Plugin yüklemeniz sunucunun IP adresini veya portunu değiştirmez.

Oyuncular aynı sunucu adresiyle bağlanmaya devam eder.

44. Plugin yükledikten sonra world silinir mi?

Normal bir plugin kurulumu mevcut dünyanızı otomatik olarak silmez.

Ancak her zaman pluginin ne yaptığını ve güvenilir bir kaynaktan gelip gelmediğini kontrol edin.

Özellikle dünya üzerinde büyük değişiklik yapan pluginlerden önce yedek almak iyi bir alışkanlıktır.

45. Plugin indirirken dikkat etmem gerekenler

Plugin indirirken:

• Minecraft sürümünüzü kontrol edin.
• Paper/Spigot/Bukkit uyumluluğunu kontrol edin.
• Gerekli dependencyleri kontrol edin.
• Pluginin güncel olup olmadığını kontrol edin.
• Güvenilir kaynaklardan indirin.

İnternette rastgele bulunan JAR dosyalarını sunucunuza yüklemek güvenlik riski oluşturabilir.

46. Plugin kurulumunda en sık yapılan hatalar

Hata 1: Vanilla sunucuya plugin atmak

Vanilla
+
plugins/EssentialsX.jar

çalışmaz.

Paper, Spigot veya Purpur gibi plugin destekleyen bir server yazılımı kullanın.

Hata 2: Plugin yerine ZIP dosyası yüklemek

İçerisindeki gerçek .jar dosyasını kontrol edin.

Hata 3: Yanlış Minecraft sürümüne ait plugin kullanmak

Pluginin sürüm desteğini kontrol edin.

Hata 4: Dependency yüklememek

Plugin başka bir plugine ihtiyaç duyuyor olabilir.

Hata 5: Forge modunu plugins klasörüne atmak

Mod ve plugin aynı şey değildir.

Hata 6: Eski ve yeni plugin JAR dosyasını birlikte bırakmak

Güncelleme yaparken eski JAR dosyasını kaldırın.

Hata 7: Her değişiklikte /reload kullanmak

Yeni başlayan kullanıcı için düzgün restart daha güvenlidir.

47. Baştan sona örnek plugin kurulumu

Diyelim Paper Minecraft sunucunuz var.

Şu plugin dosyasını indirdiniz:

EssentialsX.jar

Yapacağınız işlem:

1. Sunucu panelini aç.

2. Konsola gir.

3. stop yaz.

4. Dosya yöneticisini aç.

5. plugins klasörüne gir.

6. EssentialsX.jar dosyasını yükle.

7. Sunucuyu yeniden başlat.

8. Konsolu kontrol et.

9. Oyuna gir.

10. Pluginin komutlarını test et.

Hepsi bu kadar.

48. Plugin çalışmıyorsa hızlı kontrol listesi

Sunucum Paper / Spigot / Purpur mu?
        ↓
Plugin .jar dosyası plugins klasöründe mi?
        ↓
Plugin Minecraft sürümümle uyumlu mu?
        ↓
Dependency gerekiyor mu?
        ↓
Sunucuyu yeniden başlattım mı?
        ↓
Konsolda hata var mı?
        ↓
logs/latest.log ne diyor?

49. Hâlâ anlamadıysanız sadece bunu yapın

Paper, Spigot veya Purpur kullanıyorsanız:

Sunucuyu kapat
↓
plugins klasörünü aç
↓
PluginAdi.jar dosyasını yükle
↓
Sunucuyu tekrar aç

Örneğin:

plugins/EssentialsX.jar

Hepsi bu kadar.

Sunucu açılmıyorsa veya plugin çalışmıyorsa dosyayı rastgele silip tekrar yüklemek yerine konsoldaki hata mesajını kontrol edin.

Batihost'ta sadece sunucu vermiyoruz, Minecraft da biliyoruz.

Minecraft sunucunuzu yeni aldıysanız Paper, Spigot, Purpur, plugin, mod, dependency veya permission gibi kavramlar ilk başta karmaşık gelebilir.

Batihost olarak Minecraft sunucu ve VDS hizmetlerinin yanında plugin kurulumu, Java, mod, Forge, NeoForge, Fabric ve Minecraft sunucu hatalarının çözümünde de müşterilerimize yardımcı oluyoruz.

Plugin yükledikten sonra sunucunuz açılmıyorsa veya konsolda hata görüyorsanız hata mesajı genellikle problemin gerçek sebebini gösterir.

Batihost Minecraft Sunucu ve VDS hizmetlerini inceleyin