Panduan

Cara membuat plugin BungeeCord

Diperbarui 18 Oktober 2026

Plugin BungeeCord berjalan di proxy yang berada di depan server-servermu, bukan di server game. Plugin ini melihat pemain terhubung, berpindah server, dan keluar, jadi inilah tempat yang tepat untuk chat seluruh jaringan, alat staf, mode maintenance, MOTD, dan mengirim pemain antar server. Plugin ini tidak punya world atau blok: gameplay ada di plugin pada server backend.

Sesuaikan perintahnya dengan jaringanmu.

Buat ini dengan Codexe

Langkah demi langkah

  1. 1.Pastikan proxy yang kamu jalankan

    BungeeCord (atau fork seperti Waterfall) dan Velocity adalah API yang berbeda. Plugin BungeeCord tidak berjalan di Velocity, begitu pula sebaliknya.

  2. 2.Siapkan proyek

    Proyek Maven atau Gradle dengan dependensi bungeecord-api dengan scope provided. Proxy menyediakannya saat runtime.

  3. 3.Tulis class utama

    Class yang meng-extend net.md_5.bungee.api.plugin.Plugin, dengan onEnable() untuk mendaftarkan perintah dan listener lewat getProxy().getPluginManager().

  4. 4.Deskripsikan di bungee.yml

    name, version, main, dan author. BungeeCord juga membaca plugin.yml, tetapi bungee.yml menghindari kebingungan dengan plugin Spigot. Perintah didaftarkan di kode, bukan di file.

  5. 5.Tulis perintah dan listener

    Perintah meng-extend Command; listener mengimplementasikan Listener dengan method @EventHandler untuk event seperti PostLoginEvent atau ServerSwitchEvent.

  6. 6.Berkomunikasi dengan server backend jika perlu

    Proxy tidak bisa melihat inventory atau world. Untuk itu, plugin pendamping kecil di setiap server backend bertukar plugin message dengan plugin proxy.

  7. 7.Pasang di proxy

    Letakkan .jar di folder plugins/ proxy dan restart proxy-nya, bukan server backend.

Event proxy yang berguna

EventKapan terpicuPenggunaan umum
ProxyPingEventClient memuat ulang daftar serverMOTD, jumlah pemain, pesan maintenance
PostLoginEventPemain sudah bergabung ke proxyPesan join, memuat data pemain
ServerConnectEventPemain akan terhubung ke sebuah serverMengirim pemain ke lobi, memblokir server
ServerSwitchEventPemain pindah ke server lainPesan "bergabung ke server" di seluruh jaringan
PlayerDisconnectEventPemain keluar dari jaringanMenyimpan data, notifikasi staf
ChatEventPemain mengirim pesan chat atau perintahChat jaringan, filter, chat staf

Menyiapkan jaringan dengan benar

  • Aktifkan ip_forward di config.yml proxy dan bungeecord: true di spigot.yml setiap server Spigot atau Paper, agar nama pemain dan UUID diteruskan.
  • Atur server backend ke online-mode=false dan pastikan server tersebut tidak bisa diakses langsung dari internet, hanya lewat proxy.
  • Plugin message hanya terkirim selama ada pemain yang terhubung ke server backend itu, jadi pesan ke server kosong tidak akan sampai.

Contoh deskripsi

"Plugin proxy BungeeCord 1.21 bernama NetUtils. /lobby mengirim pemain ke server lobi. /staffchat <message> (alias /sc) mengirim pesan ke semua orang dengan netutils.staff di server mana pun. /maintenance on|off menampilkan MOTD maintenance dan menendang pemain tanpa netutils.bypass. Pesan join di chat staf saat anggota staf berpindah server. Nama server, MOTD, dan pesan di config.yml."

Dengan Codexe

Pilih tipe BungeeCord/Velocity dan sebutkan proxy yang kamu jalankan, karena API-nya berbeda. Codexe mengompilasi plugin dengan Maven dan memeriksa bahwa .jar punya descriptor yang benar sebelum Ready; tanpa versi di permintaan, BungeeCord API 1.21 yang dipakai. Jika kamu butuh pendamping di backend, mintalah sebagai proyek Spigot/Paper terpisah.

Coba sekarang belum menjalankan server proxy, jadi uji plugin proxy di jaringanmu sendiri atau di proxy lokal dengan satu server backend. Lihat juga generator plugin BungeeCord.

Pertanyaan

Bisakah plugin BungeeCord mengubah blok atau inventory?

Tidak, proxy hanya menangani koneksi dan pesan. Gunakan plugin backend untuk gameplay, dan plugin message jika keduanya harus bekerja sama.

Apakah ini berfungsi di Velocity?

Tidak. Velocity punya API dan velocity-plugin.json sendiri. Jika kamu menjalankan keduanya, buat dua proyek.

Plugin proxy atau plugin backend untuk chat?

Plugin proxy jika chat harus sampai ke pemain di setiap server. Plugin backend jika chat tetap di satu server.

Buat plugin untuk jaringanmu

Prompt ini terbuka dan siap dikirim:

“Plugin proxy BungeeCord 1.21 bernama NetUtils: /lobby mengirim pemain ke server lobi, /staffchat (alias /sc) mengirim pesan ke semua orang dengan netutils.staff di server mana pun, /maintenance on|off menampilkan MOTD maintenance dan menendang pemain tanpa netutils.bypass, perpindahan server staf diumumkan di chat staf, nama server, MOTD, dan pesan di config.yml.”

Buat ini dengan Codexe
Cara membuat plugin BungeeCord untuk jaringanmu | Codexe