Come configurare GeyserMC (crossplay Java/Bedrock) su OuiPanel
GeyserMC è un plugin che permette ai giocatori di Minecraft Bedrock di entrare nel tuo server Minecraft Java. Traduce tra le due versioni del gioco e apre così il crossplay tra PC, dispositivi mobili e console. Questa guida ti mostra come installare e configurare GeyserMC con Floodgate in OuiPanel, il pannello di gioco, come verificarlo con geyser connectiontest e come si collegano i giocatori Bedrock.
Cosa ti serve
Piattaforme supportate da Geyser
| Piattaforma | Supporto |
|---|---|
| Windows 10/11 (Bedrock) | completo |
| iOS (iPhone, iPad) | completo |
| Android | completo |
| Xbox | completo, con il metodo DNS descritto più sotto |
| Nintendo Switch | completo, con il metodo DNS descritto più sotto |
| PlayStation 4/5 | configurazione speciale necessaria |
| Java Edition | nativo, senza Geyser |
Il principio
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Giocatore Java │────▶│ │────▶│ │
│ (PC) │ │ Server │ │ │
└─────────────────┘ │ Minecraft │ │ Mondo │
│ Java │ │ condiviso │
┌─────────────────┐ │ + │ │ │
│ Giocatore │────▶│ GeyserMC │────▶│ │
│ Bedrock │ │ (traduttore) │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Geyser traduce i dati Bedrock in dati Java, e viceversa. I due tipi di giocatori condividono lo stesso mondo.
Plugin necessari
| Plugin | Ruolo | Stato |
|---|---|---|
| GeyserMC | traduce il protocollo Bedrock verso Java | obbligatorio |
| Floodgate | fa entrare i giocatori Bedrock senza account Java | consigliato |
| ViaVersion | accetta versioni più vecchie di Minecraft | facoltativo |
Senza Floodgate, ogni giocatore Bedrock avrebbe bisogno di un account Minecraft Java Edition per entrare.
Un software compatibile
| Software | Supporto | File di Geyser |
|---|---|---|
| Paper | consigliato | Geyser-Spigot.jar |
| Spigot | completo | Geyser-Spigot.jar |
| Purpur | completo | Geyser-Spigot.jar |
| BungeeCord | completo | Geyser-BungeeCord.jar |
| Velocity | completo | Geyser-Velocity.jar |
| Fabric | completo | Geyser-Fabric.jar |
| NeoForge | completo | Geyser-NeoForge.jar |
| Vanilla | non supportato | nessuno |
Un server Vanilla deve prima passare a Paper o Spigot, in Versioni/Modpack › Gestione Versioni. La guida Come installare plugin sul proprio server Minecraft spiega come fare.
Una seconda porta, in UDP
Geyser ha bisogno di una porta a parte per i giocatori Bedrock.
Porta Java,
25565di default (TCP), per i giocatori Java.Porta Bedrock,
19132di default (UDP), per i giocatori Bedrock.
In OuiPanel, questa porta si aggiunge in Configurazione › Gestione porte, come spiegato più sotto.
Installare Geyser e Floodgate
Scaricare GeyserMC
Apri geysermc.org e clicca su Download.
Scegli il file adatto al tuo server.
| Il tuo server | File da scaricare |
|---|---|
| Paper, Spigot, Purpur | Geyser-Spigot.jar |
| BungeeCord, Waterfall | Geyser-BungeeCord.jar |
| Velocity | Geyser-Velocity.jar |
| Fabric | Geyser-Fabric.jar |
| NeoForge | Geyser-NeoForge.jar |
Scaricare Floodgate
Su geysermc.org, apri la scheda Floodgate e scarica il file del tuo server.
| Il tuo server | File da scaricare |
|---|---|
| Paper, Spigot, Purpur | Floodgate-Spigot.jar |
| BungeeCord, Waterfall | Floodgate-BungeeCord.jar |
| Velocity | Floodgate-Velocity.jar |
| Fabric | Floodgate-Fabric.jar |
Mettere i file sul server
Accedi a OuiPanel e seleziona il tuo server Minecraft.
Nel menu laterale, apri Gestione file, poi la cartella
plugins(omodscon Fabric).Trascina
Geyser-Spigot.jareFloodgate-Spigot.jardal computer sulla pagina. Non c'è un pulsante di invio.Rilasciali quando appare il riquadro «Trascina i tuoi file qui».

Con Paper, Spigot o Purpur, puoi anche cercare Geyser e Floodgate nella pagina Plugin, scheda Catalogo, e cliccare su Installa.
Primo avvio
In Console, avvia il server e attendi la fine del caricamento.
Controlla che Geyser e Floodgate vengano caricati.
[INFO]: [Geyser-Spigot] Loading Geyser version X.X.X...
[INFO]: [Geyser-Spigot] Geyser is now ready to accept Bedrock connections!
[INFO]: [Floodgate] Floodgate has been enabled!
Poi ferma il server prima di configurarlo. Questo primo avvio ha creato i file di configurazione.
Aggiungere una porta per Bedrock
Nel menu laterale, apri Configurazione › Gestione porte. La pagina «Porte di rete» indica quante porte permette la tua offerta.
Clicca su Assegna una nuova porta. Il pannello sceglie il numero e la aggiunge subito, senza finestra di conferma.
Annota il numero della nuova porta.
Clicca su Modifica nota sotto questa porta e scrivi, per esempio, «Porta Bedrock GeyserMC».

La porta Bedrock predefinita è 19132, ma OuiPanel assegna quasi sempre un altro numero. È quello da mettere in Geyser e quello che useranno i giocatori.
Configurare Geyser e Floodgate
Aprire la configurazione di Geyser
In Gestione file, apri il file seguente, modificalo nella finestra di modifica e clicca su Salva.
/plugins/Geyser-Spigot/config.yml
Impostare la porta Bedrock
Trova la sezione bedrock: e inserisci la tua porta.
bedrock:
# L'indirizzo su cui Geyser è in ascolto
address: 0.0.0.0
# La porta Bedrock (sostituiscila con la porta assegnata)
port: 19132
# Riprendere la porta del server Java (lasciare false qui)
clone-remote-port: false
# MOTD mostrato ai giocatori Bedrock
motd1: "Il Mio Server Minecraft"
motd2: "Crossplay Java & Bedrock!"
# Nome del server nell'elenco
server-name: "Il Mio Server"
Sostituisci
19132con la porta ottenuta in Gestione porte.
Impostare la connessione al server Java
Trova la sezione remote:.
remote:
# L'indirizzo del server Java (di solito rilevato da solo)
address: auto
# La porta del server Java
port: 25565
# Tipo di autenticazione
auth-type: floodgate
| Parametro | Valore | Spiegazione |
|---|---|---|
address | auto | rilevamento automatico (consigliato) |
port | 25565 | porta del tuo server Java |
auth-type | floodgate | usa Floodgate per l'autenticazione |
Opzioni utili
# Chiave condivisa con Floodgate
floodgate-key-file: key.pem
# Suggerire i comandi ai giocatori Bedrock
command-suggestions: true
# Mostrare le coordinate ai giocatori Bedrock
show-coordinates: true
# Modalità debug (da disattivare in produzione)
debug-mode: false
# Numero massimo di giocatori Bedrock mostrati
max-players: 100
# Statistiche anonime
metrics:
enabled: true
Esempio di config.yml completo
bedrock:
address: 0.0.0.0
port: 19132 # Sostituisci con la tua porta!
clone-remote-port: false
motd1: "Il Mio Server Crossplay"
motd2: "Java & Bedrock insieme!"
server-name: "IlMioServer"
compression-level: 6
enable-proxy-protocol: false
remote:
address: auto
port: 25565
auth-type: floodgate
floodgate-key-file: key.pem
command-suggestions: true
passthrough-motd: true
passthrough-player-counts: true
legacy-ping-passthrough: false
max-players: 100
show-coordinates: true
emote-offhand-workaround: "disabled"
cache-images: 0
allow-custom-skulls: true
add-non-bedrock-items: true
above-bedrock-nether-building: false
force-resource-packs: true
xbox-achievements-enabled: false
Configurare Floodgate
Apri il file seguente.
/plugins/floodgate/config.yml
# Prefisso aggiunto ai nomi Bedrock (evita i conflitti)
username-prefix: "."
# Sostituire gli spazi nei nomi (i nomi Bedrock possono contenerne)
replace-spaces: "_"
# Modalità debug
debug-mode: false
# Database degli account collegati
player-link:
enabled: true
type: sqlite
Con il prefisso
., un giocatore Bedrock di nome Steve compare come.Stevesul server. Così non si crea conflitto con un giocatore Java dallo stesso nome.
Riavviare e verificare
In Console, clicca su Avvia e attendi la fine del caricamento.
Controlla che Geyser sia in ascolto sulla tua porta.
[INFO]: [Geyser-Spigot] Loading Geyser...
[INFO]: [Geyser-Spigot] Geyser version X.X.X
[INFO]: [Geyser-Spigot] Listening on /0.0.0.0:19132
[INFO]: [Geyser-Spigot] Geyser is now ready to accept Bedrock connections!
[INFO]: [Floodgate] Floodgate has been enabled!
Lanciare il comando geyser connectiontest
Nella console, digita questo comando, senza barra.
geyser connectiontest IP:PORT
Con un indirizzo di esempio, diventa così.
geyser connectiontest 203.0.113.10:19132
Se tutto va bene, Geyser risponde così.
[Geyser] Connection test successful!
Collegare i giocatori Bedrock
I giocatori Bedrock usano l'indirizzo IP del server e la porta Bedrock. L'indirizzo si trova in Vista Globale, scheda Indirizzo di connessione (Indirizzo principale). Tieni solo la parte prima dei due punti e indica la porta Bedrock a parte.
| Informazione | Valore |
|---|---|
| Indirizzo | l'IP del tuo server |
| Porta | la porta Bedrock assegnata |

La porta Bedrock non è la porta Java. Un giocatore Bedrock che usa la porta Java non riesce a connettersi.
Da Windows 10/11
Avvia Minecraft per Windows (Bedrock Edition).
Clicca su Gioca, poi su Server e Aggiungi server.
Dai un nome al server, poi inserisci l'IP del server e la porta Bedrock.
Clicca su Salva, seleziona il server, poi Unisciti al server.
Da smartphone o tablet (iOS, Android)
Avvia Minecraft sul tuo dispositivo.
Tocca Gioca, poi Server e Aggiungi server.
Inserisci indirizzo e porta, poi salva ed entra.
Da una Xbox
Su Xbox, i server personalizzati non sono raggiungibili direttamente. Ci sono due soluzioni, BedrockConnect (modifica DNS) o l'app MC Server Connector del Microsoft Store.
Il metodo DNS (BedrockConnect) funziona così.
Sulla Xbox, apri Impostazioni, Rete, poi Impostazioni avanzate.
In Impostazioni DNS, scegli Manuale.
Inserisci il DNS primario
104.238.130.180e il DNS secondario8.8.8.8.Riavvia Minecraft.
Nella scheda Server, clicca su un server in evidenza. Un menu ti permette allora di inserire l'IP del tuo server.
Da una Nintendo Switch
Il metodo è lo stesso della Xbox.
Apri Impostazioni di sistema, Internet, poi Impostazioni Internet.
Seleziona la tua rete, poi Modifica impostazioni.
In Impostazioni DNS, scegli Manuale e inserisci il DNS primario
104.238.130.180.Poi segui gli stessi passi della Xbox.
Da una PlayStation
La PlayStation è più restrittiva. Serve un relay (proxy) sulla tua rete locale.
Installa BedrockConnect o Phantom su un PC della stessa rete.
Configura il relay.
Imposta i DNS della PlayStation sull'IP di quel PC.
Comandi di GeyserMC
Nella console di OuiPanel, digita questi comandi senza barra.
| Comando | Descrizione |
|---|---|
geyser reload | ricarica la configurazione |
geyser version | mostra la versione di Geyser |
geyser dump | crea un rapporto di diagnostica |
geyser statistics | mostra le statistiche |
geyser connectiontest IP:PORT | verifica la connessione Bedrock |
geyser list | elenca i giocatori Bedrock connessi |
In gioco, i giocatori hanno questi comandi.
| Comando | Descrizione |
|---|---|
/geyser help | elenca i comandi disponibili |
/geyser offhand | scambia l'oggetto della mano secondaria |
/geyser advancements | apre il menu dei progressi |
/geyser statistics | apre il menu delle statistiche |
/geyser settings | apre le impostazioni di Geyser |
La documentazione completa è sulla wiki di GeyserMC. Il progetto ha anche un Discord e un repository GitHub.
Se i giocatori Bedrock non riescono a connettersi
| Causa | Soluzione |
|---|---|
| Porta sbagliata | confronta la porta di config.yml con quella di Gestione porte |
| Porta assente | controlla in Gestione porte che la porta Bedrock esista |
| IP sbagliato | usa l'IP dell'Indirizzo principale del server |
| Protocollo | la porta Bedrock deve essere raggiungibile in UDP |
Errore «Unable to connect to world»
Controlla che il server sia avviato.
Controlla nel registro della console che Geyser sia caricato.
Lancia
geyser connectiontest.Controlla che la porta sia giusta.
Errore «Disconnected from server»
Controlla
auth-type: floodgatenella configurazione di Geyser.Controlla che Floodgate sia installato e attivo.
Controlla che
key.pemesista nella cartella di Floodgate.
Errore «Invalid credentials»
Controlla che
auth-typevalgafloodgate.Riavvia il server.
Elimina e ricrea i file
key.pem.
Le skin Bedrock si vedono male
È un limite noto. Il plugin SkinsRestorer aiuta lato Java, ma le skin Bedrock personalizzate non funzionano su Java.
Problema di chat (dalla 1.19.1)
Dalla versione 1.19.1, aggiungi questa riga in server.properties, oppure installa il plugin NoEncryption o FreedomChat.
enforce-secure-profile=false
Limiti del crossplay e buone pratiche
| Funzione | Java | Bedrock tramite Geyser |
|---|---|---|
| Combo PvP | native | diverse |
| Redstone | completa | piccole differenze |
| Alcuni blocchi | tutti | aspetto diverso |
| Comandi | tutti | sintassi a volte diversa |
| Schermata F3 (debug) | sì | no |
| Mod | sì, su un server moddato | no |
Esplorazione, costruzione, sopravvivenza, avventura, minigiochi semplici, chat e plugin comuni (economia…) funzionano bene. PvP competitivo, meccanismi complessi a pistoni o redstone, alcuni plugin avanzati e i resource pack personalizzati possono dare problemi.
| Pratica | Motivo |
|---|---|
| Usare Floodgate | non richiedere un account Java |
**Definire un prefisso (.)** | evitare conflitti di nomi |
| Provare con regolarità | verificare che il crossplay funzioni |
| Aggiornare Geyser | ricevere correzioni e novità |
Ai giocatori, consiglia di tenere lo stesso nome, segnalare i bug e accettare che alcune meccaniche siano diverse.
Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.
Scopri le nostre offerte di hosting Minecraft a partire da 1,99€/mese con installazione automatica delle mod.
Hosting server Minecraft →