Come configurare Geyser e Floodgate per i giocatori Bedrock

Geyser permette ai giocatori Bedrock su telefono, tablet, console e Windows di entrare nel tuo server Java traducendo tra le due edizioni, e Floodgate li fa entrare senza un account Java. Installali entrambi sul tuo server Paper o sul tuo proxy Velocity, imposta transport di Geyser su both, apri la porta Bedrock per TCP e UDP, e poi controlla da fuori dalla tua rete che un giocatore Bedrock riesca davvero a entrare.

Quest'ultimo passaggio è quello che la maggior parte dei proprietari salta. Il nostro pinger manda ogni minuto un ping Bedrock a ogni scheda crossplay che pubblica un indirizzo Bedrock, e negli ultimi 30 giorni 21 delle 93 schede giocabili su Java non hanno mai risposto a nemmeno uno di quei ping, mentre solo 52 hanno risposto almeno il 90% delle volte. Quando abbiamo scritto questa guida, il 18 ottobre 2026, erano 94 schede, di cui 20 non rispondevano mai su Bedrock e 53 rispondevano in modo affidabile. Il proprietario di una configurazione crossplay rotta di solito non lo sa, perché su Java nessuno se ne accorge.

Una data conta adesso. Bedrock 26.60 è previsto per il 27 ottobre 2026, e da quella versione i client Bedrock smettono di connettersi tramite RakNet, il trasporto che Geyser usa ancora di default. L'avviso su NetherNet di GeyserMC è netto: dopo quella data i giocatori Bedrock non possono entrare nei server che non hanno fatto il cambio. I passaggi qui sotto lo includono già.

Come funzionano Geyser e Floodgate

Geyser sta tra il client Bedrock e il tuo server Java. Accetta la connessione Bedrock, apre una connessione Java per conto del giocatore e traduce tutto quello che passa in mezzo: chunk, entità, inventari, chat, suoni. Il tuo server vede un client Java in più. Poiché Geyser imita il client Java attuale, il tuo server deve accettare quella versione, cioè Java 26.3 al momento in cui scriviamo. Un server più vecchio ha bisogno di ViaVersion per accettare il client più recente.

Floodgate risolve il problema degli account. Un giocatore Bedrock ha un account Microsoft e un gamertag Xbox, non un profilo Java, e un normale server in modalità online lo respingerebbe. Con Floodgate, Geyser garantisce per il giocatore usando un file di chiave condiviso chiamato key.pem, e Floodgate lo ammette con un'identità Java generata: il gamertag con un prefisso (un punto di default, quindi .Steve) e un UUID costruito dal suo ID utente Xbox, nella forma 00000000-0000-0000-xxxx-xxxxxxxxxxxx.

Una piccola nota a margine: poiché quell'UUID deriva dall'ID utente Xbox, un giocatore Bedrock che cambia gamertag mantiene inventario e permessi. I plugin che salvano i giocatori per nome saranno meno indulgenti.

Cosa cambia con NetherNet

NetherNet è il nuovo trasporto di Bedrock, costruito su WebRTC. Un client manda prima una piccola richiesta web via TCP per chiedere come connettersi, un passaggio chiamato signaling, e solo dopo gioca via UDP. Il signaling trasporta anche il MOTD e il numero di giocatori che mostra l'elenco server di Bedrock. Per questo una porta Bedrock che prima aveva bisogno solo di UDP ora ha bisogno anche di TCP, e per questo il tuo server può sparire dall'elenco server Bedrock dei giocatori anche con la porta di gioco spalancata. I client dalla 26.40 in poi possono usare NetherNet, pienamente dalla 26.50, e dalla 26.60 devono usarlo. Geyser lo supporta dalla build 1237 in poi, ma RakNet resta il suo predefinito.

Plugin, proxy o standalone: quale installazione

In un network, Geyser va sul proxy e da nessun'altra parte. I giocatori Bedrock si connettono al proxy come tutti gli altri, e il proxy li sposta tra i backend.

Installare su Paper

Verificato con la documentazione di GeyserMC per un server Paper 26.3. Purpur e gli altri fork di Paper seguono gli stessi passaggi.

1. Controlla che il server accetti client Java 26.3. Se gira su una versione più vecchia, installa prima ViaVersion.

2. Scarica Geyser-Spigot e Floodgate-Spigot da geysermc.org/download, metti i due JAR in plugins, avvia il server una volta perché creino le loro cartelle, poi fermalo.

3. Apri plugins/Geyser-Spigot/config.yml e imposta la sezione Bedrock:

   bedrock:
     address: 0.0.0.0
     port: 19132
     transport: both
     webrtc-port: 19134

4. Nello stesso file, imposta auth-type: floodgate. Si trova nella sezione sul server Java, che le build attuali chiamano java: e quelle vecchie remote:.

5. Apri le porte come descritto più sotto, avvia il server e leggi la console. Geyser stampa le porte che ha aperto e descrive la maggior parte dei problemi di NetherNet in parole semplici.

Perché both e non nethernet? NetherNet da solo basta per i client attuali. both fa entrare anche i giocatori ancora su una versione dalla 26.30 alla 26.34, che parlano solo RakNet, serve i client 26.40 che leggono ancora il MOTD via RakNet, e mantiene attivo il listener RakNet di Geyser, quello con cui parla il nostro controllo Bedrock (più avanti, in «Controllare da fuori»). Il costo è una porta UDP in più: webrtc-port deve essere libera e diversa da port, e 19134 è solo un esempio. Il consiglio di GeyserMC stesso è di passare a nethernet e chiudere la porta RakNet quando la 26.60 sarà uscita e i tuoi giocatori si saranno aggiornati.

Installare su Velocity

1. Assicurati che Velocity e ogni backend accettino client Java 26.3. Geyser entra nel proxy come client Java di quella versione, e Velocity passa la versione, quindi un backend obsoleto senza ViaVersion è un backend che i giocatori Bedrock non possono raggiungere.
2. Metti Geyser-Velocity e Floodgate-Velocity nella cartella plugins del proxy, avvia Velocity una volta e poi fermalo.
3. Configura plugins/Geyser-Velocity/config.yml esattamente come nell'esempio Paper, compreso auth-type: floodgate.
4. Apri le porte Bedrock sulla macchina del proxy, non sui backend.
5. Tieni il modern forwarding come lo usi già: player-info-forwarding-mode = "modern" in velocity.toml, e su ogni backend proxies.velocity.enabled: true in config/paper-global.yml con il secret del file forwarding.secret di Velocity.

I comandi di Geyser, come /geyser version e /geyser dump, girano sul proxy, quindi assegna lì i loro permessi, per esempio con LuckPerms per Velocity.

Floodgate sui backend

Floodgate deve stare solo sul proxy. Aggiungilo ai backend quando un plugin di un backend ha bisogno dell'API di Floodgate, per esempio per aprire moduli Bedrock nativi o per controllare se un giocatore è su Bedrock.

1. Installa Floodgate-Spigot su ogni backend.
2. Nella configurazione di Floodgate del proxy, imposta send-floodgate-data: true.
3. Copia key.pem dalla cartella di Floodgate del proxy nella cartella di Floodgate di ogni backend.
4. Riavvia i backend, poi il proxy.

Tratta key.pem come una password. Chi la possiede può aggirare l'autenticazione Java per qualsiasi account Bedrock sul tuo server, quindi non deve mai finire in un repository pubblico, in uno screenshot per l'assistenza o in un pacchetto di plugin condiviso.

Porte: 19132 su TCP e UDP, e il tuo host

La porta predefinita di Bedrock è la 19132. Con NetherNet e il signaling integrato di Geyser, la porta di Geyser deve essere aperta sia per TCP sia per UDP, quindi non può più condividere il numero con la tua porta Java, che occupa già il TCP. Con transport: both, anche webrtc-port ha bisogno di UDP.

• Router di casa o VPS. Inoltra la porta di Geyser come TCP e UDP (molti router lo chiamano «Both») e webrtc-port come UDP. Poi apri le stesse porte nel firewall del sistema operativo. Con ufw sono sudo ufw allow 19132 (entrambi i protocolli) e sudo ufw allow 19134/udp.
• Docker. Pubblica ogni protocollo esplicitamente: 19132:19132/tcp, 19132:19132/udp e 19134:19134/udp. Un semplice 19132:19132 pubblica solo il TCP.
• Oracle Cloud. Apri le porte nella security list del cloud e nel firewall dell'istanza stessa. Una delle due da sola non basta.
• OVH e SoYouStart. La pagina di GeyserMC sul port forwarding segnala che le regole Bedrock del firewall GAME non gestiscono ancora NetherNet. Usa la regola Other per le porte di Geyser.
• Hosting di giochi con una sola porta. Il vecchio trucco, clone-remote-port, riutilizzava il numero della tua porta Java per Bedrock via UDP. Con il signaling integrato non funziona, perché il signaling ha bisogno del TCP su quella porta e il tuo server Java la occupa già. Geyser allora ripiega da solo su Warden, un servizio di signaling esterno gratuito gestito da Ziax, l'azienda dietro CubeCraft. Con Warden da parte tua serve solo UDP, ma i giocatori entrano con l'indirizzo e la porta che Geyser stampa nella console, a meno che tu non registri un dominio personalizzato su Warden. Chiedi al tuo host una seconda porta, o controlla se l'host configura già Geyser tramite i parametri di avvio.
• Tunnel. ngrok fa passare solo TCP, quindi non può trasportare il gioco Bedrock. La guida di GeyserMC a playit.gg è stata scritta per RakNet e rimanda alla pagina di stato NetherNet di playit: controllala prima di affidarti a un tunnel.

Le porte personalizzate danno più problemi nei nostri dati. Tra le schede con una porta Bedrock diversa da quella predefinita, negli ultimi 30 giorni 6 su 18 non hanno mai risposto a un ping Bedrock, contro 15 su 75 di quelle sulla 19132 (al 18 ottobre 2026: 6 su 18, contro 14 su 76). Il campione è piccolo, ma una porta personalizzata è un numero in più da azzeccare in due posti.

Il signaling integrato di Geyser usa HTTP semplice di default, quindi al primo ingresso Bedrock chiede a ogni giocatore se si fida del server. Puntare l'impostazione certificate nella parte HTTPS della configurazione del signaling di Geyser a un certificato TLS elimina la richiesta, e Warden gestisce l'HTTPS per te.

I nomi di Floodgate e i tuoi plugin

Un giocatore Bedrock chiamato Steve arriva come .Steve, e quel punto raggiunge ogni plugin che usi.

• Il prefisso. È l'impostazione username-prefix nella configurazione di Floodgate, "." di default. Floodgate consiglia un prefisso senza lettere né numeri, così nessun nome Bedrock può entrare in collisione con un nome Java. Evita *: i comandi potrebbero richiedere il nome tra virgolette.
• Spazi. I gamertag possono contenere spazi, i nomi Java no. Con replace-spaces: true (il predefinito), Cool Steve diventa .Cool_Steve.
• LuckPerms. Imposta allow-invalid-usernames: true nella configurazione di LuckPerms perché i nomi con un punto vengano accettati, oppure indica i giocatori per UUID.
• Whitelist. /whitelist add chiede a Mojang un profilo Java e fallisce per i giocatori Bedrock. Usa invece /fwhitelist add Steve (il prefisso è facoltativo) o l'UUID Floodgate del giocatore. Il permesso è floodgate.command.fwhitelist.
• Failed to verify username su Paper. Paper rifiuta i nomi che considera non validi. Installare Floodgate sul backend attenua il problema, e la pagina dei problemi noti di Floodgate dà la soluzione completa: imposta perform-username-validation su false sotto unsupported-settings in config/paper-global.yml.
• Giocatori con entrambe le edizioni. Il linking globale, attivo di default, permette a un giocatore di collegare una sola volta i suoi account Java e Bedrock e di arrivare con la sua identità Java su ogni server che lo ha attivato.
• Voti. Votifier consegna un nome utente, e i plugin di ricompense pagano il giocatore online o offline il cui nome corrisponde. Un giocatore Bedrock deve votare come .Steve, non Steve, altrimenti la ricompensa non va da nessuna parte. Il nostro modulo di voto riconosce i prefissi Floodgate più comuni, controlla il nome rispetto agli account Bedrock e lo consegna così come è stato digitato. Negli ultimi 30 giorni, i voti per nomi Bedrock sono stati una quota pari a 6% di tutti i voti su serverlist.net, e di questi una quota pari a 97% portava il punto predefinito (6% e 97% al 18 ottobre 2026). Se hai cambiato il prefisso, dillo nel tuo messaggio /vote. La guida a NuVotifier copre il resto del percorso del voto.

I giocatori Bedrock non possono cliccare i link in chat, un limite che Geyser non può correggere. Un messaggio di voto che dice solo «clicca qui» per loro non serve a nulla. Scrivi l'indirizzo di voto come testo semplice, abbastanza corto da essere digitato su un telefono.

Controllare da fuori

Entrare dal tuo telefono sul tuo Wi-Fi dimostra molto poco, perché il telefono può raggiungere il server attraverso la tua rete locale senza mai toccare le regole del router che hai appena scritto. Controlla come farebbe uno sconosciuto.

1. Spegni il Wi-Fi su un telefono, aggiungi il server in Bedrock con indirizzo e porta pubblici ed entra con i dati mobili. La guida per entrare da Bedrock mostra il lato giocatore di questo passaggio.

2. Passa indirizzo e porta Bedrock nello strumento di stato del server, che li controlla una volta dal nostro lato:

   Controlla un server adesso

   JavaBedrockJava e Bedrock

   Indirizzo server

   L’indirizzo che i giocatori scrivono in Multigiocatore. Etichette come IP: e spazi vengono tolti.

   Porta facoltativa

   Controlla oraPing in corsoControllatoNon controllato

   La risposta compare qui come la riga che vedresti in Multigiocatore, con giocatori, versione e ping.

3. Aggiungi il tuo server o modifica la tua scheda, attiva «Possono entrare anche i giocatori Bedrock» e inserisci indirizzo e porta Bedrock. Da quel momento il nostro pinger controlla la porta Bedrock ogni minuto, e il segno Bedrock sulla tua scheda e la tua posizione nella lista dei server Bedrock derivano da quelle risposte, non dall'interruttore.

4. Ripeti dopo ogni aggiornamento di Geyser e ogni release di Bedrock. Una build di Geyser troppo vecchia per una nuova versione di Bedrock è un motivo frequente per cui i giocatori Bedrock restano all'improvviso fuori il giorno di un aggiornamento.

Una nota su come controlliamo, perché influisce su ciò che vedi. Il nostro ping Bedrock è il ping RakNet che i client Bedrock usavano prima di NetherNet. Geyser in modalità both risponde, Geyser in modalità nethernet no. Finché il nostro controllo non parlerà anche NetherNet, un server solo su nethernet risulta qui come non rispondente su Bedrock anche quando i giocatori Bedrock possono entrare, quindi per ora both è l'impostazione che mantiene corretto il segno Bedrock della tua scheda. Come misuriamo è spiegato nella pagina sulla metodologia.

Ecco come si dividono le schede per piattaforma in questo momento:

• Solo JavaNessun indirizzo Bedrock nella scheda367% dei giocatori
• Bedrock rispondeIndica un indirizzo Bedrock che ha risposto al nostro ping Bedrock7290% dei giocatori
• Bedrock mutoIndica un indirizzo Bedrock che non ha mai risposto213% dei giocatori

Su 129 server giocabili, 72 hanno risposto anche su Bedrock e 21 indicano un indirizzo Bedrock che non ha mai risposto.

Misurato il 19 ott 2026, 22:55 UTCCome misuriamo

Cosa mancherà ai giocatori Bedrock

Geyser non può cambiare il client Bedrock. GeyserMC tiene una pagina sulle limitazioni attuali, e queste sono le voci che più spesso contano su un server tipico:

• Link cliccabili in chat. Su Bedrock non funzionano, il che colpisce link di voto, link dello store e inviti Discord.
• Clic sinistro e destro nei menu dell'inventario. Bedrock non li distingue, quindi le GUI a baule che fanno cose diverse a ogni clic smettono di funzionare. I moduli di Floodgate sono l'alternativa nativa di Bedrock.
• Gli incantesimi personalizzati non vengono mostrati, e i livelli non vanilla come «Tocco di velluto 2» non possono essere visualizzati.
• Argomenti dei comandi e completamento con Tab funzionano solo per i comandi registrati alla maniera moderna (Brigadier).
• Luminescenza e stendardi con più di sei livelli.

Due limiti collegati non sono su quella pagina. I resource pack Java non si caricano su Bedrock, quindi Geyser deve inviare invece un pack Bedrock, e gli oggetti personalizzati hanno bisogno di un mapping di Geyser prima che i giocatori Bedrock li vedano bene. Il GeyserIntegratedPack che Geyser include corregge alcune lacune sue, come le animazioni della mano secondaria e le pose dei supporti per armature.

Anche il combattimento dà un'altra sensazione. Bedrock non ha una ricarica dell'attacco propria, quindi Geyser disegna un indicatore sostitutivo, sul mirino di default (l'opzione cooldown-type nella sezione gameplay, chiamata show-cooldown nelle configurazioni più vecchie), e i giocatori touch mirano in modo diverso da chi usa il mouse. Se il tuo server è costruito attorno ai tempi del PvP di Java, dillo nella tua scheda.

Mettilo in evidenza nella tua scheda

Una configurazione Bedrock che funziona è sprecata se i giocatori non possono vederla o digitarla.

• Indirizzo e porta in campi separati. Bedrock non legge i record SRV, quindi i giocatori digitano la porta a mano. Metti la porta nel campo della porta, non dopo i due punti nell'indirizzo. Se Geyser è ripiegato su Warden, usa l'indirizzo che Geyser stampa. Se Geyser condivideva prima la tua porta Java, la tua porta Bedrock è cambiata: aggiorna la scheda e di' ai giocatori di modificare il server salvato.
• Di' cosa ottengono i giocatori Bedrock. Una o due righe nella tua descrizione: il prefisso che vedranno, quali menu o minigiochi non funzionano su Bedrock e come votare con il proprio nome. La guida alla descrizione del server mostra dove inserirlo.
• Indica l'intervallo di versioni. «Bedrock 26.50 e successive» dice a un giocatore più di «crossplay».
• I giocatori su console hanno bisogno di più aiuto. Telefoni e Windows possono aggiungere qualsiasi server, ma i giocatori Xbox, PlayStation e Switch hanno bisogno di soluzioni di terze parti, quindi un indirizzo Bedrock da solo non li raggiunge.

Il punto di vista del giocatore su tutto questo è in Java e Bedrock possono giocare insieme su Minecraft?

Tabella per la risoluzione dei problemi

Quando la tabella non basta, /geyser dump produce un report di debug che l'assistenza di GeyserMC richiede. Una volta che Bedrock funziona, il lavoro successivo è assicurarsi che i voti di entrambe le edizioni arrivino, cosa che la guida alla configurazione di NuVotifier spiega passo per passo.