Vodič

Kako napraviti BungeeCord plugin

Ažurirano 18. listopada 2026.

BungeeCord plugin radi na proxyju koji stoji ispred tvojih poslužitelja, a ne na poslužitelju igre. Vidi kako se igrači spajaju, mijenjaju poslužitelje i odlaze, pa je pravo mjesto za chat na razini mreže, alate za staff, način održavanja, MOTD i slanje igrača između poslužitelja. Nema svjetove ni blokove: gameplay pripada pluginu na backend poslužiteljima.

Prilagodi naredbe svojoj mreži.

Generiraj ovo uz Codexe

Korak po korak

  1. 1.Potvrdi koji proxy koristiš

    BungeeCord (ili fork kao što je Waterfall) i Velocity različiti su API-ji. BungeeCord plugin ne radi na Velocityju, a ni obrnuto.

  2. 2.Postavi projekt

    Maven ili Gradle projekt s ovisnošću bungeecord-api u opsegu provided. Proxy je pruža pri pokretanju.

  3. 3.Napiši glavnu klasu

    Klasa koja proširuje net.md_5.bungee.api.plugin.Plugin, s onEnable() za registraciju naredbi i listenera preko getProxy().getPluginManager().

  4. 4.Opiši ga u bungee.yml

    name, version, main i author. BungeeCord čita i plugin.yml, ali bungee.yml izbjegava zabunu sa Spigot pluginovima. Naredbe se registriraju u kodu, a ne u datoteci.

  5. 5.Napiši naredbe i listenere

    Naredbe proširuju Command; listeneri implementiraju Listener s metodama @EventHandler za evente kao što su PostLoginEvent ili ServerSwitchEvent.

  6. 6.Komuniciraj s backend poslužiteljima ako treba

    Proxy ne vidi inventare ni svjetove. Za to mali prateći plugin na svakom backend poslužitelju razmjenjuje plugin poruke s proxy pluginom.

  7. 7.Instaliraj ga na proxy

    Stavi .jar u mapu plugins/ na proxyju i ponovno pokreni proxy, a ne backend poslužitelje.

Korisni proxy eventi

DogađajKad se okidaUobičajena upotreba
ProxyPingEventKlijent osvježava popis poslužiteljaMOTD, broj igrača, poruka o održavanju
PostLoginEventIgrač je ušao na proxyPoruke dobrodošlice, učitavanje podataka igrača
ServerConnectEventIgrač se upravo spaja na poslužiteljSlanje igrača u lobby, blokiranje poslužitelja
ServerSwitchEventIgrač je prešao na drugi poslužiteljPoruke „ušao na poslužitelj” na razini mreže
PlayerDisconnectEventIgrač je napustio mrežuSpremanje podataka, obavijesti za staff
ChatEventIgrač šalje poruku u chat ili naredbuMrežni chat, filteri, staff chat

Ispravno postavljanje mreže

  • Uključi ip_forward u config.yml proxyja i bungeecord: true u spigot.yml svakog Spigot ili Paper poslužitelja, kako bi se imena igrača i UUID-ovi prosljeđivali.
  • Postavi backend poslužitelje na online-mode=false i pobrini se da im se ne može pristupiti izravno s interneta, nego samo preko proxyja.
  • Plugin poruke putuju samo dok je igrač spojen na taj backend poslužitelj, pa poruka praznom poslužitelju neće biti dostavljena.

Primjer opisa

„BungeeCord 1.21 proxy plugin pod nazivom NetUtils. /lobby šalje igrača na lobby poslužitelj. /staffchat <message> (alias /sc) šalje poruku svima s netutils.staff na bilo kojem poslužitelju. /maintenance on|off prikazuje MOTD za održavanje i izbacuje igrače bez netutils.bypass. Poruka u staff chatu kad član staffa promijeni poslužitelj. Imena poslužitelja, MOTD i poruke u config.yml.”

S Codexeom

Odaberi vrstu BungeeCord/Velocity i navedi koji proxy koristiš, jer su to različiti API-ji. Codexe kompajlira plugin s Mavenom i provjerava ima li .jar pravi deskriptor prije nego što je Spremno; bez verzije u zahtjevu koristi se BungeeCord API 1.21. Ako ti treba prateći backend plugin, zatraži ga kao zaseban Spigot/Paper projekt.

Isprobaj odmah još ne pokreće proxy poslužitelje, pa proxy plugin testiraj na svojoj mreži ili na lokalnom proxyju s jednim backend poslužiteljem. Pogledaj i generator BungeeCord pluginova.

Pitanja

Može li BungeeCord plugin mijenjati blokove ili inventare?

Ne, proxy obrađuje samo veze i poruke. Za gameplay koristi backend plugin, a plugin poruke ako njih dvoje moraju raditi zajedno.

Radi li na Velocityju?

Ne. Velocity ima vlastiti API i velocity-plugin.json. Ako koristiš oba, napravi dva projekta.

Proxy plugin ili backend plugin za chat?

Proxy plugin ako chat mora stići do igrača na svakom poslužitelju. Backend plugin ako chat ostaje na jednom poslužitelju.

Napravi plugin za svoju mrežu

Ovaj prompt otvara se spreman za slanje:

“BungeeCord 1.21 proxy plugin pod nazivom NetUtils: /lobby šalje igrača na lobby poslužitelj, /staffchat (alias /sc) šalje poruku svima s netutils.staff na bilo kojem poslužitelju, /maintenance on|off prikazuje MOTD za održavanje i izbacuje igrače bez netutils.bypass, prelasci staffa najavljuju se u staff chatu, imena poslužitelja, MOTD i poruke u config.yml.”

Generiraj ovo uz Codexe
Kako napraviti BungeeCord plugin za svoju mrežu | Codexe