Rehber

Minecraft plugin'i nasıl kurulur

18 Ekim 2026 güncellendi

Bir plugin'i kurmak bir dakika sürer: bir .jar dosyasını sunucunun plugins/ klasörüne bırakır ve yeniden başlatırsın. Sorunların çoğu bunun etrafındaki adımlardan çıkar: plugin çalıştıramayan bir sunucu, başka bir sürüm için yapılmış bir plugin veya eksik bir bağımlılık. Bu rehber hepsini kapsar.

Önce bir test sunucusunda dene, sonra .jar'ı kur.

Bunu Codexe ile oluştur

Adım adım

  1. 1.Sunucunun plugin çalıştırabildiğini kontrol et

    Plugin'ler Bukkit tabanlı sunucu yazılımı gerektirir: oyun sunucuları için Paper, Spigot, Purpur veya Folia, proxy'ler için BungeeCord veya Velocity. Vanilla bir sunucu ya da bir Fabric veya Forge sunucusu plugin yüklemez.

  2. 2.Plugin'in sürümünü kontrol et

    Plugin sayfası veya dosyası hangi Minecraft sürümlerini desteklediğini söyler. Sunucundan daha yeni bir sürüm için derlenmiş bir plugin genellikle yüklenmeyi reddeder.

  3. 3.Sunucuyu durdur ve .jar'ı kopyala

    .jar dosyasını sunucu .jar'ının yanındaki plugins/ klasörüne koy. Bir barındırma panelinde dosya yöneticisi veya SFTP ile yükle. Arşivden çıkarma.

  4. 4.Bağımlılıklarını kur

    Plugin başka plugin'lere (Vault, PlaceholderAPI, ProtocolLib, LuckPerms) ihtiyaç duyuyorsa onların .jar dosyalarını da plugins/ içine koy.

  5. 5.Sunucuyu başlat ve konsolu oku

    Açılış günlüğünde plugin'in adını ara. Ardından hata gelmeyen "Enabling <Plugin>" satırı yüklendiği anlamına gelir.

  6. 6.Oyunda kontrol et ve yapılandır

    /plugins komutunu çalıştır: yüklenen plugin'ler yeşil, etkinleşemeyenler kırmızıdır. Ayarları plugins/<PluginName>/config.yml içinde görünür; düzenle ve yeniden başlat.

Dosyalar nereye gider

Bir plugin ile ilk açılıştan sonra tipik bir sunucu klasörü şöyle görünür:

  • paper.jar (veya spigot.jar): sunucunun kendisi.
  • plugins/MyPlugin.jar: eklediğin plugin.
  • plugins/MyPlugin/: plugin'in oluşturduğu, config.yml, mesajlar ve kaydedilmiş verilerini içeren bir klasör.
  • logs/latest.log: yükleme hatalarının yazıldığı, geçerli çalışmanın günlüğü.

Yeniden başlat, /reload kullanma

/reload sunucuyu yeniden başlatmadan her plugin'i kaldırıp yeniden yükler. Birçok plugin bunu desteklemez: dinleyiciler iki kez kaydolur, veriler kaybolur veya bellek sızıntısı olur. Bir plugin ekledikten, kaldırdıktan veya güncelledikten sonra sunucuyu her zaman yeniden başlat. Bazı plugin'lerin yalnızca kendi yapılandırması için kendi yeniden yükleme komutu vardır (örneğin /myplugin reload): onu kullanmak güvenlidir.

Canlı sunucuya kurmadan önce

  • Sunucu klasörünü ya da en azından plugins/ ve dünyaları yedekle.
  • Önce bir kopyada dene: gerçek sunucuyla aynı yazılım, sürüm ve diğer plugin'ler. Bkz. plugin nasıl test edilir.
  • Her seferinde tek plugin: bir şey bozulursa hangisinin bozduğunu bilirsin.
  • Yeniden yüklemelerden değil, yazarın sayfasından indir (SpigotMC, Hangar, Modrinth, GitHub).

Codexe ile yapılan plugin'ler

Codexe'te yapılan bir plugin, proje adını taşıyan derlenmiş bir .jar olarak gelir ve sana ulaşmadan önce kontrol edilir: derlenmiş sınıfları ve bir plugin.yml içermelidir. Herhangi bir yere kurmadan önce özel bir test sunucusunda deneyebilirsin, her planda ücretsiz; test sunucusu bağımlılık olarak listelenen plugin'leri senin için kurar. .jar'ı kendi sunucun için indirmek bir plan veya indirme paketi gerektirir.

Sorular

Vanilla bir sunucuya plugin kurabilir miyim?

Hayır. Sunucu .jar'ını aynı Minecraft sürümünün Paper (veya Spigot) dosyasıyla değiştir; dünyan çalışmaya devam eder. Vanilla sunucular için alternatif bir datapack'tir.

Tek oyunculu modda plugin kurabilir miyim?

Hayır, plugin'ler yalnızca sunucularda çalışır. Kendi bilgisayarında yerel bir Paper sunucusu çalıştırıp ona localhost üzerinden katılabilirsin.

Oyuncuların bir şey kurması gerekiyor mu?

Hayır. Plugin'ler yalnızca sunucuda çalışır: oyuncular normal oyunla katılır. Yalnızca kaynak paketi kullanan plugin'ler oyunculardan onu kabul etmelerini ister.

Plugin'im /plugins listesinde neden kırmızı?

Bulundu ama etkinleşemedi. Nedeni konsolda hemen öncesinde yazar: bkz. plugin hataları nasıl düzeltilir.

Bugün kurabileceğin bir plugin yap

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

“JoinMessages adlı bir Paper 1.21.4 plugin'i: oyuncu adı ve çevrimiçi sayısıyla özel giriş ve çıkış mesajları, ilk girişte farklı bir mesaj, bir karşılama başlığı ve tüm mesajlar ile sesler config.yml içinde.”

Bunu Codexe ile oluştur
Minecraft plugin'i sunucuna nasıl kurulur | Codexe