Jak zrobić plugin BungeeCord

Krok po kroku

1. 1.Potwierdź, jakiego proxy używasz

   BungeeCord (lub fork, taki jak Waterfall) i Velocity to różne API. Plugin BungeeCord nie działa na Velocity i odwrotnie.

2. 2.Przygotuj projekt

   Projekt Maven lub Gradle z zależnością bungeecord-api w zakresie provided. Proxy dostarcza ją w czasie działania.

3. 3.Napisz klasę główną

   Klasa rozszerzająca net.md_5.bungee.api.plugin.Plugin, z onEnable() rejestrującym komendy i listenery przez getProxy().getPluginManager().

4. 4.Opisz go w bungee.yml

   name, version, main i author. BungeeCord czyta też plugin.yml, ale bungee.yml pozwala uniknąć pomyłek z pluginami Spigot. Komendy rejestruje się w kodzie, a nie w pliku.

5. 5.Napisz komendy i listenery

   Komendy rozszerzają Command; listenery implementują Listener z metodami @EventHandler dla zdarzeń takich jak PostLoginEvent czy ServerSwitchEvent.

6. 6.W razie potrzeby komunikuj się z serwerami za proxy

   Proxy nie widzi ekwipunków ani światów. Do tego mały plugin towarzyszący na każdym serwerze za proxy wymienia plugin messages z pluginem proxy.

7. 7.Zainstaluj go na proxy

   Wrzuć plik .jar do folderu plugins/ proxy i zrestartuj proxy, a nie serwery za nim.

Przydatne zdarzenia proxy

Poprawna konfiguracja sieci

• Włącz ip_forward w config.yml proxy i bungeecord: true w spigot.yml każdego serwera Spigot lub Paper, żeby nazwy graczy i UUID były przekazywane dalej.
• Ustaw serwery za proxy na online-mode=false i upewnij się, że nie da się się z nimi połączyć bezpośrednio z internetu, tylko przez proxy.
• Plugin messages przechodzą tylko wtedy, gdy jakiś gracz jest połączony z danym serwerem za proxy, więc wiadomość do pustego serwera nie zostanie dostarczona.

Przykładowy opis

„Plugin proxy na BungeeCord 1.21 o nazwie NetUtils. /lobby wysyła gracza na serwer lobby. /staffchat <message> (alias /sc) wysyła wiadomość do wszystkich z netutils.staff na dowolnym serwerze. /maintenance on|off pokazuje MOTD konserwacji i wyrzuca graczy bez netutils.bypass. Wiadomość na czacie administracji, gdy członek administracji zmienia serwer. Nazwy serwerów, MOTD i wiadomości w config.yml.”

Z Codexe

Wybierz typ BungeeCord/Velocity i wpisz, jakiego proxy używasz, bo to różne API. Codexe kompiluje plugin przez Maven i sprawdza, czy plik .jar ma właściwy deskryptor, zanim będzie gotowy; bez wersji w prośbie używane jest API BungeeCord 1.21. Jeśli potrzebujesz pluginu towarzyszącego na serwerach za proxy, poproś o niego jako osobny projekt Spigot/Paper.

Wypróbuj teraz nie uruchamia jeszcze serwerów proxy, więc przetestuj plugin proxy w swojej sieci albo na lokalnym proxy z jednym serwerem za nim. Zobacz też generator pluginów BungeeCord.

Pytania