IT

Server di gioco

Come accogliere i giocatori Bedrock con Geyser e Floodgate

Apri il tuo server Minecraft Java ai giocatori Bedrock con Geyser e Floodgate su Paper: installazione, porte TCP e UDP, firewall, connessione e risoluzione dei problemi.

7 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Minecraft Java e Minecraft Bedrock (mobile, Windows, console) non parlano la stessa lingua di rete. Questa guida spiega come installare due plugin sul tuo server Paper per permettere ai giocatori Bedrock di entrare:

  • Geyser traduce gli scambi tra Bedrock e Java
  • Floodgate permette ai giocatori Bedrock di entrare con il proprio account Microsoft, senza possedere Minecraft Java

Prerequisiti

  • Un server con Paper, con il comando mc-console configurato nella guida Installare e aggiornare i plugin su Paper
  • La modalità online mantenuta in server.properties: online-mode=true
  • Accesso al firewall del server
  • Un client Minecraft Bedrock aggiornato per le prove

Capire le porte

Bedrock usa ormai il protocollo di connessione NetherNet, attivo per impostazione predefinita in Geyser. Ha bisogno dello stesso numero di porta in entrambi i protocolli:

Porta Protocollo Utilizzo
19132 TCP Segnalazione: il client trova il server e prepara la connessione
19132 UDP Traffico di gioco
25565 TCP Giocatori Java, già aperta

Aprire il firewall

Usa un solo strumento firewall, quello già attivo sul tuo server.

Con UFW

Terminale
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reload

Con iptables

Terminale
sudo iptables -A INPUT -p tcp --dport 19132 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Il salvataggio delle regole al riavvio richiede il pacchetto iptables-persistent.

Con nftables

Questi comandi usano la tabella inet filter e la catena input, presenti per impostazione predefinita in /etc/nftables.conf su Debian.

Terminale
sudo nft add rule inet filter input tcp dport 19132 accept
sudo nft add rule inet filter input udp dport 19132 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Installare Geyser e Floodgate

Scarica le versioni per Paper e Spigot dal servizio ufficiale:

Terminale
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
ls -l Geyser-Spigot.jar floodgate-spigot.jar
exit

Riavvia il server per generare i file di configurazione, poi attendi la riga Done:

Terminale
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Esci dalla visualizzazione dei log con Ctrl+C.

Configurare Geyser

Apri il file di configurazione:

Terminale
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.yml

Controlla la sezione bedrock, poi imposta auth-type su floodgate nella sezione java. Modifica le righe esistenti, senza duplicarle:

YAML
bedrock:
  address: 0.0.0.0
  port: 19132
  transport: nethernet

java:
  auth-type: floodgate

Puoi anche personalizzare il nome mostrato ai giocatori Bedrock con server-name, nella sezione gameplay.

Riavvia il server per applicare queste modifiche:

Terminale
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Verificare il risultato

Controlla che i plugin siano caricati e che il server sia in ascolto su entrambi i protocolli:

Terminale
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132

Dovresti vedere:

  • Geyser-Spigot e floodgate nell'elenco dei plugin
  • una riga Built-in signaling started on nei log di avvio
  • la porta 19132 in tcp e in udp nell'output di ss

Prova poi l'accesso dall'esterno. Il comando seguente chiede a Geyser di controllare che il tuo server sia raggiungibile:

Terminale
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest IP_SERVER 19132'

Da un altro computer puoi anche verificare la porta TCP:

Terminale
nc -vz IP_SERVER 19132

Connettersi da Bedrock

In Minecraft Bedrock:

  1. Apri Gioca, poi la scheda Server
  2. Scegli Aggiungi server
  3. Inserisci un nome, l'indirizzo IP_SERVER e la porta 19132
  4. Salva, poi entra nel server

Alla prima connessione, il gioco chiede se deve fidarsi del server. È normale quando ci si connette tramite un indirizzo IP o senza HTTPS. Per eliminare questo messaggio, puoi servire la segnalazione in HTTPS con un nome di dominio e un certificato.

Una volta in gioco, verifica la presenza del giocatore:

Terminale
sudo mc-console 'geyser list'

Gestire i giocatori Bedrock

Nomi utente

Floodgate aggiunge un punto davanti ai nomi utente Bedrock per evitare conflitti con gli account Java: Steve diventa .Steve. Gli spazi vengono sostituiti da _. Queste impostazioni corrispondono a username-prefix e replace-spaces in plugins/floodgate/config.yml.

Whitelist

Se white-list=true è attivo, aggiungi i giocatori Bedrock con il comando di Floodgate, senza il punto:

Terminale
sudo mc-console 'fwhitelist add Steve'

Permessi con LuckPerms

Per impostazione predefinita, LuckPerms rifiuta i nomi utente che contengono un punto. Autorizzali nel suo file di configurazione:

Terminale
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.yml
YAML
allow-invalid-usernames: true

Riavvia il server. Una volta che il giocatore si è connesso, puoi assegnarlo a un grado con il suo nome utente completo:

Terminale
sudo mc-console 'lp user .Steve parent add vip'

Collegare un account Java e un account Bedrock

Un giocatore che possiede entrambe le edizioni può collegarle entrando nel server link.geysermc.org con ciascun account e usando /linkaccount. Questo collegamento globale è attivo per impostazione predefinita.

Aggiornare Geyser e Floodgate

Bedrock cambia spesso, e una nuova versione del gioco può impedire ai giocatori di connettersi finché Geyser non viene aggiornato. Aggiornalo regolarmente:

Terminale
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
exit
sudo systemctl restart minecraft.service

In caso di problemi

« Unable to connect to world » o server non trovato

  1. Verifica che le porte TCP e UDP siano aperte con sudo ufw status, sudo iptables -L INPUT -n o sudo nft list ruleset
  2. Verifica l'ascolto con sudo ss -tulpn | grep 19132
  3. Esegui geyser connectiontest IP_SERVER 19132 dalla console
  4. Controlla nei log se arriva un tentativo di connessione. Se non compare nulla, il blocco si trova sulla rete

Se il firewall del server è corretto e la porta resta irraggiungibile dall'esterno, contatta l'assistenza dalla tua area clienti per verificare che non sia applicato alcun filtro di rete.

« NetherNet will not start! Could not load its WebRTC native library »

Geyser non è riuscito a caricare la sua libreria di rete, che estrae nella cartella temporanea. Verifica che /tmp non sia montata con l'opzione noexec e che ci sia ancora spazio:

Terminale
findmnt -no OPTIONS /tmp
df -h /tmp

Il client resta bloccato nella ricerca del server (« Locating Server »)

Riduci la dimensione dei pacchetti a scaglioni di 100 in plugins/Geyser-Spigot/config.yml, riavviando e provando dopo ogni modifica:

YAML
advanced:
  bedrock:
    mtu: 1300

Il server annuncia un indirizzo errato

Normalmente Geyser rileva da solo l'indirizzo pubblico. Se il server ha più indirizzi, o se il rilevamento non riesce, indica quello che i giocatori devono usare:

YAML
bedrock:
  signaling:
    advertise-addresses:
      - IP_SERVER

« Address already in use »

Un altro programma sta già usando la porta 19132, spesso una seconda istanza di Geyser. Identificalo con sudo ss -tulpn | grep 19132.

« Auth-type set to Floodgate but Floodgate is not installed! »

Floodgate è assente o non si è avviato. Verifica la presenza di floodgate-spigot.jar in plugins, poi cerca i suoi errori nei log.

« Cannot reply to EncryptionRequestPacket without profile and access token »

Floodgate non è attivo, oppure auth-type non è impostato su floodgate. Controlla questi due punti. Se nella cartella di Geyser si trova una copia di key.pem, eliminala.

« javax.crypto.AEADBadTagException: Tag mismatch! »

La chiave di Floodgate non è coerente. Arresta il server, elimina la cartella plugins/floodgate e qualsiasi chiave presente in plugins/Geyser-Spigot, poi riavvia:

Terminale
sudo systemctl stop minecraft.service
sudo rm -rf /opt/minecraft/server/plugins/floodgate
sudo rm -f /opt/minecraft/server/plugins/Geyser-Spigot/key.pem
sudo systemctl start minecraft.service

Se avevi modificato la configurazione di Floodgate, dovrai ripetere queste impostazioni.

« Please connect through the official Geyser »

Geyser e Floodgate non sono compatibili tra loro. Aggiornali entrambi.

« Failed to verify username! »

In config/paper-global.yml, imposta perform-username-validation su false nella sezione unsupported-settings, poi riavvia il server.

« Outdated client » o « Outdated server »

Il client Bedrock e Geyser non corrispondono più. Aggiorna Geyser, poi il gioco. Se il tuo server Java non è alla versione 26.3, installa ViaVersion.

Per approfondire, consulta la documentazione ufficiale di Geyser e quella di Floodgate.