Rehber

Spigot plugin'i nasıl yapılır

7 Ekim 2026 güncellendi

Bir Spigot plugin'i Bukkit/Spigot API'sini kullanır, bu yüzden Spigot'ta ve Paper dahil her çatalında çalışır. Bu, plugin'in nerede çalışacağını bilmediğinde onu en geniş seçim yapar. Bu rehber projeyi, kodu ve derlemeyi kapsar.

Örneği sunucuna göre değiştir.

Bunu Codexe ile oluştur

Adım adım

  1. 1.Java'yı ve bir derleme aracını kur

    Minecraft sürümüne uyan JDK'yı (17, 21 veya 25) kur ve Maven veya Gradle kullan.

  2. 2.Spigot API'sini ekle

    Sürümün için spigot-api bağımlılığını Spigot deposundan provided kapsamıyla ekle. Yalnızca derlemek için gerekir; sunucu bunu çalışma anında sağlar.

  3. 3.Komutları ve dinleyicileri yaz

    getCommand("name").setExecutor(...) ile bir CommandExecutor ve registerEvents ile olay dinleyicileri kaydet.

  4. 4.plugin.yml yaz

    Ad, sürüm, ana sınıf, api-version (1.13'ten itibaren), komutlar ve izinler.

  5. 5.Derle ve kur

    mvn package, sonra .jar'ı target/ klasöründen sunucunun plugins/ klasörüne kopyala ve yeniden başlat.

Eski sürümler (1.8'den 1.12'ye)

Birçok mini oyun sunucusu hâlâ 1.8 çalıştırıyor. API daha eski (api-version yok, farklı materyal adları), bu yüzden plugin o sürüm için yazılmalı, 1.21 öğreticisinden kopyalanmamalı. Codexe sürümü sorar ve kodu o API için yazar.

Codexe ile

Plugin'i anlat ve sürümle birlikte "Spigot" de. Codexe Maven projesini üretir, derler, hataları düzeltir ve indirmeden önce o sürümdeki bir test sunucusunda test etmene izin verir.

Sorular

BuildTools'a ihtiyacım var mı?

Yalnızca bir Spigot sunucusu çalıştırmak veya NMS (sunucunun iç kodu) kullanmak için. Normal API'ye karşı derlemek için spigot-api bağımlılığı yeter.

Spigot plugin'i mi Paper plugin'i mi?

Her yerde çalışması gerekiyorsa Spigot; sunucun Paper çalıştırıyorsa ve ekstra API'sini istiyorsan Paper. Bkz. Paper plugin'i nasıl yapılır.

Bir Spigot plugin'i yap

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

“Kits adlı bir Spigot 1.8.8 plugin'i: kit başına bekleme süresiyle yapılandırılabilir bir eşya seti veren /kit <name>, kitler config.yml içinde tanımlı, kit başına kits.<name> izni, bekleme süreleri yeniden başlatmalarda saklanır.”

Bunu Codexe ile oluştur
Spigot plugin'i nasıl yapılır: kurulum, kod, derleme | Codexe