Minecraft eklentisi packetevents

🔌 PacketEvents hakkında

PacketEvents, Minecraft Java Edition için ham protokol paketlerini yakalamak, incelemek, iptal etmek ve göndermek için bir API sunan bir protokol kütüphanesidir. Bir sunucu/proxy üzerinde bağımsız bir eklenti olarak kullanılabilir veya diğer eklentiler ve modlar için bir kütüphane bağımlılığı olarak paketlenebilir.

🎯 Amaç

Eklenti ve mod geliştiricileri için kararlı, çok platformlu bir paket katmanı sağlamak; böylece Netty'nin düşük seviyeli kodunu yazmadan veya sürüme özel birçok protokol uygulamasını kendileri sürdürmeden Minecraft protokol paketlerine (login, play, status, handshake vb.) tepki verip onları değiştirebilirler.

⚙️ Özellikler

• Gelen ve giden paketler için olay tabanlı paket yakalama (receive/send olayları ve protokol düzeyi olaylar).
• Sunucu/istemci işlemeye başlamadan önce paketleri iptal etme veya değiştirme imkânı.
• Paketleri programlı olarak gönderme ve simüle etme için API.
• Temiz yaşam döngüsü: uygun kaynak yönetimi için PacketEvents örneğini oluştur/yükle/başlat/sonlandır.
• Çok modüllü destek: yaygın platformlar için ayrı build/modüller, böylece aynı API farklı sunucu/proxy/mod ortamlarında çalışır.
• Yayınlanmış Javadocs ve Maven/Gradle kullanımı için belgelenmiş geliştirici kurulumu.

🧩 Kimler için

• Protokol düzeyinde erişime ihtiyaç duyan eklenti ve mod geliştiricileri (paket gönderme, simüle etme veya değiştirme).
• Paket yakalama gerektiren eklentiler için PacketEvents'i bağımlılık olarak kuran sunucu yöneticileri.

🏗️ Örnek kullanım alanları

• Bir eklenti packet listener kaydeder ve varsayılan işlemi önlemek için belirli bir gelen paketi iptal eder.
• Bir mod, sunucu tarafında entity değişikliği yapmadan özel görsel efektler veya arayüz oluşturmak için istemciye sentetik paketler gönderir.
• Bir proxy eklentisi, özel kimlik doğrulama akışları için login/handshake paketlerini işler.

⚙️ Kurulum

📥 Kurulum (sunucu yöneticisi)

• Resmî eklenti JAR dosyasını indirin ve sunucu/proxy plugins/ (veya eşdeğer) dizinine yerleştirin.
• Sunucu/proxy'yi yeniden başlatın ve PacketEvents'in doğru yüklendiğini doğrulamak için günlükleri kontrol edin.

🛠️ Geliştiriciler için (build kurulumu)

PacketEvents, platforma özel modüller olarak dağıtılır. Dokümantasyonda Maven/Gradle örnekleri gösterilir; kütüphane provided/compileOnly kapsamıyla eklenmek üzere tasarlanmıştır. Dokümanlarda modül adı için bir yer tutucu kullanılır; bağımlılık eklerken bunu hedef platform modülüyle (örneğin spigot, velocity, bungeecord, fabric, sponge) değiştirin.

Örnek (resmî dokümanlarda gösterilen Gradle parçası):

// INSERT_MODULE_HERE yerine desteklenen bir modül adı yazın (spigot, velocity, bungeecord, fabric, sponge)
compileOnly("com.github.retrooper:packetevents-~~INSERT_MODULE_HERE~~:2.12.1")

Kütüphanenin yaşam döngüsü yöntemlerini eklentiniz/modunuz içinden çağırın (load -> init) ve eklentiniz devre dışı bırakıldığında sonlandırın.

🧠 Teknik notlar

• Resmî olarak sağlanan modüller arasında Spigot, Velocity, BungeeCord, Fabric ve Sponge yer alır.
• Proje notlarında Spigot modülünün Paper, Purpur ve Folia gibi yaygın fork'larda çalışacak şekilde tasarlandığı, BungeeCord modülünün ise Waterfall üzerinde çalışması için amaçlandığı belirtilir.
• Proje kaynak kodu, sürümler ve Javadocs ile yayımlanır; GPL-3.0 lisansına sahiptir.
• Kütüphane, paketleme istenmediğinde eklenti build'lerine provided/compileOnly kapsamıyla eklenmek üzere tasarlanmıştır; bir eklentinin PacketEvents'i dağıtımına dahil ettiği durumlar için bundling yönergeleri belgelenmiştir.

🤝 Bu eklenti ne zaman faydalıdır

Projeniz özel kimlik doğrulama, paket tabanlı efektler, proxy işleme veya düşük seviyeli entegrasyonlar için Minecraft protokolü üzerinde doğrudan kontrol gerektiriyorsa, PacketEvents çok platformlu bir API ve yaşam döngüsü yönetimi sunar; böylece her sunucu veya proxy uygulaması için protokol işlemeyi yeniden yazmadan bu özellikleri oluşturabilirsiniz.