Útmutató
Hogyan készíts BungeeCord plugint
Frissítve: 2026. október 18.
Egy BungeeCord plugin a szervereid előtt álló proxyn fut, nem egy játékszerveren. Látja, ahogy a játékosok csatlakoznak, szervert váltanak és kilépnek, így ez a megfelelő hely a hálózati chathez, a staffeszközökhöz, a karbantartási módhoz, a MOTD-hoz és a játékosok szerverek közötti küldéséhez. Nincsenek világai vagy blokkjai: a játékmenet a backend szervereken futó pluginokba tartozik.
Írd át a parancsokat a hálózatodra.
Generáld ezt a Codexe-szelLépésről lépésre
1.Ellenőrizd, melyik proxyt futtatod
A BungeeCord (vagy egy forkja, például a Waterfall) és a Velocity különböző API-k. Egy BungeeCord plugin nem fut Velocityn, és fordítva sem.
2.Állítsd be a projektet
Egy Maven- vagy Gradle-projekt a
bungeecord-apifüggőséggelprovidedscope-ban. Futásidőben a proxy biztosítja.3.Írd meg a főosztályt
Egy osztály, amely a
net.md_5.bungee.api.plugin.Pluginosztályt bővíti,onEnable()metódussal, amely agetProxy().getPluginManager()segítségével regisztrálja a parancsokat és a figyelőket.4.Írd le a bungee.yml-ben
name,version,mainésauthor. A BungeeCord aplugin.ymlfájlt is beolvassa, de abungee.ymlelkerüli a Spigot-pluginokkal való összekeverést. A parancsokat kódban regisztrálod, nem a fájlban.5.Írj parancsokat és listenereket
A parancsok a
Commandosztályt bővítik; a figyelők aListenerinterfészt valósítják meg@EventHandlermetódusokkal olyan eseményekhez, mint aPostLoginEventvagy aServerSwitchEvent.6.Kommunikálj a backend szerverekkel, ha kell
A proxy nem látja az inventorykat és a világokat. Ehhez egy kis kísérőplugin kell minden backend szerveren, amely plugin messageket cserél a proxypluginnal.
7.Telepítsd a proxyra
Tedd a .jar fájlt a proxy
plugins/mappájába, és a proxyt indítsd újra, ne a backend szervereket.
Hasznos proxyesemények
| Esemény | Mikor fut le | Tipikus használat |
|---|---|---|
ProxyPingEvent | Egy kliens frissíti a szerverlistát | MOTD, játékosszám, karbantartási üzenet |
PostLoginEvent | Egy játékos csatlakozott a proxyhoz | Belépési üzenetek, játékosadatok betöltése |
ServerConnectEvent | Egy játékos épp csatlakozni készül egy szerverhez | Játékosok lobbyba küldése, szerverek tiltása |
ServerSwitchEvent | Egy játékos átment egy másik szerverre | Hálózati szintű „szerverre lépett” üzenetek |
PlayerDisconnectEvent | Egy játékos kilépett a hálózatból | Adatok mentése, értesítések a staffnak |
ChatEvent | Egy játékos chatüzenetet vagy parancsot küld | Hálózati chat, szűrők, staffchat |
A hálózat helyes beállítása
- Kapcsold be az
ip_forwardbeállítást a proxyconfig.ymlfájljában, és abungeecord: truebeállítást minden Spigot- vagy Paper-szerverspigot.ymlfájljában, hogy a játékosnevek és UUID-k továbbítódjanak. - Állítsd a backend szervereket
online-mode=falseértékre, és győződj meg róla, hogy közvetlenül az internetről nem érhetők el, csak a proxyn keresztül. - A plugin messagek csak akkor jutnak át, amikor egy játékos csatlakozva van az adott backend szerverhez, így egy üres szervernek küldött üzenet nem érkezik meg.
Példa leírás
„Egy BungeeCord 1.21 proxyplugin NetUtils néven. A /lobby a lobbyszerverre küldi a játékost. A /staffchat <message> (alias /sc) üzenetet küld mindenkinek, akinek netutils.staff joga van, bármelyik szerveren. A /maintenance on|off karbantartási MOTD-t mutat, és kirúgja a netutils.bypass jog nélküli játékosokat. Belépési üzenet a staffchatben, amikor egy staff tag szervert vált. Szervernevek, MOTD és üzenetek a config.yml-ben.”
A Codexe-szel
Válaszd a BungeeCord/Velocity típust, és írd meg, melyik proxyt futtatod, mert különböző API-k. A Codexe Mavennel fordítja le a plugint, és ellenőrzi, hogy a .jar a megfelelő leíróval rendelkezik-e, mielőtt Kész lenne; ha a kérésben nincs verzió, a BungeeCord API 1.21 kerül használatra. Ha backend kísérőpluginra van szükséged, kérd külön Spigot/Paper-projektként.
A Próbáld ki most még nem futtat proxyszervereket, ezért a proxyplugint a saját hálózatodon vagy egy helyi proxyn teszteld egy backend szerverrel. Lásd még: BungeeCord-plugingenerátor.
Kérdések
Módosíthat egy BungeeCord plugin blokkokat vagy inventorykat?
Nem, a proxy csak kapcsolatokat és üzeneteket kezel. A játékmenethez backend plugint használj, és plugin messageket, ha a kettőnek együtt kell működnie.
Működik Velocityn?
Nem. A Velocitynek saját API-ja és velocity-plugin.json fájlja van. Ha mindkettőt futtatod, készíts két projektet.
Proxyplugin vagy backend plugin a chathez?
Proxyplugin, ha a chatnek minden szerveren el kell érnie a játékosokat. Backend plugin, ha a chat egy szerveren marad.
Készíts plugint a hálózatodhoz
Ez a prompt küldésre készen nyílik meg:
“Egy BungeeCord 1.21 proxyplugin NetUtils néven: a /lobby a lobbyszerverre küldi a játékost, a /staffchat (alias /sc) üzenetet küld mindenkinek, akinek netutils.staff joga van, bármelyik szerveren, a /maintenance on|off karbantartási MOTD-t mutat, és kirúgja a netutils.bypass jog nélküli játékosokat, a staff szerverváltásai a staffchatben, szervernevek, MOTD és üzenetek a config.yml-ben.”
Generáld ezt a Codexe-szel