Servere / Hosting

Serveropsætning

Vælg én opsætning: Paper alene, Velocity med Paper eller Waterfall med Paper. Proxy-eksemplerne bruger én maskine med offentlig port 25565 og en Paper-backend på 127.0.0.1:25566.

Dette er selvstændige netværk med direkte spilleradgang. Ved forbindelse fra MineClub til din Velocity- eller Waterfall-proxy skal du bruge HAProxy og MineClubs sessionsadresse som beskrevet i Velocity via MineClub eller Waterfall via MineClub. Indstillingerne for forbindelsen videre til Paper findes herunder.

Før du begynder

Du skal kunne redigere filer, køre Java og ændre netværksregler hos din udbyder. Brug separate mapper til Paper og proxyen. Tag backup af eksisterende serverfiler, stop processerne før ændringer, og ret de eksisterende nøgler i de genererede filer. Eksemplerne er udsnit, som skal flettes ind uden dublerede YAML-sektioner eller TOML-tabeller.

Kør i terminalen på servermaskinen:

java -version

Vælg Java efter den konkrete serverudgave. PaperMCs Java-oversigt anbefaler Java 21 til Paper 1.20–1.21.11 og Java 25 til 26.1+. Den aktuelle Velocity-guide kræver Java 25. Ældre udgaver kan have andre krav; kontrollér udgaven før installation.

Startup-kommandoerne virker i terminalen på Windows, Linux og macOS. Kør dem fra den relevante mappe, brug de angivne JAR-navne eller tilpas filnavnet, og tilpas hukommelsen til din hostingplan.

Paper alene

Hent en passende serverudgave fra Papers officielle downloads, læg den i Paper-mappen, og omdøb filen til paper.jar.
Kør følgende kommando fra Paper-mappen for at generere serverfilerne.

Terminal — Paper-maskinen, Paper-mappen:

java -Xms1G -Xmx2G -jar paper.jar --nogui

Læs Minecrafts EULA via linket i eula.txt. Hvis du accepterer den, ret eula=false til eula=true. Start igen med samme kommando, lad serveren generere verdenen, og skriv stop i konsollen før konfigurationsændringer.

Paper-maskinen — server.properties:

server-ip=
server-port=25565
online-mode=true

Behold proxy-understøttelse deaktiveret ved direkte spilleradgang: settings.bungeecord: false i spigot.yml og proxies.velocity.enabled: false i config/paper-global.yml. Se nedenfor for den ældre Paper-fil.

Start Paper igen. Tillad TCP-port 25565 i firewall og eventuelt routerens portvideresendelse. Brug din udbyders tildelte port, hvis den er en anden. Tilslut med Minecraft Java Edition til serverens offentlige adresse; lokalt på samme maskine kan du bruge localhost:25565.

Kontrol: Du skal kunne logge ind med din almindelige Minecraft-konto og se det forventede navn og skin. Paper autentificerer selv spillerne med online-mode=true.

Velocity med Paper

Forbindelsen er spiller → Velocity:25565 → Paper:25566. Brug modern forwarding til en kompatibel Paper-udgave. Stop Paper fra det foregående afsnit først, så port 25565 bliver ledig.

1. Opret proxyen

Hent Velocity til sin egen mappe som velocity.jar. Kør kommandoen, og stop derefter proxyen med end, når konfigurationen er oprettet.

Terminal — proxy-maskinen, Velocity-mappen:

java -Xms512M -Xmx1G -jar velocity.jar

Proxy-maskinen — velocity.toml: Ret rodindstillingerne før den første tabel. Erstat eksempelserverne i [servers] med din lobby, og fjern eller tilpas genererede [forced-hosts]-henvisninger til servere, du ikke bruger.

bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "127.0.0.1:25566"
try = ["lobby"]

2. Konfigurér Paper-backenden

Installér og generér Paper-filerne som i Paper-afsnittet, hvis du ikke allerede har en server. Stop den før ændringer.

Paper-maskinen — server.properties:

server-ip=127.0.0.1
server-port=25566
online-mode=false

Paper-maskinen — spigot.yml:

settings:
  bungeecord: false

Paper-maskinen — config/paper-global.yml: Erstat pladsholderen med hele indholdet af proxyens genererede forwarding.secret. Behold nøglen privat.

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "INDSAET_DIN_VELOCITY_NOEGLE"

Proxyen autentificerer spilleren; derfor er online-mode slået fra i backendens server.properties, men til i proxyen og i Papers Velocity-indstillinger.

Ældre Paper: På 1.18.2 og ældre ligger disse indstillinger i paper.yml i stedet. Brug kun dette udsnit, hvis din udgave bruger den gamle fil:

settings:
  velocity-support:
    enabled: true
    online-mode: true
    secret: "INDSAET_DIN_VELOCITY_NOEGLE"

Modern forwarding kræver understøttelse i serverudgaven og virker ikke med Minecraft under 1.13. Se PaperMCs forwarding-guide for kompatibilitet og de officielle filindstillinger.

3. Start og test

Start først Paper, derefter Velocity med kommandoerne ovenfor. Tilslut til proxyens offentlige adresse på port 25565. Kontrollér login, skin og spillerens UUID i backendens log eller et administrationsplugin mod kontoens normale online-UUID. Test også backend-afskærmningen.

Waterfall med Paper

PaperMC betegner Waterfall som udfaset. Brug Velocity til nye netværk. Dette afsnit er til eksisterende Waterfall-installationer og kræver en Paper- og klientversion, som din Waterfall-build understøtter.

1. Opret eller klargør proxyen

Brug Waterfalls officielle downloadside og kontrollér Java-kravet for din build i installationsguiden. Læg waterfall.jar i en separat mappe. Stop andre processer på port 25565, kør kommandoen, og skriv end, når filerne er genereret.

Terminal — proxy-maskinen, Waterfall-mappen:

java -Xms512M -Xmx512M -jar waterfall.jar

Proxy-maskinen — config.yml: Ret den eksisterende listener og serverliste; bevar øvrige indstillinger på din listener.

online_mode: true
ip_forward: true
servers:
  lobby:
    address: 127.0.0.1:25566
    motd: 'Min lobby'
    restricted: false
listeners:
  - host: 0.0.0.0:25565
    priorities:
      - lobby
    force_default_server: true
    forced_hosts: {}
    proxy_protocol: false

Her modtager Waterfall almindelige klientforbindelser. proxy_protocol er derfor slået fra. Servernavnet i priorities skal findes under servers. Se BungeeCords konfigurationsreference for de fælles indstillinger.

2. Konfigurér Paper-backenden

Generér Paper-filer og acceptér EULA som i Paper-afsnittet. Stop Paper, og brug følgende backend-indstillinger.

Paper-maskinen — server.properties:

server-ip=127.0.0.1
server-port=25566
online-mode=false

Paper-maskinen — spigot.yml:

settings:
  bungeecord: true

Paper-maskinen — config/paper-global.yml:

proxies:
  bungee-cord:
    online-mode: true
  velocity:
    enabled: false

På Paper 1.18.2 og ældre bruges settings.bungee-online-mode: true og settings.velocity-support.enabled: false i paper.yml. Proxyen skal stadig bruge online_mode: true.

3. Start og test

Start Paper og derefter Waterfall. Tilslut til proxyens offentlige adresse på port 25565, og kontrollér, at du lander på lobbyen med dit rigtige navn, skin og online-UUID. Legacy-forwarding har ingen indbygget hemmelig nøgle: gennemfør derfor også netværkskontrollen nedenfor.

Backend-adgang og separate maskiner

Ved proxy-opsætninger åbner du kun proxyens TCP-port 25565 for spillere. Eksemplernes server-ip=127.0.0.1 gør Paper utilgængelig uden for samme maskines netværksmiljø. Fra en anden maskine skal et direkte forbindelsesforsøg til backendens offentlige adresse på port 25566 fejle, mens forbindelsen til proxyen virker.

På separate maskiner eller i separate containere peger 127.0.0.1 ikke på Paper fra proxyen. Brug backendens private adresse i proxyens serverliste og bind Paper til den relevante lokale grænseflade. Begræns backend-porten med firewall til proxyens kildeadresse, også for IPv6. Tillad ikke almindelige spillere direkte adgang til en backend med online-mode=false.

Hvis din hostingudbyder ikke lader dig afskærme en legacy-backend, skal adgangen sikres før åbning, eksempelvis med BungeeGuard på proxy og backend. Se også PaperMCs vejledning om sikring af backend-servere.

Fejlfinding og sidste kontrol

Java-fejl ved start: Kontrollér java -version og kravet for hver JAR. Et hostingpanel kan bruge en anden Java-version end terminalen.
Address already in use: To processer forsøger at bruge samme port. Proxyen bruger 25565, Paper-backenden 25566; kør kun én af de to proxyer.
Connection refused eller timeout: Start Paper, kontrollér proxyens backend-adresse og port, og undersøg firewall eller container-netværk.
Forwarding- eller nøglefejl: Match modern forwarding og secret på begge sider for Velocity. Match ip_forward og settings.bungeecord for Waterfall. Genstart begge processer efter ændringer.
Forkert skin eller UUID: Kontrollér proxyens online-mode og hele forwarding-opsætningen, før spillere fortsætter. Forkerte UUID'er kan give andre spillerdata og rettigheder.

Opsætningen er klar, når login via den tilsigtede adresse virker, backendens spilleridentitet er korrekt, og direkte ekstern backend-adgang er blokeret i proxy-opsætninger. Ved tilknytning til MineClub fortsætter du med registrering og godkendelse.