Príručka

Ako vytvoriť BungeeCord plugin

Aktualizované 18. októbra 2026

BungeeCord plugin beží na proxy, ktorá stojí pred tvojimi servermi, nie na hernom serveri. Vidí, ako sa hráči pripájajú, prepínajú servery a odchádzajú, takže je to správne miesto pre chat v celej sieti, nástroje pre tím, režim údržby, MOTD a posielanie hráčov medzi servermi. Nemá svety ani bloky: hrateľnosť patrí do pluginu na backend serveroch.

Uprav príkazy pre svoju sieť.

Vygeneruj to v Codexe

Krok za krokom

  1. 1.Over si, akú proxy používaš

    BungeeCord (alebo fork ako Waterfall) a Velocity majú rozdielne API. BungeeCord plugin nebeží na Velocity a naopak.

  2. 2.Priprav projekt

    Projekt Maven alebo Gradle so závislosťou bungeecord-api v scope provided. Proxy ju dodá za behu.

  3. 3.Napíš hlavnú triedu

    Trieda, ktorá rozširuje net.md_5.bungee.api.plugin.Plugin, s onEnable() na registráciu príkazov a listenerov cez getProxy().getPluginManager().

  4. 4.Opíš ho v bungee.yml

    name, version, main a author. BungeeCord číta aj plugin.yml, ale bungee.yml predchádza zámene so Spigot pluginmi. Príkazy sa registrujú v kóde, nie v súbore.

  5. 5.Napíš príkazy a listenery

    Príkazy rozširujú Command; listenery implementujú Listener s metódami @EventHandler pre eventy ako PostLoginEvent alebo ServerSwitchEvent.

  6. 6.Ak treba, komunikuj s backend servermi

    Proxy nevidí inventáre ani svety. Na to slúži malý sprievodný plugin na každom backend serveri, ktorý si s proxy pluginom vymieňa plugin messages.

  7. 7.Nainštaluj ho na proxy

    Daj .jar do priečinka plugins/ na proxy a reštartuj proxy, nie backend servery.

Užitočné eventy na proxy

UdalosťKedy sa spustíTypické použitie
ProxyPingEventKlient obnoví zoznam serverovMOTD, počet hráčov, správa o údržbe
PostLoginEventHráč sa pripojil na proxyUvítacie správy, načítanie dát hráča
ServerConnectEventHráč sa chystá pripojiť na serverPosielanie hráčov do lobby, blokovanie serverov
ServerSwitchEventHráč prešiel na iný serverSprávy „pripojil sa na server“ v celej sieti
PlayerDisconnectEventHráč opustil sieťUkladanie dát, upozornenia pre tím
ChatEventHráč pošle správu do chatu alebo príkazChat v sieti, filtre, chat tímu

Správne nastavenie siete

  • Zapni ip_forward v config.yml proxy a bungeecord: true v spigot.yml každého servera Spigot alebo Paper, aby sa mená hráčov a UUID preposielali ďalej.
  • Nastav backend servery na online-mode=false a zaisti, aby neboli dostupné priamo z internetu, iba cez proxy.
  • Plugin messages putujú iba vtedy, keď je na danom backend serveri pripojený hráč, takže správa na prázdny server sa nedoručí.

Príklad popisu

„Proxy plugin pre BungeeCord 1.21 s názvom NetUtils. /lobby pošle hráča na lobby server. /staffchat <message> (alias /sc) pošle správu všetkým s netutils.staff na ktoromkoľvek serveri. /maintenance on|off zobrazí MOTD údržby a vyhodí hráčov bez netutils.bypass. Správa v chate tímu, keď člen tímu prepne server. Názvy serverov, MOTD a správy v config.yml.“

S Codexe

Vyber typ BungeeCord/Velocity a uveď, akú proxy používaš, pretože majú rozdielne API. Codexe plugin skompiluje cez Maven a skontroluje, či má .jar správny deskriptor, skôr než je v stave Pripravené; ak v zadaní nie je verzia, použije sa BungeeCord API 1.21. Ak potrebuješ sprievodný plugin na backend, požiadaj oň ako o samostatný projekt Spigot/Paper.

Vyskúšaj teraz zatiaľ nespúšťa proxy servery, preto proxy plugin otestuj vo vlastnej sieti alebo na lokálnej proxy s jedným backend serverom. Pozri aj generátor BungeeCord pluginov.

Otázky

Môže BungeeCord plugin meniť bloky alebo inventáre?

Nie, proxy rieši iba pripojenia a správy. Na hrateľnosť použi plugin na backend a plugin messages, ak musia oba spolupracovať.

Funguje to na Velocity?

Nie. Velocity má vlastné API a velocity-plugin.json. Ak používaš oboje, urob dva projekty.

Proxy plugin, alebo plugin na backend pre chat?

Proxy plugin, ak sa chat musí dostať k hráčom na každom serveri. Plugin na backend, ak chat zostáva na jednom serveri.

Vytvor plugin pre svoju sieť

Toto zadanie sa otvorí pripravené na odoslanie:

“Proxy plugin pre BungeeCord 1.21 s názvom NetUtils: /lobby pošle hráča na lobby server, /staffchat (alias /sc) pošle správu všetkým s netutils.staff na ktoromkoľvek serveri, /maintenance on|off zobrazí MOTD údržby a vyhodí hráčov bez netutils.bypass, prepnutia servera členmi tímu ohlásené v chate tímu, názvy serverov, MOTD a správy v config.yml.”

Vygeneruj to v Codexe
Ako vytvoriť BungeeCord plugin pre svoju sieť | Codexe