Ръководство

Как да направиш BungeeCord плъгин

Обновено на 18 октомври 2026 г.

BungeeCord плъгинът работи на проксито пред твоите сървъри, а не на игрови сървър. Той вижда как играчите се свързват, сменят сървъри и излизат, затова е правилното място за общ чат в мрежата, инструменти за екипа, режим на поддръжка, MOTD и прехвърляне на играчи между сървъри. Няма светове и блокове: геймплеят е работа на плъгин на backend сървърите.

Смени командите според своята мрежа.

Генерирай това с Codexe

Стъпка по стъпка

  1. 1.Потвърди какво прокси ползваш

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

  2. 2.Подготви проекта

    Maven или Gradle проект със зависимостта bungeecord-api с обхват provided. Проксито я осигурява по време на работа.

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

    Клас, който наследява net.md_5.bungee.api.plugin.Plugin, с onEnable(), в който се регистрират командите и слушателите чрез getProxy().getPluginManager().

  4. 4.Опиши го в bungee.yml

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

  5. 5.Напиши команди и listeners

    Командите наследяват Command; слушателите имплементират Listener с методи с @EventHandler за събития като PostLoginEvent или ServerSwitchEvent.

  6. 6.Говори с backend сървърите, ако е нужно

    Проксито не вижда инвентари и светове. За това малък придружаващ плъгин на всеки backend сървър обменя plugin messages с прокси плъгина.

  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 messages пътуват само докато има играч, свързан с този 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 messages, ако двата трябва да работят заедно.

Работи ли на 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