Come leggere un report di crash di Minecraft

Minecraft scrive un report di crash ogni volta che il gioco o il server si arresta in modo imprevisto. Guarda qui:

• crash-reports/
  Un file con marca temporale come crash-2026-06-08_14.23.51-server.txt. Questo è il report dedicato e dettagliato.
• logs/latest.log
  Il log di esecuzione completo. Se non c'è un report di crash (il processo è semplicemente terminato), l'errore è qui, in fondo.
• logs/debug.log
  Un log molto più dettagliato, utile quando latest.log non lo è abbastanza.

Su un server queste cartelle si trovano nella radice del server; su un client sono nella cartella instance/.minecraft. Apri sempre il file più recente per marca temporale.

Ogni report ha le stesse parti, dall'alto in basso:

• Intestazione e descrizione
  Una riga Description che riassume cosa è andato storto, più l'ora. È il tuo primo indizio.
• Lo stack trace
  Il tipo di eccezione, poi un elenco di righe di codice che mostrano dove è avvenuto, spesso seguito da uno o più blocchi Caused by: .
• Livello / dettagli interessati
  Per i crash di mondo o entità: le coordinate, la dimensione e l'entità/il blocco coinvolti.
• Dettagli di sistema
  Versione di Minecraft, versione di Java, memoria allocata, il mod loader e l'elenco completo dei mod. Oro per la diagnosi.

1. Leggi la riga Description. È un riassunto in linguaggio semplice, ad es. «Exception ticking entity» o «Unexpected error». Questo ti dice già la categoria.
2. Trova il tipo di eccezione in cima allo stack trace (ad es. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). Il tipo spesso nomina direttamente il problema.
3. Vai all'ultimo «Caused by:». Quando ce ne sono diversi concatenati, il più profondo è di solito la vera causa principale, non il primo.
4. Cerca un nome di mod o plugin nel percorso del pacchetto (ad es. com.somemod.Thing). Questo indica direttamente il colpevole. Uno stack trace puramente net.minecraft.* punta invece ai dati vanilla/del mondo.
5. Controlla i dettagli di sistema. Verifica che la versione di Java corrisponda alla tua versione di Minecraft, guarda quanta memoria è stata allocata e scorri l'elenco dei mod alla ricerca di duplicati o voci obsolete.
6. Abbina il sintomo a una soluzione nota. Usa la causa che hai trovato per passare alla soluzione corrispondente (vedi gli esempi qui sotto).

• OutOfMemoryError: Java heap space
  Memoria insufficiente. Vedi Out of Memory.
• Exception ticking entity
  Una singola entità corrotta. Vedi Ticking Entity.
• A single server tick took 60.00 seconds
  Il server si è bloccato. Vedi Watchdog Crash.
• NoClassDefFoundError / ClassNotFoundException
  Una libreria mancante. Vedi NoClassDefFoundError.
• Exit code -1 with no crash report
  Leggi invece latest.log. Vedi Error Code -1.

Sfogliali tutti nella pagina Problemi comuni .

A volte il processo termina semplicemente (spesso con codice di uscita 1 o -1) senza scrivere un report di crash. In tal caso l'errore reale è in fondo a logs/latest.log. Scorri verso l'alto dalla fine fino alla prima riga ERROR, FATAL o Exception: è lì che le cose sono andate storte. Per capire il formato del log stesso, vedi Capire i log di Minecraft.