Водич

Како направити BungeeCord плагин

Ажурирано 18. октобар 2026.

BungeeCord плагин ради на проксију који стоји испред твојих сервера, а не на серверу за игру. Види кад се играчи повежу, пређу на други сервер и изађу, па је право место за чет на нивоу мреже, алате за особље, режим одржавања, MOTD и слање играча између сервера. Нема светове ни блокове: игра припада плагину на backend серверима.

Прилагоди команде својој мрежи.

Генериши ово уз Codexe

Корак по корак

  1. 1.Провери који прокси користиш

    BungeeCord (или fork као што је Waterfall) и Velocity су различити API-ји. BungeeCord плагин не ради на Velocity-ју, и обрнуто.

  2. 2.Подеси пројекат

    Maven или Gradle пројекат са зависношћу bungeecord-api у provided scope-у. Прокси је обезбеђује у току рада.

  3. 3.Напиши главну класу

    Класа која наслеђује net.md_5.bungee.api.plugin.Plugin, са onEnable() за регистрацију команди и listener-а преко getProxy().getPluginManager().

  4. 4.Опиши га у bungee.yml

    name, version, main и author. BungeeCord чита и plugin.yml, али bungee.yml спречава забуну са Spigot плагинима. Команде се региструју у коду, а не у фајлу.

  5. 5.Напиши команде и listener-е

    Команде наслеђују Command; listener-и имплементирају Listener са @EventHandler методама за догађаје као што су PostLoginEvent или ServerSwitchEvent.

  6. 6.Комуницирај са backend серверима ако треба

    Прокси не види инвентаре ни светове. За то мали пратећи плагин на сваком backend серверу размењује plugin поруке са прокси плагином.

  7. 7.Инсталирај га на прокси

    Стави .jar у фолдер plugins/ проксија и рестартуј прокси, а не backend сервере.

Корисни прокси догађаји

ДогађајКад се окидаУобичајена употреба
ProxyPingEventКлијент освежава листу сервераMOTD, број играча, порука о одржавању
PostLoginEventИграч је ушао на проксиПоруке при уласку, учитавање података играча
ServerConnectEventИграч само што се није повезао на серверСлање играча у лоби, блокирање сервера
ServerSwitchEventИграч је прешао на други серверПоруке „ушао на сервер“ на нивоу мреже
PlayerDisconnectEventИграч је напустио мрежуЧување података, обавештења за особље
ChatEventИграч шаље поруку у чет или командуМрежни чет, филтери, чет за особље

Исправно подешавање мреже

  • Укључи ip_forward у config.yml проксија и bungeecord: true у spigot.yml сваког Spigot или Paper сервера, да би се имена играча и UUID-ови прослеђивали.
  • Постави backend сервере на online-mode=false и побрини се да не могу да се досегну директно са интернета, већ само преко проксија.
  • Plugin поруке путују само док је играч повезан на тај backend сервер, па порука празном серверу не стиже.

Пример описа

„BungeeCord 1.21 прокси плагин под називом NetUtils. /lobby шаље играча на лоби сервер. /staffchat <message> (алијас /sc) шаље поруку свима са netutils.staff на било ком серверу. /maintenance on|off приказује MOTD за одржавање и избацује играче без netutils.bypass. Порука у чету особља кад члан особља пређе на други сервер. Имена сервера, MOTD и поруке у config.yml.“

Уз Codexe

Изабери тип BungeeCord/Velocity и наведи који прокси користиш, јер су то различити API-ји. Codexe компајлира плагин уз Maven и проверава да .jar има прави дескриптор пре него што буде Спремно; без верзије у захтеву користи се BungeeCord API 1.21. Ако ти треба пратећи плагин за backend, затражи га као посебан Spigot/Paper пројекат.

„Испробај одмах“ још не покреће прокси сервере, па тестирај прокси плагин на својој мрежи или на локалном проксију са једним backend сервером. Погледај и генератор BungeeCord плагина.

Питања

Може ли BungeeCord плагин да мења блокове или инвентаре?

Не, прокси обрађује само везе и поруке. За игру користи backend плагин, а plugin поруке ако њих двоје морају да раде заједно.

Да ли ради на Velocity-ју?

Не. Velocity има сопствени API и velocity-plugin.json. Ако користиш оба, направи два пројекта.

Прокси плагин или backend плагин за чет?

Прокси плагин ако чет мора да стигне до играча на сваком серверу. Backend плагин ако чет остаје на једном серверу.

Направи плагин за своју мрежу

Овај промпт се отвара спреман за слање:

“BungeeCord 1.21 прокси плагин под називом NetUtils: /lobby шаље играча на лоби сервер, /staffchat (алијас /sc) шаље поруку свима са netutils.staff на било ком серверу, /maintenance on|off приказује MOTD за одржавање и избацује играче без netutils.bypass, прелазак особља се објављује у чету особља, имена сервера, MOTD и поруке у config.yml.”

Генериши ово уз Codexe
Како направити BungeeCord плагин за своју мрежу | Codexe