Servere / MineClub

Eksterne servere

En ekstern server kører hos dig eller din hostingudbyder og registreres på MineClub. Du står selv for serverfiler, opdateringer, netværk og start/stop.

Mangler du selve serveren? Se opsætning af Paper, Velocity og Waterfall. Den guide beskriver selvstændige servere og netværk; en forbindelse gennem MineClub kræver indstillingerne her.

1. Opret registreringen

Log ind på MineClub med den Minecraft-konto, der skal eje serveren. Kør kommandoen i spillet med dit ønskede navn:

/sm external create MinServer

Navnet skal være ledigt og bestå af 3–16 bogstaver. Danske bogstaver er tilladt; tal, mellemrum og bindestreger er ikke. Registreringen opretter ikke en server hos en hostingudbyder.

2. Gem forbindelsen i panelet eller i spillet

På hjemmesiden

Åbn MineClub-panelet, vælg ejerens Minecraft-konto og den eksterne server, og åbn Indstillinger.
Under Forbindelse angiver du serverens IPv4- eller IPv6-adresse og port. Brug en IP-adresse uden domænenavn, protokol eller port i IP-feltet. Porten skal være et heltal fra 1 til 65535.
Vælg den forwarding-protokol, din server modtager, og angiv den Minecraft-version, serveren faktisk kører.
Når serveren kører hos din udbyder, og du er klar til at teste forbindelsen, vælger du Online under Status på Mineclub.
Tryk Gem indstillinger, og konfigurér forwarding på din server som beskrevet nedenfor.

I spillet

IP-adresse og port kan også gemmes med /sm set. Kommandoerne ændrer din valgte primære server, som skal være en ekstern server. Vælg først den rigtige server med /sm changeserver og brug tab-fuldførelse til servernavnet.

/sm changeserver <servernavn>
/sm set externalIp <IP-adresse>
/sm set externalPort <port>

Erstat pladsholderne med dine egne værdier, eksempelvis din servers IP-adresse og port 25565. Brug mellemrum efter set og stav indstillingerne externalIp og externalPort som vist. Vent på bekræftelsen af servervalget, før du ændrer forbindelsen.

Ændringerne gemmes direkte; IP eller port ændret i spillet nulstiller også godkendelsen til Kladde. Fortsæt derefter med forwarding og godkendelse nedenfor.

Når serveren er startet hos din udbyder og klar til test, sætter du den valgte eksterne server til Online med:

/sm set online true

Vil du markere den som Offline igen, bruger du /sm set online false. Kommandoen hedder online og tager true eller false.

Adressen skal kunne nås fra MineClub. Brug ikke 127.0.0.1 som ekstern adresse: den peger tilbage på den maskine, der opretter forbindelsen. Tillad MineClubs forbindelser i din udbyders netværksregler; få de aktuelle kildeadresser fra MineClub, hvis du skal oprette en tilladelsesliste.

Husk firewall før test og åbning: Blokér indgående TCP-trafik fra internettet til den eksterne servers IP-adresse og port, og tillad kun MineClubs betroede kildeadresser på denne port. Det forhindrer direkte forbindelser uden om MineClub. Få de aktuelle adresser fra MineClub, og anvend reglerne for både IPv4 og IPv6, hvis begge er tilgængelige.
Det er indgående trafik udefra, der skal begrænses. Din Velocity- eller Waterfall-proxy skal stadig kunne lave udgående HTTPS-forbindelser til api.mineclub.dk på TCP-port 443 til login-kontrol. Test, at forbindelsen gennem MineClub virker, og at direkte adgang til serverens IP og port fra en anden internetforbindelse er blokeret.

Minecraft-version ændrer registreringen, men installerer ikke en ny serverversion. Status på Mineclub skal være Online, for at du kan tilslutte med /server. Statusændringen starter eller stopper ikke serverprocessen; det gør du hos din udbyder.

3. Match forwarding og nøgle

Velocity og Waterfall som ekstern proxy kan kun forbindes til MineClub med HAProxy. Vælg HAProxy i panelet og angiv proxyens IP-adresse og lytteport. MODERN, LEGACY og BungeeGuard i panelet er til direkte forbindelse til en kompatibel backend, eksempelvis Paper; de bruges ikke på forbindelsen fra MineClub til din Velocity- eller Waterfall-proxy.

MODERN (Velocity): Til Paper med understøttelse af modern forwarding. Efter du gemmer, viser panelet en Forwarding-nøgle. Brug den som proxies.velocity.secret i Papers config/paper-global.yml.
LEGACY (BungeeCord): Serveren skal modtage BungeeCord-forwarding, eksempelvis med settings.bungeecord: true i Papers spigot.yml. Begræns backend-adgangen til den betroede proxy.
BungeeGuard: Kræver legacy-forwarding og BungeeGuard på modtagerserveren. Gem indstillingerne, og indsæt panelets BungeeGuard-token i pluginets tilladte tokens. Følg BungeeGuards installationsvejledning.
HAProxy: Vælg kun dette, hvis modtageren er konfigureret til PROXY-protokollen. Det er en særskilt protokol og kan ikke erstattes af en Velocity-nøgle eller BungeeCord-indstilling.

Ved direkte forbindelse fra MineClub til Paper med modern forwarding skal online-mode=false stå i server.properties, settings.bungeecord være false, og Papers Velocity-understøttelse være aktiveret. Paper skal bruge MineClubs nøgle, og forwarding-indstillingen for online-mode skal matche den autentificerende proxy. Se filernes placering i Paper-konfigurationen i Velocity-afsnittet.

Panelets nøgle tilhører forbindelsen fra MineClub. Et selvstændigt Velocity-netværk bruger sin egen forwarding.secret. Bland ikke de to nøgler, og del dem ikke i screenshots, chat eller offentlige konfigurationsfiler.

Hvis nøglefeltet beder dig gemme, trykker du Gem indstillinger for at få nøglen vist. Stop serveren før filændringer, og start den igen bagefter.

MineClub → Velocity → Paper

Stop Velocity, og tilføj MineClubs sessionsadresse som JVM-argument før -jar. Tilpas JAR-navnet til din installerede udgave:

java -Dmojang.sessionserver=https://api.mineclub.dk/v2/session/minecraft/hasJoined -jar velocity-4.1.2-SNAPSHOT-27.jar

På Velocity-proxyen — velocity.toml: Ret online-mode i roden og haproxy-protocol i den eksisterende [advanced]-sektion. Tilføj ikke en ekstra sektion, og brug ikke komma efter true.

online-mode = true

[advanced]
haproxy-protocol = true

Placeringen af HAProxy-indstillingen er beskrevet i Velocitys konfigurationsreference. Forbindelsen videre fra din Velocity til Paper bruger fortsat din egen forwarding-konfiguration, eksempelvis modern med proxyens egen forwarding.secret. Se Velocity → Paper.

MineClub → Waterfall → Paper

Waterfall bruger JVM-argumentet waterfall.auth.url. Adressen skal indeholde formatfelterne til brugernavn, server-ID og den valgfrie IP-parameter. Det fremgår af Waterfalls officielle auth-url-patch.

Terminal — Waterfall-proxyen: Stop proxyen, og start med følgende kommando. Tilpas JAR-navnet; behold anførselstegnene omkring JVM-argumentet, så shellen ikke fortolker &.

java "-Dwaterfall.auth.url=https://api.mineclub.dk/v2/session/minecraft/hasJoined?username=%s&serverId=%s%s" -jar waterfall.jar

De tre %s-felter erstattes af Waterfall. I en Windows .bat- eller .cmd-fil skal hvert procenttegn dobles, så URL-delen bliver ?username=%%s&serverId=%%s%%s. Brug almindelige %s i PowerShell og Linux/macOS-terminalen.

På Waterfall-proxyen — config.yml: Behold online_mode i roden, og aktivér proxy_protocol på den eksisterende listener, som MineClub forbinder til. Bevar dens øvrige indstillinger.

online_mode: true
listeners:
  - host: 0.0.0.0:25565
    proxy_protocol: true

proxy_protocol er en listener-indstilling i BungeeCord-konfigurationen, som Waterfall bygger på. ip_forward: true gælder den separate forbindelse videre til Paper og erstatter ikke proxy_protocol. Behold backend-opsætningen fra Waterfall → Paper.

HAProxy overfører forbindelsesoplysninger; sessionsadressen håndterer login-kontrollen. Begge dele skal være sat op. Begræns proxyens HAProxy-port til MineClubs betroede kildeadresser, og test ved at tilslutte gennem MineClub. En almindelig Minecraft-klient sender ikke den krævede PROXY-header direkte til denne port.

Genstart hele proxyprocessen efter ændring af JVM-argumenter eller konfiguration. Kontrollér derefter login, spillerens UUID og adgang til din Paper-backend gennem MineClub. Opskrifterne er baseret på konfiguration og kildekode; de er ikke en live-test af din konkrete proxy-build.

4. Test og send til godkendelse

Start serveren hos din udbyder, og sæt status til Online med /sm set online true eller via Indstillinger → Status på Mineclub → Online → Gem indstillinger på hjemmesiden. Det gælder også i testfasen.

Med en komplet IP-adresse og port kan ejeren teste adgang før godkendelse; staff med den relevante adgang kan også teste. Kontrollér forbindelse, spilleridentitet og serverlog, inden du sender serveren ind. En komplet adresse er ikke i sig selv bevis på, at serveren kan nås.

Online er ikke det samme som godkendt. Almindelige spillere kan begynde at tilslutte, når serveren både er Online, har en gyldig forbindelse og er godkendt (verified). Online-status alene åbner ikke en kladde eller afvist server for alle.

Gem alle ændringer, og tryk Send til godkendelse under Godkendelse i panelet. Du kan også sende den ind fra ejerens Minecraft-konto i spillet:

/sm external submit MinServer

Se dine eksterne serveres status og eventuelle begrundelse med:

/sm external

Kladde (draft): Konfigurér og test serveren, og send den til godkendelse.
Afventer godkendelse (pending): Serveren er indsendt. Du kan ikke indsende den igen, mens den afventer.
Godkendt (verified): Serveren kan være offentligt tilgængelig på MineClub, når ejer og forbindelse er gyldige. Den skal stadig være korrekt konfigureret og køre hos dig.
Afvist (rejected): Læs begrundelsen, ret problemet, gem og test. Vælg Send til godkendelse igen, eller brug submit-kommandoen.

Ændrer du IP-adresse eller port, nulstilles godkendelsen til Kladde. Test den nye forbindelse og indsend serveren igen. Det gælder også en allerede godkendt server.

Fejlfinding

Knappen er deaktiveret: Vælg ejerens Minecraft-konto, gem ændringerne og kontrollér IP/port. Kun kladder og afviste servere kan indsendes.
IP-adressen afvises: Brug en IPv4- eller IPv6-adresse, ikke et domænenavn. Skriv porten i det separate felt.
Forbindelsen fejler: Kontrollér serverprocessen, lytteporten, firewall og forwarding. Den viste Online-status starter ikke serveren.
Forkert nøgle eller forwarding-fejl: Match panelets protokol og nøgle med modtagerserveren, og genstart efter filændringer.
Ejeren kan tilslutte, men andre kan ikke: Kontrollér godkendelsesstatus. Ejerens testadgang betyder ikke, at serveren er offentligt godkendt.
Status er ændret under indsendelse: Opdatér panelet og læs den aktuelle status, før du prøver igen.

Ved fjernelse i panelet slettes registreringen fra MineClub. Serveren og dens filer hos din udbyder bliver ikke slettet.