Giocatori Bedrock sul tuo server Java: configurare Geyser + Floodgate (Paper, Velocity)

Cosa fanno Geyser e Floodgate

Geyser traduce tra le due edizioni. Verso il tuo server si comporta come un client Java, quindi redstone, farm e plugin funzionano esattamente come per i giocatori Java. Floodgate fa accedere i giocatori Bedrock con il loro account Xbox invece che con un account Java.

Prima di iniziare: Java e versioni

• Geyser richiede Java 21 o successivo sulla macchina su cui gira.
• Il tuo server deve accettare la versione Java più recente, perché Geyser imita un client del genere. I server più vecchi hanno bisogno di ViaVersion.
• Geyser-Spigot gira su Paper e Spigot dalla 1.20.5 in su. I server più vecchi hanno bisogno di un proxy, di Geyser Standalone o di ViaProxy.
• Sono supportate solo le versioni Bedrock attuali (ottobre 2026: da Bedrock 26.30 a 26.52, Java 26.2). Tieni Geyser aggiornato, perché Bedrock si aggiorna da solo.

Scarica Geyser e Floodgate per la tua piattaforma dalla pagina di download ufficiale di GeyserMC.

Configurazione su un singolo server Paper o Spigot

1. Metti Geyser-Spigot.jar e Floodgate-Spigot.jar nella cartella plugins.
2. Riavvia il server. Geyser crea plugins/Geyser-Spigot/config.yml, Floodgate crea plugins/floodgate/ con config.yml e un key.pem.
3. Apri la config di Geyser e controlla la sezione bedrock. La port è quella che i giocatori Bedrock dovranno inserire.
4. Imposta il tipo di autenticazione su floodgate e riavvia di nuovo.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

Nelle config di Geyser più vecchie la seconda sezione si chiama remote, quindi l’impostazione è remote.auth-type. Le build attuali passano da sole a Floodgate quando gira sullo stesso server; impostarlo comunque non fa danni.

Su un singolo server non copiare key.pem da nessuna parte. Geyser lo legge da Floodgate, e una copia dimenticata nella cartella di Geyser causa errori di accesso.

Apri la porta Bedrock per UDP

Java usa TCP, Bedrock usa UDP. È qui che si rompono la maggior parte delle configurazioni.

• Pannello dell’hosting: aggiungi una porta extra (molti hosting la chiamano allocation) e inseriscila come bedrock.port. Alcuni hosting richiedono che Bedrock usi la stessa porta di Java o cambiano la porta Java a ogni avvio; in quel caso clone-remote-port: true fa usare a Geyser la porta Java. La pagina di setup di Geyser ha istruzioni per molti hosting.
• Pterodactyl: assegna la porta al server nella scheda Network.
• Macchina tua o VPS: apri la porta per UDP nel firewall e, a casa, nel router. OVH e Oracle Cloud bloccano UDP anche nel loro firewall.

sudo ufw allow 19132/udp
sudo ufw reload

I plugin di chat vocale o il query non possono condividere la porta con Geyser. Quando la porta è aperta, esegui geyser connectiontest <ip> <port> in console: controlla la porta e suggerisce soluzioni.

Configurazione su un network Velocity o BungeeCord

In un network i giocatori Bedrock si collegano al proxy proprio come i giocatori Java. Per questo Geyser gira solo sul proxy.

1. Installa Geyser e Floodgate per il tuo proxy (Velocity o BungeeCord) e riavvia il proxy.
2. Imposta bedrock.port e il tipo di autenticazione floodgate nella config di Geyser sul proxy, e apri la porta per UDP come descritto sopra.
3. Installa Floodgate-Spigot su ogni backend. È necessario per i plugin che usano la Floodgate API e migliora le skin.
4. Configura l’inoltro: su BungeeCord imposta ip_forward: true nel suo config.yml e bungeecord: true nello spigot.yml di ogni backend; su Velocity configura l’inoltro delle informazioni dei giocatori come descritto nella documentazione di Velocity.
5. Nella config di Floodgate sul proxy imposta send-floodgate-data: true.
6. Copia key.pem dalla cartella di Floodgate del proxy nella cartella di Floodgate di ogni server backend, poi riavvia i backend e il proxy.

send-floodgate-data: true

Tieni segreto key.pem: permette agli account di saltare l’autenticazione Java. Caricalo via FTP in modalità binaria, altrimenti ottieni errori Tag mismatch.

Nomi Bedrock: il prefisso con il punto

Floodgate mette un prefisso davanti a ogni nome Bedrock, così non può mai scontrarsi con un nome Java. Il predefinito è un punto, quindi il gamertag Xbox Steve diventa .Steve sul tuo server. Gli spazi nei gamertag vengono sostituiti con _.

username-prefix: "."
replace-spaces: true

• Nei comandi usa il nome completo con il prefisso. Se un comando non lo accetta, metti il nome tra virgolette: /tp ".Steve".
• Per la whitelist usa fwhitelist add Steve. Lì il prefisso non serve.
• Se LuckPerms ha problemi con i nomi Bedrock, imposta allow-invalid-usernames: true nella sua config.

GeyserMC consiglia di tenere il prefisso. I giocatori Bedrock votano anche con questo nome: su BestMCServerList inseriscono .Steve, il nome che vede il tuo plugin delle ricompense per i voti.

Account collegati e skin (facoltativo)

Il Global Linking è attivo di default in Floodgate. I giocatori che hanno entrambe le edizioni entrano su link.geysermc.org con tutti e due gli account e scrivono /linkaccount. Da lì giocano con l’inventario e la posizione Java da qualsiasi dispositivo, quindi è meglio che prima spostino i loro oggetti Bedrock. Un database di collegamenti locale richiede un’estensione extra di Floodgate.

Floodgate converte e carica le skin Bedrock, così i giocatori Java le vedono. Passa per una coda e può richiedere un po’ di tempo.

Errori comuni e soluzioni

Alcune cose non si possono tradurre: clic sinistro e destro negli inventari sembrano uguali, i comandi senza Brigadier non hanno il completamento con tab, i link in chat non sono cliccabili. Prova i menu con un vero dispositivo Bedrock. I plugin possono mostrare form Bedrock native tramite la Floodgate API, che richiede Floodgate sul loro server.

Mostra entrambi gli indirizzi su BestMCServerList

I giocatori Bedrock si collegano con il tuo indirizzo più la porta Bedrock, per esempio play.example.net e 19132. BestMCServerList mostra separatamente l’indirizzo Java e quello Bedrock su ogni pagina server, ognuno con un pulsante per copiarlo.

1. Apri Aggiungi il tuo server e inserisci il tuo indirizzo Java.
2. Spunta I giocatori Bedrock sono supportati.
3. Inserisci la porta Bedrock da bedrock.port. Lascia vuoto l’IP Bedrock se è uguale all’indirizzo Java.

Il crossplay è un vero vantaggio per un nuovo server. Vedi come trovare giocatori per un nuovo server per il resto del piano.