Un server Minecraft calcola il mondo in tick, 20 volte al secondo. Se un tick dura troppo o la memoria RAM si esaurisce, il server scrive degli avvisi nel log o, nel peggiore dei casi, si arresta. Ogni sezione qui sotto spiega uno di questi messaggi: come riconoscerlo, quanto è grave e cosa puoi fare. Prima trovi i messaggi dopo i quali il server va in crash o viene arrestato, poi gli avvisi con cui continua a funzionare.
Il messaggio completo si trova nella Console oppure in File, in logs/latest.log; i report dei crash sono nella cartella crash-reports/. Leggi sempre anche le righe precedenti: spesso indicano cosa ha rallentato il server. Prima di modificare i file di configurazione o del mondo, crea un backup in Backup.
«A single server tick took … seconds»: il Watchdog arresta il server
Ecco come appare il messaggio:
The server has not responded for <Sekunden> seconds! Creating thread dump
A single server tick took 60.00 seconds (should be max 0.05)
Cosa significa: il Watchdog controlla che il server stia ancora lavorando. Se un tick, cioè un passaggio della simulazione di gioco, dura troppo, arresta il server bloccato e il gioco si interrompe. Prima di farlo, Paper scrive dei messaggi intermedi con un thread dump, un'istantanea del lavoro in corso: se il server si riprende in tempo, continua a funzionare. Le cause più comuni sono la pressione sulla memoria o un plugin o una mod particolarmente pesanti.
Come risolvere:
- In File, apri
logs/latest.loge leggi le righe prima del primo messaggio del Watchdog. Se troviStopping server, cerca di capire cosa sta bloccando lo spegnimento. - Guarda le prime righe sotto
Server threadnel thread dump. Con Vanilla, Fabric e NeoForge si trova nel report del crash incrash-reports/. Il nome di un plugin o di una mod indica cosa ha tenuto impegnato il server per ultimo. - Controlla la memoria RAM.
OutOfMemoryError: Java heap spacesignifica che la memoria di Java è esaurita; in quel caso controlla anche cosa la sta occupando. - Arresta il server prima di modificare i file. Aggiorna il plugin interessato in Plugin o la mod in Mod, oppure rimuovili per prova, riavvia e controlla di nuovo.
Approfondimento: come risolvere correttamente «Can't keep up» e il timeout del Watchdog
«Java heap space»: la memoria del server è esaurita
Ecco come appare il messaggio:
An exception 'java.lang.OutOfMemoryError: Java heap space' … exceptionCaught() …
[spark] Exception occurred while rotating profiler job … java.lang.OutOfMemoryError: Java heap space
An unexpected error while handling a WorldEdit command … java.lang.OutOfMemoryError: Java heap space
Cosa significa: Java gestisce la memoria del server in un'area chiamata heap, che con il carico attuale si è riempita. Grandi operazioni con WorldEdit, molti chunk caricati (cioè sezioni del mondo), modpack di grandi dimensioni o plugin con molti dati possono richiedere parecchia memoria. Spesso il server va in crash o diventa instabile; può fallire anche il salvataggio dei dati del mondo o delle entità, come creature e oggetti. Il thread o il plugin indicato mostra dove è mancata la memoria, non necessariamente cosa ne consuma di più.
Come risolvere:
- Riavvia il server per terminare il processo saturo. Se il carico non cambia, l'errore può ripresentarsi.
- Calcola il fabbisogno di memoria: pianificare la RAM necessaria per Minecraft. Se il tuo pacchetto non basta, scegli più RAM in Impostazioni e abbonamento → Piano.
- Suddividi le grandi operazioni con WorldEdit e, se necessario, riduci
view-distanceinserver.properties, che trovi in File. - Dopo il riavvio, controlla la Console e le zone del mondo interessate. In caso di messaggi relativi a
chunk data (write), verifica soprattutto che l'ultimo stato sia stato salvato.
Buono a sapersi: un backup prima della prossima grande modifica al mondo ti aiuta a ripristinare le modifiche perse.
«This crash report has been saved to …»: il server è andato in crash
Ecco come appare il messaggio:
This crash report has been saved to: crash-reports/crash-<Datum>_<Uhrzeit>-server.txt
Cosa significa: il server è stato arrestato da un errore grave e ha scritto un report del crash. Il messaggio in sé indica solo dove si trova il report. La vera causa, ad esempio una mod, un plugin, il mondo o la mancanza di memoria, è riportata nel file.
Come risolvere:
- In File, apri la cartella
crash-reports/e poi il file indicato. Il suo nome contiene la data e l'ora del crash. - Leggi la prima sezione: dopo
Description:trovi una breve descrizione e, sotto, la riga dell'errore e lo stack trace, cioè l'elenco dei punti del programma che hanno portato all'errore. - Verifica che le mod o i plugin citati nell'errore siano in una versione compatibile. Aggiorna quello interessato in Mod o Plugin, oppure, dopo aver creato un backup, rimuovilo per prova.
- In caso di
OutOfMemoryError, leggi il testo aggiuntivo del messaggio. Se indicaJava heap space, la memoria di Java è piena; se la RAM acquistata è troppo poca, scegline di più in Impostazioni e abbonamento → Piano. - Avvia il server e tieni d'occhio la Console finché non è completamente operativo.
Buono a sapersi: conserva il report per la ricerca dell'errore e confronta data e ora con quelle del crash attuale. Per i server con mod: Errori delle mod sui server Forge, NeoForge e Fabric
Errore nel ciclo principale del gioco
Ecco come appare il messaggio:
Exception in server tick loop
Caused by: java.lang.<Fehlerart>: <Details>
Cosa significa: il ciclo principale calcola il mondo tick dopo tick. Un'eccezione, cioè un errore del programma, è arrivata fino a questo ciclo e lo ha interrotto. Di solito il server va in crash e scrive un report. La vera causa si trova quasi sempre nella riga Caused by immediatamente successiva.
Come risolvere:
- Cerca il messaggio in
logs/latest.logo nel report più recente incrash-reports/. - Leggi la riga
Caused bysubito sotto. Se ce ne sono più di una, di solito quella più in basso porta alla radice del problema. - Le righe con
at …riportate sotto indicano i nomi di pacchetti e file. Da questi puoi riconoscere il plugin o la mod coinvolti. - Aggiornali o rimuovili in Plugin o Mod e riavvia il server.
Buono a sapersi: questo messaggio non indica un problema di lag, ma un errore specifico. Più memoria aiuta solo se la riga Caused by riporta un OutOfMemoryError.
Approfondimento: come risolvere correttamente «Can't keep up» e il timeout del Watchdog
Memoria al limite: GC overhead limit exceeded
Ecco come appare il messaggio:
java.lang.OutOfMemoryError: GC overhead limit exceeded
Cosa significa: Java libera automaticamente la memoria che non serve più. Questo processo si chiama Garbage Collection, in breve GC. Il messaggio significa che Java passa quasi tutto il tempo a fare pulizia e recupera ormai pochissima memoria. L'heap, cioè la memoria di Java, è praticamente pieno. Il server risponde a malapena o va in crash.
Come risolvere:
- Riavvia il server.
- Calcola quanta memoria richiede la tua configurazione. Approfondimento: pianificare la RAM necessaria per Minecraft
- Se il tuo pacchetto non basta, scegli più RAM in Impostazioni e abbonamento → Piano.
- Riduci il carico di chunk ed entità: abbassa la distanza visiva
view-distanceinserver.properties, ridimensiona le grandi fattorie di animali e rimuovi gli oggetti sparsi a terra.
Buono a sapersi: un riavvio dà solo un po' di respiro. Se dopo ogni riavvio il consumo sale costantemente fino al limite pur con un carico invariato, è possibile che un plugin o una mod stia trattenendo memoria.
«unable to create native thread»: Java non riesce ad avviare altri thread
Ecco come appare il messaggio:
java.lang.OutOfMemoryError: unable to create native thread: possibly out of memory or process/resource limits reached
Cosa c'è dietro: un thread è un flusso di lavoro parallelo e Java non è riuscito ad avviarne un altro. I possibili colli di bottiglia sono troppi thread simultanei, un limite di processi raggiunto o la mancanza di memoria nativa al di fuori dell'heap Java, la memoria riservata agli oggetti Java. Le nuove attività possono fallire e il server può diventare instabile. Il nome di un plugin nell'errore indica innanzitutto durante quale attività non è riuscito l'avvio del thread; per individuare la causa servono misurazioni adeguate durante l'esecuzione.
Come risolvere:
- Annota l'ora e salva le righe corrispondenti di
logs/latest.lognella sezione File, compresi i messaggi precedenti e successivi. - Controlla il numero di thread, il limite di processi e la memoria nativa al momento dell'errore. Se non hai questi dati operativi, apri un ticket e indica l'ora del messaggio.
- Confronta i valori misurati con le attività in esecuzione. Aggiorna un plugin in Plugin o una mod in Mod solo quando i valori misurati confermano il collegamento; controlla anche le relative impostazioni.
- Se il server non è più utilizzabile, riavvialo dopo aver salvato le righe dell'errore. Controlla nella Console se l'errore si ripresenta.
Buono a sapersi: aumentare l'heap Java non risolve l'esaurimento del limite di thread o di processi. Per saperne di più su spark: spark: trovare e capire il lag.
«Can't keep up»: il server non riesce a stare al passo con i tick
Ecco come appare il messaggio:
Can't keep up! Is the server overloaded? Running <Zeit>ms or <Ticks> ticks behind
Can't keep up! Did the system time change, or is the server overloaded? Running <Zeit>ms behind, skipping <Ticks> tick(s)
Cosa c'è dietro: normalmente Minecraft calcola 20 tick al secondo, quindi ogni tick ha a disposizione 50 millisecondi. Se queste operazioni richiedono troppo tempo, si accumula un ritardo che il messaggio indica in millisecondi e tick. Il server continua a funzionare, ma è sensibilmente più lento: i blocchi distrutti ricompaiono e i mob si muovono a scatti. Di solito la causa è una carenza di memoria o un carico eccessivo sulla CPU; singoli messaggi possono comparire all'avvio o durante la generazione di nuove aree.
Come risolvere:
- Controlla se spark è disponibile. Le versioni attuali di Paper lo includono; sugli altri server supportati devi installare la versione plugin o mod adatta.
- Durante il lag, esegui la misurazione con
spark tpsnella Console. MSPT indica i millisecondi per tick: se la durata del tick supera stabilmente il tempo a disposizione, il TPS cala. - Trova il responsabile con
spark profiler start --timeout 120e apri il link generato al termine. - A server fermo, riduci la distanza visiva
view-distancee la distanza di simulazionesimulation-distanceinserver.properties. Ridimensiona le farm più grandi o pregenera il mondo. - Verifica che la RAM sia sufficiente e riavvia il server dopo aver modificato la configurazione.
Per approfondire: come risolvere correttamente «Can't keep up» e il timeout del Watchdog
«DO NOT REPORT THIS TO PAPER»: diagnostica di un blocco del server
Ecco come appare il messaggio:
--- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ---
Server thread dump (Look for plugins here before reporting to Paper!):
Cosa c'è dietro: se il thread del server si blocca per alcuni secondi, Paper scrive una diagnostica con un thread dump, cioè un'istantanea di ciò su cui il server sta lavorando in quel momento. Nel frattempo il gioco si interrompe; dopo il blocco il server può continuare a funzionare. Se il blocco dura troppo a lungo, il Watchdog lo arresta.
Come risolvere:
- Nel dump, leggi le prime righe sotto
Server thread dump. Se compare il nome di un plugin o di una mod, è un forte indizio sul responsabile. - Arresta il server, aggiorna il plugin interessato in Plugin o la mod in Mod, oppure rimuovili temporaneamente per fare una prova, quindi riavvia.
- Se i dump si ripetono spesso, controlla la RAM, i tuoi plugin e la distanza visiva
view-distanceinserver.properties. - Se si tratta di dump isolati, ad esempio all'avvio o durante il salvataggio di un mondo molto grande, puoi tenerli d'occhio senza intervenire subito.
Per approfondire: come risolvere correttamente «Can't keep up» e il timeout del Watchdog
«ChunkTaskScheduler»: Paper è in attesa durante il caricamento o la generazione di un chunk
Ecco come appare il messaggio:
[ChunkTaskScheduler] Chunk wait task info below:
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Welt>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:initialize_light, requestedGenStatus=minecraft:full, …}
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Welt>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:full, requestedGenStatus=null, …, currentChunkStatus=FULL, …}
Cosa c'è dietro: Paper ha atteso a lungo il caricamento o la generazione di un chunk, una sezione del mondo di 16 × 16 blocchi, e ha scritto una diagnostica; nel frattempo il server si inceppa. currentGenStatus mostra lo stato raggiunto, requestedGenStatus l'obiettivo; con null non è registrato alcun obiettivo di generazione e nel report possono comparire anche chunk già completati. Di solito la causa è un sovraccarico: generazione del mondo, molti giocatori distanti tra loro o plugin lenti. Più raramente è danneggiata una regione.
Come risolvere:
- In File, riduci la distanza visiva
view-distanceinserver.propertiese riavvia il server. - Pregenera il mondo: Chunky: pregenerare il mondo di Minecraft.
- Se spark è disponibile, analizza il carico durante il problema con
spark profiler start --timeout 120nella Console. Il report mostra quali processi richiedono tempo. - Se il problema riguarda ripetutamente lo stesso mondo e le stesse coordinate di chunk, controlla nelle righe di log circostanti se ci sono errori di caricamento di quella regione. Se il danno è confermato, arresta il server, salva lo stato attuale e ripristina un backup integro in Backup. Le modifiche successive a quel backup andranno perse.
Buono a sapersi: coordinate molto grandi indicano viaggi lontano dal centro del mondo. Un confine del mondo adeguato limita ulteriori esplorazioni.
«The server has stopped responding»: il Watchdog di Paper segnala un blocco
Ecco come appare il messaggio:
The server has stopped responding! This is (probably) not a Paper bug.
If you see a world save or edit, then it means you did far more than your server can handle at once
If this is the case, consider increasing timeout-time in spigot.yml but note that this will replace the crash with LARGE lag spikes
Cosa c'è dietro: queste righe fanno parte del blocco informativo del Watchdog di Paper, che rileva un blocco prolungato del thread principale, cioè il flusso di lavoro che gestisce il gioco. Durante il blocco il gioco resta fermo; se il blocco persiste, il Watchdog arresta il server. Le cause tipiche sono plugin sovraccarichi, grandi operazioni sul mondo o accessi HTTP e al database bloccanti. Il thread dump sottostante mostra le chiamate di programma in esecuzione in quel momento.
Come risolvere:
- Leggi il thread dump in
logs/latest.lognella sezione File. Controlla se sono disponibili aggiornamenti per i plugin citati; modificane la configurazione o rimuovili temporaneamente per fare una prova a server fermo. - Se il dump mostra modifiche al mondo o salvataggi, suddividi le operazioni di grandi dimensioni, ad esempio con WorldEdit, in passaggi più piccoli.
- Se mostra accessi HTTP o MySQL, controlla la connessione del plugin coinvolto e la raggiungibilità del servizio.
- Aumentare
timeout-timeinspigot.ymlprolunga il tempo di attesa, ma non elimina il blocco. - Se i blocchi si ripetono, riduci il carico dei plugin e controlla la RAM.
Per approfondire: come risolvere correttamente «Can't keep up» e il timeout del Watchdog
BootstrapMethodError: attività di Paper per le sezioni del mondo non riuscita
Ecco come appare il messaggio:
[ca.spottedleaf.concurrentutil.executor.thread.BalancedPrioritisedThreadPool] Exception thrown from thread <Thread>
java.lang.BootstrapMethodError: bootstrap method initialization exception
Cosa c'è dietro: Paper carica, genera e salva i chunk, cioè le sezioni del mondo, anche in thread separati dal gioco principale. In uno di questi thread di lavoro, Java non è riuscito a preparare un punto di chiamata nel programma e l'attività interessata non è andata a buon fine. Se nello stacktrace, l'elenco delle chiamate sotto l'errore, compare saveChunk, il problema riguarda il salvataggio di una sezione del mondo. Le possibili cause sono un bug di Paper, un'estensione incompatibile o una versione di Java non supportata.
Come risolvere:
- Aggiorna Paper in Versione a una build stabile recente della tua versione di Minecraft.
- Usa una versione di Java supportata da questa build: Quale versione di Java serve al tuo server Minecraft?
- Leggi lo stacktrace completo in
logs/latest.log. Se una rigaCaused byindica un plugin, aggiornalo in Plugin. - Non sostituire manualmente le librerie del server: è più facile che causi nuovi errori.
- Se l'errore si ripresenta dopo l'aggiornamento, segnala lo stacktrace completo al progetto Paper.
Minecraft non riesce a salvare il crash report
Ecco come appare il messaggio:
We were unable to save this crash report to disk.
Cosa c'è dietro: il messaggio riguarda la scrittura del crash report. Dopo un errore, Minecraft ha provato a salvare la diagnostica sul disco, ma non è riuscito a salvare il file del report. La causa dell'errore originale si trova più in alto nella Console; la mancanza del report rende più difficile la diagnosi successiva.
Come risolvere:
- Per prima cosa, salva l'intero blocco di errore dalla Console, comprese le righe che precedono questo messaggio.
- In File, controlla i file presenti in
crash-reports/elogs/latest.log. Leggi il messaggio specifico dell'errore di scrittura e verifica lo spazio disponibile. - Risolvi la causa indicata. Se il percorso continua a non essere scrivibile, apri un ticket indicando l'orario e l'errore di scrittura.
Il tuo messaggio non è nell'elenco?
Leggi il messaggio completo in logs/latest.log e soprattutto le righe che lo precedono: un sovraccarico ha quasi sempre un fattore scatenante che compare prima del primo avviso. Nello stacktrace o nel thread dump, i nomi dei pacchetti, cioè i nomi delle cartelle separati da punti come com.<Entwickler>.<Plugin>, e i nomi dei file come <Plugin>.jar rivelano quale plugin o mod è coinvolto. Prima di modificare i file di configurazione, crea un backup in Backup. Se non riesci ad andare avanti, apri un ticket e indica l'orario del messaggio.