Paper API ile İlk Eklentiyi Nasıl Yazarsınız? (Spigot ile Karşılaştırma)

[EmirX]

• Paper mı, Spigot mu?
• Paper, Spigot’un resmi çatallanmış sürümüdür ve org.bukkit API’sini aynı tutar; ancak org.spigotmc paketleri ve com.destroystokyo.paper paketleriyle eşsiz özellikler sunar.
• Eğer sunucu kapasiteli bir ortamda yüksek oyuncu sayısını yönetmek istiyorsanız Paper’ın async işleyicilerini kullanmak, gecikmeleri azaltır.
• Basit bir eklenti geliştirirken, Spigot zaten yeterli olabilir; ancak Paper, PlayerMoveEvent gibi olayları daha verimli işleyen PlayerMoveEvent’in async versiyonuna sahiptir.

Özellik	Paper API	Spigot API
Async işleyiciler	Var	Sınırlı
Güncellemeler	Sık	Daha az
Genişletilmiş API	Evet	Sınırlı
Uyumluluk	1.16‑1.20+	Aynı versiyon aralığı

• İlk eklentinin temel yapısı
  

  package com.example.myplugin;
  
  import org.bukkit.plugin.java.JavaPlugin;
  import org.bukkit.event.Listener;
  import org.bukkit.event.EventHandler;
  import org.bukkit.event.player.PlayerJoinEvent;
  
  public class MyPlugin extends JavaPlugin implements Listener {
  
      @Override
      public void onEnable() {
          getLogger().info("Eklenti aktif!");
          getServer().getPluginManager().registerEvents(this, this);
      }
  
      @Override
      public void onDisable() {
          getLogger().info("Eklenti devreden çıkarıldı!");
      }
  
      @EventHandler
      public void onPlayerJoin(PlayerJoinEvent event) {
          event.getPlayer().sendMessage("Hoş geldiniz, " + event.getPlayer().getName() + "!");
      }
  }

• Geliştirme ortamı
  pom.xml dosyanızda org.spigotmc:spigot-api yerine com.destroystokyo.paper:paper-api bağımlılığını ekleyin.
  

  <dependency>
      <groupId>com.destroystokyo.paper</groupId>
      <artifactId>paper-api</artifactId>
      <version>1.20.4-R0.1-SNAPSHOT</version>
      <scope>provided</scope>
  </dependency>

• Sorgulama
  Sunucu tipinizde Bukkit yerine Paper mı çalışıyor?
  Eklentinizi geliştirdikten sonra performans testi yaptınız mı?
  Paper’ın async yardımcı sınıflarını denediniz mi?

İlgili konular​

• Paper API ile Adventure Kitaplarıyla Etkileşimli Hikaye Nasıl Yazılır?