Risolvere i timeout su un server Minecraft moddato
I tuoi giocatori tornano al menu con «Timed out» o «Read timed out» prima di entrare nel tuo server Minecraft moddato? Questa guida ti mostra come risolvere i timeout allungando il tempo di attesa su Forge, NeoForge e Fabric, sul server e sul client. Ti mostra anche dove modificare il comando di avvio in OuiPanel, il pannello di gioco di OuiHeberg.
Comprendere i timeout
Il problema delle disconnessioni
Le interruzioni di connessione per timeout sono uno dei problemi più comuni sui server Minecraft con modpack corposi. Lo scenario tipico: avvii il gioco, provi a entrare nel server e, dopo una lunga attesa, il gioco ti rimanda al menu principale con un errore di tempo scaduto.
La causa è di solito il tempo necessario per caricare molte mod e sincronizzarsi con il server. Qualche impostazione o la mod giusta bastano in genere a ritrovare una connessione stabile.
Come funzionano i timeout
Minecraft concede circa mezzo minuto alle operazioni critiche: inizializzazione delle mod, connessione al server, trasferimento dei dati di sincronizzazione. Basta per un'installazione vanilla. Con le mod diventa presto troppo poco.
Origini del problema
Fattori scatenanti
I timeout sono più frequenti in queste situazioni.
| Situazione | Impatto |
|---|---|
| Modpack voluminoso (oltre 100 mod) | Molto alto |
| Connessione di rete instabile o lenta | Alto |
| Macchina con risorse limitate (RAM, CPU) | Alto |
| Mod che richiedono un'elaborazione intensa | Moderato |
| Server saturo o configurato male | Moderato |
Diagnosi rapida
Il messaggio di errore indica da dove viene il problema.
| Messaggio | Causa probabile |
|---|---|
Timed out o Read timed out | Timeout superato |
Connection lost | Rete instabile o timeout |
| Crash con una traccia di errore completa (stacktrace) | Conflitto tra mod o incompatibilità |
Missing mod | Mod mancante sul client o sul server, installazione incompleta |
Soluzioni per modloader
La correzione dipende dal caricatore di mod. Forge e NeoForge accettano argomenti JVM o una mod dedicata. Fabric usa una mod propria.
Argomenti JVM per Forge e NeoForge
È il metodo consigliato. Allunga il tempo di attesa da mezzo minuto a due minuti, aggiungendo questi argomenti al comando di avvio.
-Dfml.readTimeout=120 -Dfml.loginTimeout=120
Questi parametri danno a Forge e NeoForge più tempo durante il caricamento e l'autenticazione. Le interruzioni diventano molto più rare con i modpack corposi. Il valore si esprime in secondi.
Gli argomenti devono stare tra java e -jar perché la JVM li legga.
# Struttura corretta
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
# Posizione errata (non funzionerà)
java -Xms4G -Xmx8G -jar server.jar -Dfml.readTimeout=120 nogui
Allungare i timeout non peggiora le prestazioni. Fissa solo l'attesa massima prima di considerare fallita un'operazione, senza effetti su CPU, memoria o banda.
Gli argomenti
-Dfml.readTimeoute-Dfml.loginTimeoutsono riconosciuti solo da Forge e NeoForge. Un'installazione vanilla li ignora. In vanilla i timeout sono rari e di solito dipendono dalla rete.
Mod TimeoutFixes per Forge e NeoForge
Per evitare ogni intervento tecnico, installa la mod TimeoutFixes. È compatibile con Forge e NeoForge e regola i timeout da sola. Va installata sul server e sul client.
Mod TimeOutOut per Fabric
Fabric ha la sua soluzione, senza argomenti JVM da modificare. La mod TimeOutOut aumenta i timeout di connessione per evitare disconnessioni durante l'inizializzazione delle mod. È pensata per Fabric, i suoi tempi si regolano liberamente e in multiplayer va installata sul client e sul server.
Una mod di timeout installata da un solo lato può causare comportamenti imprevedibili. Sul tuo server OuiHeberg, aggiungila dal Mods Manager o trascina il suo file .jar nella cartella mods. La guida Come installare mod sul tuo server Minecraft (Forge/Fabric) spiega i due metodi.
Configurazione server
In OuiPanel
Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server.
Apri Configurazione › Impostazioni del server.
Nella scheda Avvio del server, clicca su Modifica il comando di avvio.
Nella finestra «Modifica del comando di avvio», aggiungi
-Dfml.readTimeout=120 -Dfml.loginTimeout=120subito dopojava, prima di-jar.Clicca su Salva.
Nella Console, clicca su Riavvia, poi controlla il log di avvio.
Per esempio, un comando di questo tipo:
java -Xms4G -Xmx8G -jar server.jar nogui
diventa:
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui

Un comando di avvio modificato male può impedire al server di partire. Copia il comando originale prima di toccarlo, così potrai ripristinarlo.
Con l'offerta Minecraft gratuita il comando di avvio non è modificabile. Il pannello mostra allora «Comando di avvio modificabile con un piano premium».
Sulla tua macchina
Se gestisci un server tuo, crea uno script di avvio dedicato.
Linux (start.sh):
#!/bin/bash
java -Dfml.readTimeout=120 \
-Dfml.loginTimeout=120 \
-Xms4G \
-Xmx8G \
-XX:+UseG1GC \
-XX:+ParallelRefProcEnabled \
-XX:MaxGCPauseMillis=200 \
-jar server.jar nogui
Windows (start.bat):
@echo off
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
pause
In ogni caso, salva la configurazione, riavvia completamente il server e verifica nei log che i parametri siano applicati.
Configurazione client
Anche i giocatori possono allungare il tempo di attesa dal loro lato, nel launcher.
Launcher ufficiale Minecraft
Apri il launcher Minecraft e vai alla scheda Installazioni.
Seleziona il profilo del tuo modpack.
Clicca su Altre opzioni per mostrare le impostazioni avanzate.
Nel campo Argomenti JVM, completa i parametri esistenti come qui sotto.
Clicca su Salva, poi avvia il gioco con questo profilo.
-Xms4G -Xmx8G -Dfml.readTimeout=120 -Dfml.loginTimeout=120
CurseForge
Apri le Impostazioni dell'applicazione.
Seleziona la sezione Minecraft.
Nel campo Argomenti Java aggiuntivi, aggiungi
-Dfml.readTimeout=120 -Dfml.loginTimeout=120.
Prism Launcher e MultiMC
Clicca con il tasto destro sull'istanza.
Scegli Modifica (o Edit Instance).
Apri la scheda Impostazioni, poi Java.
Inserisci gli argomenti nel campo previsto.
ATLauncher
Apri Settings (impostazioni).
Apri la scheda Java/Minecraft.
Aggiungi gli argomenti in Extra JVM Arguments.
GDLauncher
Clicca sull'icona delle impostazioni (ingranaggio).
Seleziona Java.
Compila il campo Additional Arguments.
Diagnosi e risoluzione avanzata
Verificare che i parametri siano applicati
Controlla i log di avvio del server. In OuiPanel, apri logs/latest.log dalla Gestione file, oppure segui la Console. Sulla tua macchina, questo comando trova le righe utili.
# Cerca nei log
grep -i "timeout" logs/latest.log
Buoni segnali: nessun messaggio «Timed out» quando i giocatori si collegano, e connessioni più lunghe ma riuscite.
Regolare i valori a passi
Parti da 120, cioè due minuti, adatto alla maggior parte delle configurazioni. Se le disconnessioni continuano, sali a passi di 60, un minuto in più ogni volta.
| Livello | Valore | Caso d'uso |
|---|---|---|
| Standard | 120 (2 minuti) | Modpack classici (da 50 a 100 mod) |
| Esteso | 180 (3 minuti) | Modpack grandi (da 100 a 200 mod) |
| Massimo | 240 (4 minuti) | Modpack enormi (oltre 200 mod) |
| Estremo | 300 (5 minuti) | Configurazioni molto lente |
Esempio con il tempo esteso:
-Dfml.readTimeout=180 -Dfml.loginTimeout=180
Oltre 300, cioè cinque minuti, il problema riguarda più il modpack o l'hardware che il tempo di attesa. Ottimizza il modpack invece di allungare ancora.
Leggere i messaggi di errore
| Messaggio | Significato | Soluzione |
|---|---|---|
io.netty.handler.timeout.ReadTimeoutException | Timeout di lettura superato | Aumentare readTimeout |
Login timed out | Autenticazione troppo lenta | Aumentare loginTimeout |
Connection reset | Connessione interrotta | Verificare la stabilità della rete |
Internal Exception | Errore interno | Leggere lo stacktrace completo |
Se il problema persiste
Verifica nei log che i parametri siano applicati.
Testa la tua connessione di rete (ping, stabilità).
Togli alcune mod temporaneamente per trovare quella che crea problemi.
Aumenta le risorse assegnate, la RAM in particolare.
Aggiorna tutte le mod all'ultima versione.
Ottimizzazioni complementari
Mod di prestazioni
Allungare i timeout a volte è solo un palliativo. Per risolvere il problema alla radice, installa mod di ottimizzazione.
| Mod | Effetto | Caricatori |
|---|---|---|
| ModernFix | Ottimizza la gestione della memoria e accelera il caricamento delle risorse. Riduce nettamente il tempo di avvio. | Forge, NeoForge, Fabric |
| FerriteCore | Riduce molto il consumo di RAM nelle installazioni grandi, fino al 50% di RAM risparmiata. | Forge, NeoForge, Fabric |
| LazyDFU | Rinvia l'inizializzazione di DataFixerUpper per un avvio più rapido. | Forge, Fabric |
Stabilizzazione della rete
La mod Connectivity ottimizza il protocollo di rete. Migliora la gestione delle connessioni e riduce le disconnessioni dovute all'instabilità. Funziona con Forge e NeoForge.
Connectivity non può convivere con TimeoutFixes. Scegli l'una o l'altra in base al tuo problema principale.
Configurazione di rete del server
In server.properties:
# Aumentare se necessario
max-tick-time=120000
network-compression-threshold=256
In spigot.yml, se il tuo server ne ha uno:
settings:
timeout-time: 120
restart-on-crash: true
In OuiPanel, server.properties si modifica in Configurazione › Editor proprietà, oppure aprendo il file nella Gestione file.
Il parametro
player-idle-timeoutdiserver.propertiesnon c'entra con questi errori. Espelle i giocatori inattivi dopo il numero di minuti indicato, eplayer-idle-timeout=0disattiva l'espulsione.
Risorse utili
Documentazione
Strumenti di diagnosi
Comunità
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 →