Ú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-szel

Lépésről lépésre

  1. 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. 2.Állítsd be a projektet

    Egy Maven- vagy Gradle-projekt a bungeecord-api függőséggel provided scope-ban. Futásidőben a proxy biztosítja.

  3. 3.Írd meg a főosztályt

    Egy osztály, amely a net.md_5.bungee.api.plugin.Plugin osztályt bővíti, onEnable() metódussal, amely a getProxy().getPluginManager() segítségével regisztrálja a parancsokat és a figyelőket.

  4. 4.Írd le a bungee.yml-ben

    name, version, main és author. A BungeeCord a plugin.yml fájlt is beolvassa, de a bungee.yml elkerüli a Spigot-pluginokkal való összekeverést. A parancsokat kódban regisztrálod, nem a fájlban.

  5. 5.Írj parancsokat és listenereket

    A parancsok a Command osztályt bővítik; a figyelők a Listener interfészt valósítják meg @EventHandler metódusokkal olyan eseményekhez, mint a PostLoginEvent vagy a ServerSwitchEvent.

  6. 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. 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ényMikor fut leTipikus használat
ProxyPingEventEgy kliens frissíti a szerverlistátMOTD, játékosszám, karbantartási üzenet
PostLoginEventEgy játékos csatlakozott a proxyhozBelépési üzenetek, játékosadatok betöltése
ServerConnectEventEgy játékos épp csatlakozni készül egy szerverhezJátékosok lobbyba küldése, szerverek tiltása
ServerSwitchEventEgy játékos átment egy másik szerverreHálózati szintű „szerverre lépett” üzenetek
PlayerDisconnectEventEgy játékos kilépett a hálózatbólAdatok mentése, értesítések a staffnak
ChatEventEgy játékos chatüzenetet vagy parancsot küldHálózati chat, szűrők, staffchat

A hálózat helyes beállítása

  • Kapcsold be az ip_forward beállítást a proxy config.yml fájljában, és a bungeecord: true beállítást minden Spigot- vagy Paper-szerver spigot.yml fá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
Hogyan készíts BungeeCord plugint a hálózatodhoz | Codexe