OuiPanelPubblicato il 16 dicembre 2025Lettura di 9 min

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

PiattaformaSupporto
Windows 10/11 (Bedrock)completo
iOS (iPhone, iPad)completo
Androidcompleto
Xboxcompleto, con il metodo DNS descritto più sotto
Nintendo Switchcompleto, con il metodo DNS descritto più sotto
PlayStation 4/5configurazione speciale necessaria
Java Editionnativo, 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

PluginRuoloStato
GeyserMCtraduce il protocollo Bedrock verso Javaobbligatorio
Floodgatefa entrare i giocatori Bedrock senza account Javaconsigliato
ViaVersionaccetta versioni più vecchie di Minecraftfacoltativo

Senza Floodgate, ogni giocatore Bedrock avrebbe bisogno di un account Minecraft Java Edition per entrare.

Un software compatibile

SoftwareSupportoFile di Geyser
PaperconsigliatoGeyser-Spigot.jar
SpigotcompletoGeyser-Spigot.jar
PurpurcompletoGeyser-Spigot.jar
BungeeCordcompletoGeyser-BungeeCord.jar
VelocitycompletoGeyser-Velocity.jar
FabriccompletoGeyser-Fabric.jar
NeoForgecompletoGeyser-NeoForge.jar
Vanillanon supportatonessuno

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, 25565 di default (TCP), per i giocatori Java.

  • Porta Bedrock, 19132 di 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

  1. Apri geysermc.org e clicca su Download.

  2. Scegli il file adatto al tuo server.

Il tuo serverFile da scaricare
Paper, Spigot, PurpurGeyser-Spigot.jar
BungeeCord, WaterfallGeyser-BungeeCord.jar
VelocityGeyser-Velocity.jar
FabricGeyser-Fabric.jar
NeoForgeGeyser-NeoForge.jar

Scaricare Floodgate

Su geysermc.org, apri la scheda Floodgate e scarica il file del tuo server.

Il tuo serverFile da scaricare
Paper, Spigot, PurpurFloodgate-Spigot.jar
BungeeCord, WaterfallFloodgate-BungeeCord.jar
VelocityFloodgate-Velocity.jar
FabricFloodgate-Fabric.jar

Mettere i file sul server

  1. Accedi a OuiPanel e seleziona il tuo server Minecraft.

  2. Nel menu laterale, apri Gestione file, poi la cartella plugins (o mods con Fabric).

  3. Trascina Geyser-Spigot.jar e Floodgate-Spigot.jar dal computer sulla pagina. Non c'è un pulsante di invio.

  4. Rilasciali quando appare il riquadro «Trascina i tuoi file qui».

Riquadro Trascina i tuoi file qui durante un trascinamento in Gestione file

Con Paper, Spigot o Purpur, puoi anche cercare Geyser e Floodgate nella pagina Plugin, scheda Catalogo, e cliccare su Installa.

Primo avvio

  1. In Console, avvia il server e attendi la fine del caricamento.

  2. 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

  1. Nel menu laterale, apri Configurazione › Gestione porte. La pagina «Porte di rete» indica quante porte permette la tua offerta.

  2. Clicca su Assegna una nuova porta. Il pannello sceglie il numero e la aggiunge subito, senza finestra di conferma.

  3. Annota il numero della nuova porta.

  4. Clicca su Modifica nota sotto questa porta e scrivi, per esempio, «Porta Bedrock GeyserMC».

Pagina Porte di rete con più porte, le loro note e il pulsante Assegna una nuova porta

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 19132 con 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
ParametroValoreSpiegazione
addressautorilevamento automatico (consigliato)
port25565porta del tuo server Java
auth-typefloodgateusa 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 .Steve sul server. Così non si crea conflitto con un giocatore Java dallo stesso nome.


Riavviare e verificare

  1. In Console, clicca su Avvia e attendi la fine del caricamento.

  2. 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.

InformazioneValore
Indirizzol'IP del tuo server
Portala porta Bedrock assegnata

Vista globale con la scheda Indirizzo di connessione, l'indirizzo principale e l'indirizzo alternativo

La porta Bedrock non è la porta Java. Un giocatore Bedrock che usa la porta Java non riesce a connettersi.

Da Windows 10/11

  1. Avvia Minecraft per Windows (Bedrock Edition).

  2. Clicca su Gioca, poi su Server e Aggiungi server.

  3. Dai un nome al server, poi inserisci l'IP del server e la porta Bedrock.

  4. Clicca su Salva, seleziona il server, poi Unisciti al server.

Da smartphone o tablet (iOS, Android)

  1. Avvia Minecraft sul tuo dispositivo.

  2. Tocca Gioca, poi Server e Aggiungi server.

  3. 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ì.

  1. Sulla Xbox, apri Impostazioni, Rete, poi Impostazioni avanzate.

  2. In Impostazioni DNS, scegli Manuale.

  3. Inserisci il DNS primario 104.238.130.180 e il DNS secondario 8.8.8.8.

  4. Riavvia Minecraft.

  5. 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.

  1. Apri Impostazioni di sistema, Internet, poi Impostazioni Internet.

  2. Seleziona la tua rete, poi Modifica impostazioni.

  3. In Impostazioni DNS, scegli Manuale e inserisci il DNS primario 104.238.130.180.

  4. Poi segui gli stessi passi della Xbox.

Da una PlayStation

La PlayStation è più restrittiva. Serve un relay (proxy) sulla tua rete locale.

  1. Installa BedrockConnect o Phantom su un PC della stessa rete.

  2. Configura il relay.

  3. Imposta i DNS della PlayStation sull'IP di quel PC.


Comandi di GeyserMC

Nella console di OuiPanel, digita questi comandi senza barra.

ComandoDescrizione
geyser reloadricarica la configurazione
geyser versionmostra la versione di Geyser
geyser dumpcrea un rapporto di diagnostica
geyser statisticsmostra le statistiche
geyser connectiontest IP:PORTverifica la connessione Bedrock
geyser listelenca i giocatori Bedrock connessi

In gioco, i giocatori hanno questi comandi.

ComandoDescrizione
/geyser helpelenca i comandi disponibili
/geyser offhandscambia l'oggetto della mano secondaria
/geyser advancementsapre il menu dei progressi
/geyser statisticsapre il menu delle statistiche
/geyser settingsapre 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

CausaSoluzione
Porta sbagliataconfronta la porta di config.yml con quella di Gestione porte
Porta assentecontrolla in Gestione porte che la porta Bedrock esista
IP sbagliatousa l'IP dell'Indirizzo principale del server
Protocollola porta Bedrock deve essere raggiungibile in UDP

Errore «Unable to connect to world»

  1. Controlla che il server sia avviato.

  2. Controlla nel registro della console che Geyser sia caricato.

  3. Lancia geyser connectiontest.

  4. Controlla che la porta sia giusta.

Errore «Disconnected from server»

  1. Controlla auth-type: floodgate nella configurazione di Geyser.

  2. Controlla che Floodgate sia installato e attivo.

  3. Controlla che key.pem esista nella cartella di Floodgate.

Errore «Invalid credentials»

  1. Controlla che auth-type valga floodgate.

  2. Riavvia il server.

  3. 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

FunzioneJavaBedrock tramite Geyser
Combo PvPnativediverse
Redstonecompletapiccole differenze
Alcuni blocchituttiaspetto diverso
Comandituttisintassi a volte diversa
Schermata F3 (debug)sìno
Modsì, su un server moddatono

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.

PraticaMotivo
Usare Floodgatenon richiedere un account Java
**Definire un prefisso (.)**evitare conflitti di nomi
Provare con regolaritàverificare che il crossplay funzioni
Aggiornare Geyserricevere 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.

Questo articolo ti è stato utile?

1498 visualizzazioni
Condividi questo articolo
Minecraft
Hai bisogno di un server Minecraft?

Scopri le nostre offerte di hosting Minecraft a partire da 1,99€/mese con installazione automatica delle mod.

Hosting server Minecraft →

Articoli correlati