I tuoi amici giocano alla Bedrock Edition su smartphone, console o Windows, mentre tu giochi su Java? Buone notizie: con GeyserMC tutti possono ritrovarsi sullo stesso server Minecraft. Questa guida ti spiega come installarlo, configurarlo e risolvere i problemi più comuni.

Che cos'è GeyserMC?

Minecraft Java Edition e Minecraft Bedrock Edition non usano lo stesso protocollo di rete: di default, un giocatore Bedrock non può entrare in un server Java. Geyser fa da traduttore: riceve le connessioni Bedrock e le converte in connessioni Java che il tuo server comprende.

Geyser viene di solito affiancato da Floodgate, un secondo plugin che permette ai giocatori Bedrock di collegarsi con il solo account Microsoft/Xbox, senza possedere un account Minecraft Java.

Componente	Ruolo	Indispensabile?
Geyser-Spigot	Traduce il protocollo Bedrock in Java	✅ Sì
Floodgate	Accesso dei giocatori Bedrock senza account Java	✅ Fortemente consigliato
ViaVersion	Accetta versioni del client diverse da quella del server	Facoltativo

Requisiti

Un server Paper, Spigot o Purpur (Geyser esiste anche per i proxy Velocity e BungeeCord, ma questa guida tratta il plugin Spigot).
La versione di Java richiesta dalla tua versione di Minecraft (Java 25 da Minecraft 26.1, Java 21 per le versioni dalla 1.20.5 alla 1.21.11).
Un server aggiornato: Geyser segue l'ultima versione di Minecraft Java. Se il tuo server usa una versione precedente, installa ViaVersion.
La possibilità di aprire una porta UDP aggiuntiva, oppure di usare la stessa porta di Java (vedi sotto).

Installare Geyser e Floodgate

Passo 1: scaricare i plugin

Scarica i file solo dal sito ufficiale del progetto GeyserMC, nella sezione Download. Scegli la versione Spigot di Geyser (compatibile con Paper e Purpur), poi quella di Floodgate.

⚠️ Attenzione: evita i siti di download non ufficiali, che possono proporre versioni modificate o obsolete.

Passo 2: installare i file

1. Arresta il server
2. Copia Geyser-Spigot.jar e floodgate-spigot.jar nella cartella /plugins/
3. Avvia il server
4. I file di configurazione vengono generati automaticamente

Passo 3: verificare il caricamento

/plugins
/geyser version

Geyser e floodgate devono comparire in verde nell'elenco dei plugin.

Configurare Geyser

Il file principale si trova in plugins/Geyser-Spigot/config.yml. Ecco i parametri essenziali (i nomi possono variare leggermente in base alla versione di Geyser, fai riferimento ai commenti del file):

bedrock: # Indirizzo di ascolto per i giocatori Bedrock address: 0.0.0.0 # Porta Bedrock (UDP), 19132 di default port: 19132 # true = usa la stessa porta del server Java clone-remote-port: false remote: Con il plugin Spigot, lascia "auto" address: auto port: 25565 "floodgate" = accesso senza account Java

auth-type: floodgate

Il parametro auth-type

Valore	Effetto
`floodgate`	I giocatori Bedrock entrano con l'account Xbox, senza account Java (consigliato con Floodgate)
`online`	I giocatori Bedrock devono collegare un account Java valido
`offline`	Nessuna verifica: da evitare su un server pubblico

Quando Geyser e Floodgate sono installati sullo stesso server, Floodgate condivide automaticamente la sua chiave di cifratura con Geyser: non devi copiare nulla.

Il prefisso dei giocatori Bedrock

Per evitare che un giocatore Bedrock abbia lo stesso nome di un giocatore Java, Floodgate aggiunge un prefisso: di default un punto. Il giocatore Bedrock Steve apparirà quindi come .Steve. Puoi modificarlo in plugins/floodgate/config.yml:

username-prefix: "."

Ricordalo quando assegni permessi o aggiungi un giocatore Bedrock alla whitelist: usa il suo nome con il prefisso.

Aprire la porta Bedrock

I giocatori Bedrock si collegano in UDP, sulla porta 19132 di default. È il passaggio che crea più problemi.

Opzione 1: una porta dedicata

Se il tuo hosting ti permette di aggiungere una porta, aprila in UDP e indicala in bedrock.port. Su una macchina che gestisci tu, autorizzala nel firewall:

# Esempio con UFW su Linux
sudo ufw allow 19132/udp

Opzione 2: condividere la porta Java

Molti hosting forniscono una sola porta. In questo caso imposta clone-remote-port su true: Geyser ascolterà sullo stesso numero di porta del server Java. Java usa TCP e Bedrock UDP, quindi possono convivere, a patto che la porta sia aperta anche in UDP presso il tuo hosting.

bedrock:
  clone-remote-port: true

Riavvia poi il server per applicare le modifiche.

Collegarsi da Bedrock

Smartphone e Windows

Apri Minecraft Bedrock e vai nella scheda Server.
Clicca su Aggiungi server.
Inserisci l'indirizzo IP (o il nome di dominio) del server e la porta Bedrock.
Salva ed entra nel server.

Console (Xbox, PlayStation, Switch)

Su console, Minecraft non permette di aggiungere liberamente un server esterno. Soluzioni della community come BedrockConnect aggirano questo limite, di solito modificando i DNS della console. Non sono ufficiali e il loro funzionamento può cambiare: consulta la loro documentazione prima di usarle.

I limiti da conoscere

Geyser fa un lavoro notevole, ma Java e Bedrock restano due giochi diversi:

Meccaniche di gioco: alcune sottigliezze (redstone avanzata, combattimento, movimenti) non si comportano esattamente allo stesso modo.
Resource pack: un pacchetto Java non viene convertito automaticamente. I pacchetti in formato Bedrock possono essere aggiunti nella cartella packs di Geyser.
Comandi e menù: il completamento automatico e alcuni menù dei plugin appaiono diversi per i giocatori Bedrock.
Plugin anti-cheat: alcuni possono segnalare per errore i giocatori Bedrock; verifica che siano compatibili con Geyser.

Risoluzione dei problemi

«Impossibile connettersi al mondo»

Verifica che la porta Bedrock sia aperta in UDP (aprirla in TCP non basta).
Controlla che la porta inserita nel gioco corrisponda a bedrock.port.
Guarda la console del server all'avvio: Geyser indica la porta su cui è in ascolto.

«Outdated server» o versione incompatibile

Aggiorna Geyser e Floodgate: ogni nuova versione di Bedrock richiede spesso un aggiornamento di Geyser.
Se il tuo server Java è datato, installa ViaVersion.

Ai giocatori Bedrock viene chiesto un account Java

Verifica che Floodgate sia installato e caricato.
Verifica che auth-type sia impostato su floodgate, poi riavvia.

Comandi di diagnostica

/geyser version   # Versione installata
/geyser list      # Giocatori Bedrock connessi
/geyser reload    # Ricarica la configurazione
/geyser dump      # Report completo per il supporto

Whitelist e giocatori Bedrock

Se il tuo server usa la whitelist, aggiungi i giocatori Bedrock con il comando di Floodgate, che gestisce il prefisso per te:

/fwhitelist add <nome_bedrock>

Conclusione

Con GeyserMC e Floodgate, il tuo server Minecraft diventa accessibile a tutti i tuoi amici, qualunque sia la loro piattaforma. In sintesi:

Installa Geyser-Spigot e Floodgate dal sito ufficiale di GeyserMC.
Imposta auth-type: floodgate nella configurazione di Geyser.
Apri la porta 19132 in UDP, oppure condividi la porta Java con clone-remote-port.
Mantieni Geyser e Floodgate aggiornati a ogni nuova versione di Minecraft.

La tua community non ha più scuse per non giocare insieme!