Plugin Minecraft packetevents

🔌 Tentang PacketEvents

PacketEvents adalah library protokol untuk Minecraft Java Edition yang menyediakan API untuk mencegat, memeriksa, membatalkan, dan mengirim raw protocol packets. Library ini bisa digunakan sebagai plugin mandiri di server/proxy atau digabungkan sebagai dependency library untuk plugin dan mod lain.

🎯 Tujuan

Menyediakan lapisan packet yang stabil dan lintas platform untuk developer plugin dan mod agar mereka dapat merespons dan memanipulasi Minecraft protocol packets (login, play, status, handshake, dll.) tanpa harus menulis kode Netty level rendah atau memelihara banyak implementasi protokol khusus versi sendiri.

⚙️ Fitur

• Intersepsi packet berbasis event untuk packet masuk dan keluar (receive/send events dan protocol-level events).
• Kemampuan untuk membatalkan atau mengubah packet sebelum diproses oleh server/client.
• API untuk mengirim dan mensimulasikan packet secara programatis.
• Lifecycle yang rapi: create/load/init/terminate instance PacketEvents untuk pengelolaan resource yang tepat.
• Dukungan multi-module: build/module terpisah untuk platform umum sehingga API yang sama bekerja di berbagai lingkungan server/proxy/mod.
• Javadocs yang dipublikasikan dan dokumentasi setup developer untuk penggunaan Maven/Gradle.

🧩 Untuk Siapa

• Developer plugin dan mod yang membutuhkan akses level protokol (mengirim, mensimulasikan, atau memodifikasi packet).
• Operator server yang memasang PacketEvents sebagai dependency untuk plugin yang membutuhkan packet interception.

🏗️ Contoh Penggunaan

• Sebuah plugin mendaftarkan packet listener dan membatalkan packet masuk tertentu untuk mencegah pemrosesan default.
• Sebuah mod mengirim synthetic packets ke client untuk membuat efek visual atau UI kustom tanpa mengubah entity di sisi server.
• Sebuah proxy plugin menangani packet login/handshake untuk alur autentikasi kustom.

⚙️ Instalasi

📥 Setup (operator server)

• Unduh JAR plugin resmi dan letakkan di direktori plugins/ server/proxy (atau yang setara).
• Restart server/proxy dan periksa log untuk memastikan PacketEvents dimuat dengan benar.

🛠️ Untuk developer (setup build)

PacketEvents didistribusikan sebagai module spesifik platform. Dokumentasi menampilkan contoh Maven/Gradle; library ini dimaksudkan untuk ditambahkan dengan scope provided/compileOnly. Dokumentasi menggunakan placeholder untuk nama module; ganti dengan module platform target (misalnya spigot, velocity, bungeecord, fabric, sponge) saat menambahkan dependency.

Contoh (snippet Gradle ditampilkan di dokumentasi resmi):

// Replace INSERT_MODULE_HERE with a supported module name (spigot, velocity, bungeecord, fabric, sponge)
compileOnly("com.github.retrooper:packetevents-~~INSERT_MODULE_HERE~~:2.12.1")

Panggil metode lifecycle library dari plugin/mod Anda (load -> init) dan terminate saat plugin dinonaktifkan.

🧠 Catatan Teknis

• Module resmi yang disediakan mencakup Spigot, Velocity, BungeeCord, Fabric, dan Sponge.
• Proyek ini mencatat bahwa module Spigot dirancang untuk bekerja pada fork yang umum digunakan seperti Paper, Purpur, dan Folia, dan module BungeeCord ditujukan untuk bekerja pada Waterfall.
• Proyek ini dipublikasikan dengan source, releases, dan Javadocs; lisensinya adalah GPL-3.0.
• Library ini dimaksudkan untuk ditambahkan dengan scope provided/compileOnly pada build plugin jika bundling tidak diinginkan; petunjuk bundling didokumentasikan untuk kasus ketika sebuah plugin menyertakan PacketEvents dalam distribusinya.

🤝 Kapan Plugin Ini Berguna

Jika proyek Anda membutuhkan kontrol langsung atas Minecraft protocol—untuk autentikasi kustom, efek berbasis packet, penanganan proxy, atau integrasi low-level—PacketEvents menyediakan API lintas platform dan manajemen lifecycle sehingga Anda bisa membangun fitur-fitur itu tanpa mengimplementasikan ulang penanganan protokol untuk setiap server atau implementasi proxy.