Dokumentation.dk

Opsætning af Geyser (+ Floodgate)

Lad Minecraft Bedrock Edition-spillere forbinde til din Java Edition-server - på tværs af Xbox, PlayStation, Switch, mobil og Windows 10/11.

Krav

  • En kørende Minecraft-server (Paper, Spigot, Fabric, Forge, BungeeCord/Waterfall eller Velocity)
  • Java 17 eller nyere
  • En åben UDP-port til Bedrock-spillere (standard: 19132)
  • Server-adgang via SSH eller FTP til at placere plugin/mod-filer

Hvad er Geyser?

Geyser er en proxy/plugin der lader Minecraft: Bedrock Edition-spillere (Xbox, PlayStation, Switch, mobil og Windows 10/11) forbinde til en Java Edition-server - uden at de skal eje Java Edition.

Floodgate er et tilvalg der lader Bedrock-spillere logge ind uden at have en Java-konto, ved at autentificere dem direkte via Xbox Live. Hvis din server er i offline-mode eller du vil give Bedrock-spillere fuldt adgang uden Java-konto, skal du bruge Floodgate.

Trin 1 - Download Geyser

  1. Gå til https://geysermc.org/download
  2. Vælg den platform der passer til din server:

Vælg Geyser-Spigot (virker til begge)

  1. Gem .jar-filen

Trin 2 - Installér Geyser

  1. Placer den downloadede .jar-fil i serverens plugins-mappe
  2. Genstart serveren
  3. Geyser opretter automatisk mappen plugins/Geyser-Spigot/ med en config.yml

Trin 3 - Konfigurér Geyser

Åbn config.yml i en teksteditor. De vigtigste indstillinger:

yaml
bedrock:
  address: 0.0.0.0
  port: 19132          # UDP-porten Bedrock-spillere forbinder til
  clone-remote-port: false

remote:
  address: auto        # Lad stå på "auto" hvis Geyser kører på samme server
  port: 25565          # Din Java-servers port
  auth-type: online    # Sæt til "floodgate" hvis du bruger Floodgate (se nedenfor)

Standalone-servere: Ret remote.address til din Java-servers IP-adresse i stedet for auto.

Trin 4 - Åbn UDP-porten

Bedrock Edition bruger UDP, ikke TCP. Sørg for at port 19132 UDP er åben i din firewall:

bash
# Ubuntu/Debian med ufw
sudo ufw allow 19132/udp

# CentOS/RHEL med firewalld
sudo firewall-cmd --permanent --add-port=19132/udp
sudo firewall-cmd --reload

Hos de fleste hostingudbydere gøres det via kontrolpanelet under "Firewall" eller "Ports".

Trin 5 - Start serveren og test

  1. (Gen)start din server
  2. Åbn Minecraft: Bedrock Edition
  3. Gå til Spil → Servere → Tilføj server
  4. Indtast din servers IP og port 19132
  5. Forbind - du bør nu komme ind på serveren

Tilvalg: Installer Floodgate

Floodgate lader Bedrock-spillere forbinde uden at have en Java Edition-konto. De autentificeres via Xbox Live i stedet.

Download Floodgate

  1. Gå til https://geysermc.org/download og vælg Floodgate
  2. Vælg samme platform som du valgte til Geyser
  3. Placer .jar-filen i din plugins- eller mods-mappe

Konfigurér Geyser til Floodgate

Åbn Geysers config.yml og ret auth-type:

yaml
remote:
  auth-type: floodgate

Konfigurér serveren

Lad online-mode=true stå i server.properties. Floodgate håndterer autentificering af Bedrock-spillere automatisk - Java-spillere logges ind normalt.

Genstart og verificér

  1. Genstart serveren
  2. En Bedrock-spiller kan nu forbinde og logge ind via Xbox Live
  3. Bedrock-spillernavne vises med præfikset . (f.eks. .SpillerNavn) - dette er normalt

Fejlfinding

Bedrock-spillere kan ikke forbinde

Kontrollér at UDP-port 19132 er åben - mange firewalls blokerer kun TCP og glemmer UDP. Brug https://portchecker.co og vælg UDP for at teste.

"Connection refused" eller timeout

Bekræft at remote.address og remote.port i config.yml peger på den korrekte Java-server. Kører Geyser Standalone, skal adressen være serverens faktiske IP - ikke auto.

Bedrock-spillere spawner under verden eller faller gennem blokke

Dette sker typisk ved lag eller ved brug af visse plugins der ikke er kompatible med Geyser. Se https://wiki.geysermc.org/geyser/current-limitations/ for kendte begrænsninger.

Floodgate: "Invalid key" ved forbindelse

Floodgates key.pem-fil skal være den samme på både Geyser og Floodgate. Hvis du kører BungeeCord/Velocity, skal filen kopieres fra Floodgate-installationen på proxy-serveren til backend-serverne.

Skærme, tegnebrætter og kort vises ikke korrekt

Disse funktioner understøttes endnu ikke fuldt ud i Geyser - det er en kendt begrænsning.

Vigtigt at vide

  • Geyser understøtter ikke alle Java-funktioner - Java-eksklusive blokke og items kan opføre sig anderledes eller slet ikke vises for Bedrock-spillere
  • Bedrock-spillernavne med Floodgate har altid præfikset . - brug dette til at skelne dem fra Java-spillere i logs og permissions-plugins
  • Geyser kræver at serveren kører Java Edition-protokollen internt - det ændrer ikke din servers type, det fungerer som en oversætter
  • Opdatér Geyser og Floodgate samtidigt - de to skal altid have matchende versioner