Guide

Slik lager du et BungeeCord-plugin

Oppdatert 18. oktober 2026

Et BungeeCord-plugin kjører på proxyen som står foran serverne dine, ikke på en spillserver. Det ser spillere koble til, bytte server og forlate, så det er riktig sted for chat i hele nettverket, stabverktøy, vedlikeholdsmodus, MOTD og sending av spillere mellom servere. Det har ingen verdener eller blokker: spillmekanikk hører hjemme i et plugin på backend-serverne.

Tilpass kommandoene til nettverket ditt.

Generer dette med Codexe

Steg for steg

  1. 1.Bekreft hvilken proxy du kjører

    BungeeCord (eller en fork som Waterfall) og Velocity er ulike API-er. Et BungeeCord-plugin kjører ikke på Velocity, og omvendt.

  2. 2.Sett opp prosjektet

    Et Maven- eller Gradle-prosjekt med avhengigheten bungeecord-api i scopet provided. Proxyen leverer den under kjøring.

  3. 3.Skriv hovedklassen

    En klasse som utvider net.md_5.bungee.api.plugin.Plugin, med onEnable() for å registrere kommandoer og lyttere via getProxy().getPluginManager().

  4. 4.Beskriv det i bungee.yml

    name, version, main og author. BungeeCord leser også plugin.yml, men bungee.yml unngår forveksling med Spigot-plugins. Kommandoer registreres i koden, ikke i filen.

  5. 5.Skriv kommandoer og lyttere

    Kommandoer utvider Command; lyttere implementerer Listener med @EventHandler-metoder for eventer som PostLoginEvent eller ServerSwitchEvent.

  6. 6.Snakk med backend-serverne ved behov

    Proxyen kan ikke se inventarer eller verdener. Til det utveksler et lite hjelpeplugin på hver backend-server plugin messages med proxypluginet.

  7. 7.Installer det på proxyen

    Legg .jar-filen i proxyens plugins/-mappe og start proxyen på nytt, ikke backend-serverne.

Nyttige proxyeventer

HendelseNår den utløsesTypisk bruk
ProxyPingEventEn klient oppdaterer serverlistenMOTD, antall spillere, vedlikeholdsmelding
PostLoginEventEn spiller har koblet til proxyenVelkomstmeldinger, lasting av spillerdata
ServerConnectEventEn spiller er i ferd med å koble til en serverSende spillere til en lobby, blokkere servere
ServerSwitchEventEn spiller har flyttet til en annen serverMeldinger om «koblet til server» i hele nettverket
PlayerDisconnectEventEn spiller har forlatt nettverketLagre data, varsler til staben
ChatEventEn spiller sender en chatmelding eller kommandoNettverkschat, filtre, stabschat

Sette opp nettverket riktig

  • Slå på ip_forward i proxyens config.yml og bungeecord: true i spigot.yml på hver Spigot- eller Paper-server, så spillernavn og UUID-er sendes videre.
  • Sett backend-serverne til online-mode=false og sørg for at de ikke kan nås direkte fra internett, bare via proxyen.
  • Plugin messages sendes bare mens en spiller er koblet til den backend-serveren, så en melding til en tom server blir ikke levert.

Eksempelbeskrivelse

«Et BungeeCord 1.21-proxyplugin kalt NetUtils. /lobby sender spilleren til lobbyserveren. /staffchat <message> (alias /sc) sender en melding til alle med netutils.staff på hvilken som helst server. /maintenance on|off viser en vedlikeholds-MOTD og kaster ut spillere uten netutils.bypass. En melding i stabschatten når et stabsmedlem bytter server. Servernavn, MOTD og meldinger i config.yml.»

Med Codexe

Velg typen BungeeCord/Velocity og si hvilken proxy du kjører, siden de er ulike API-er. Codexe kompilerer pluginet med Maven og sjekker at .jar-filen har riktig beskrivelsesfil før det er Klar; uten en versjon i forespørselen brukes BungeeCord-API 1.21. Trenger du et hjelpeplugin på backend, ber du om det som et eget Spigot/Paper-prosjekt.

Prøv nå kjører ikke proxyservere ennå, så test proxypluginet på ditt eget nettverk eller en lokal proxy med én backend-server. Se også BungeeCord-plugingeneratoren.

Spørsmål

Kan et BungeeCord-plugin endre blokker eller inventarer?

Nei, proxyen håndterer bare tilkoblinger og meldinger. Bruk et backend-plugin til spillmekanikk, og plugin messages hvis de to må samarbeide.

Fungerer det på Velocity?

Nei. Velocity har sitt eget API og velocity-plugin.json. Kjører du begge, lager du to prosjekter.

Proxyplugin eller backend-plugin for chat?

Et proxyplugin hvis chatten skal nå spillere på alle servere. Et backend-plugin hvis chatten holder seg på én server.

Lag et plugin til nettverket ditt

Denne prompten åpnes klar til å sendes:

“Et BungeeCord 1.21-proxyplugin kalt NetUtils: /lobby sender spilleren til lobbyserveren, /staffchat (alias /sc) sender en melding til alle med netutils.staff på hvilken som helst server, /maintenance on|off viser en vedlikeholds-MOTD og kaster ut spillere uten netutils.bypass, serverbytter fra staben kunngjøres i stabschatten, servernavn, MOTD og meldinger i config.yml.”

Generer dette med Codexe
Slik lager du et BungeeCord-plugin til nettverket ditt | Codexe