Як створити плагін BungeeCord

Крок за кроком

1. 1.Уточніть, який у вас проксі

   BungeeCord (або форк, як-от 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.Напишіть команди й слухачі

   Команди розширюють Command; слухачі реалізують Listener з методами @EventHandler для подій, як-от PostLoginEvent або ServerSwitchEvent.

6. 6.За потреби обмінюйтеся даними із серверами за проксі

   Проксі не бачить інвентарів і світів. Для цього невеликий плагін-компаньйон на кожному сервері за проксі обмінюється plugin messages із проксі-плагіном.

7. 7.Встановіть його на проксі

   Покладіть .jar у теку plugins/ проксі й перезапустіть проксі, а не сервери за ним.

Корисні події проксі

Правильне налаштування мережі

• Увімкніть ip_forward у config.yml проксі й bungeecord: true у spigot.yml кожного сервера Spigot або Paper, щоб імена гравців і UUID передавалися далі.
• Встановіть серверам за проксі online-mode=false і переконайтеся, що до них не можна підключитися напряму з інтернету, лише через проксі.
• Plugin messages передаються лише тоді, коли до цього сервера за проксі підключено гравця, тож повідомлення на порожній сервер не доставляється.

Приклад опису

«Проксі-плагін для 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 правильний дескриптор, перш ніж проєкт отримає статус «Готово»; якщо версію в запиті не вказано, використовується API BungeeCord 1.21. Якщо потрібен компаньйон для серверів за проксі, попросіть його окремим проєктом Spigot/Paper.

«Спробувати зараз» поки не запускає проксі-сервери, тож тестуйте проксі-плагін у своїй мережі або на локальному проксі з одним сервером за ним. Див. також генератор плагінів BungeeCord.

Запитання