Rehber

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

7 Ekim 2026 güncellendi

Paper, plugin'ler için en çok kullanılan Minecraft sunucu yazılımıdır: Spigot plugin'lerini çalıştırır ve üstüne daha büyük, daha hızlı bir API ekler. Bir Paper plugin'i, paper-api karşısında derlenmiş bir Java (veya Kotlin) projesidir. Elle veya senin için derleyen bir yapay zekayla neye ihtiyacı olduğu burada.

Başlamak için bir örnek.

Bunu Codexe ile oluştur

Adım adım

  1. 1.Minecraft sürümünü seç

    Sunucunun çalıştırdığı sürümü kullan. Java sürümünü o belirler: 1.20.5'ten önce Java 17, 1.20.5'ten itibaren Java 21, 26.x için Java 25.

  2. 2.Projeyi oluştur

    O sürüm için PaperMC deposundan gelen paper-api bağımlılığı olan, provided/compileOnly kapsamında bir Gradle veya Maven projesi.

  3. 3.Ana sınıfı yaz

    Komutları ve dinleyicileri kaydetmek için onEnable() olan, JavaPlugin sınıfını genişleten bir sınıf.

  4. 4.Plugin'i sunucuya tanıt

    plugin.yml (ad, sürüm, main, api-version, komutlar, izinler). Paper ayrıca kendi yükleme kurallarına sahip paper-plugin.yml dosyasını da destekler.

  5. 5.Derle ve test et

    .jar'ı derle, bir Paper test sunucusunun plugins/ klasörüne koy, başlat ve konsolda hata olup olmadığına bak.

Paper mı Spigot mu?

Spigot API'si için yazılmış kod Paper'da çalışır ama tersi doğru değildir: Paper, Spigot'ta olmayan olaylar ve metotlar (örneğin Adventure metin bileşenleri ve birçok eşzamansız API) ekler. Sunucun Paper çalıştırıyorsa Paper için yaz; plugin Spigot sunucularında da çalışmalıysa Spigot için yaz.

Hızlı yol

Codexe'te bir Bukkit/Spigot/Paper plugin'i seç, istekte "Paper" ve sürümü söyle ve ne yaptığını anlat. Codexe projeyi ve doğru Java sürümünü kurar, derler, derleme hatalarını düzeltir ve plugin'in kurulu olduğu bir Paper test sunucusuna katılmana izin verir.

Yaygın sorunlar

  • UnsupportedClassVersionError: plugin, sunucunun çalıştırdığından daha yeni bir Java ile derlenmiş.
  • NoSuchMethodError / NoClassDefFoundError: plugin sunucu sürümünde bulunmayan bir API kullanıyor veya bir bağımlılık .jar içine gömülmemiş.
  • Plugin yükleniyor ama komutlar hiçbir şey yapmıyor: komut plugin.yml içinde eksik veya yürütücü kaydedilmemiş.

Sorular

Paper plugin'leri Purpur veya Folia'da çalışır mı?

Purpur bir Paper çatalıdır, bu yüzden Paper plugin'leri orada çalışır. Folia iş parçacığı modelini değiştirir: bir plugin'in Folia'da çalışması için bölge zamanlayıcısına göre yazılmış olması gerekir.

Paper plugin'ini Kotlin ile yazabilir miyim?

Evet. Codexe aynı Paper API'si için build.gradle.kts içeren bir Kotlin Gradle projesi üretebilir.

Şimdi bir Paper plugin'i oluştur

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

“Bounties adlı bir Paper 1.21.4 plugin'i: Vault ekonomisini kullanan /bounty set <player> <amount>, ödülü öldüren alır, /bounty list ilk 10'u gösterir, ödüller yeniden başlatmalarda saklanır, mesajlar config.yml içinde.”

Bunu Codexe ile oluştur
Paper plugin'i (Minecraft) nasıl yapılır | Codexe