Capire i log di Minecraft

I log di Minecraft sono la migliore fonte di verità quando qualcosa si rompe. Registrano ciò che il gioco o il server ha fatto, in ordine, fino al momento del guasto. Questa guida spiega quali file di log contano, come leggere una riga di log e cosa cercare.

I file di log che contano

Tutto si trova nella cartella logs/ (radice del server, o instance/.minecraft su un client):

  • latest.log
    Il log completo dell'esecuzione corrente. È il file che apri per primo; l'errore è quasi sempre qui.
  • debug.log
    Una versione molto più dettagliata della stessa esecuzione. Usala quando latest.log non dice abbastanza.
  • Log archiviati
    Le esecuzioni più vecchie sono compresse come 2026-06-08-1.log.gz. Decomprimilo per leggere una sessione passata.
  • crash-reports/
    Una cartella separata con un report mirato, scritto solo quando il gioco va in crash. Vedi Come leggere un report di crash di Minecraft.

Come leggere una riga di log

Ogni riga segue lo stesso formato:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    La marca temporale: quando si è verificato l'evento.
  • [Server thread/ERROR]
    Il thread che l'ha registrato, e il livello.
  • Il messaggio
    Cosa è realmente successo, spesso seguito da uno stack trace se si tratta di un errore.

Il livello del log indica la gravità a colpo d'occhio: INFO (normale), WARN (qualcosa non va ma non è fatale), ERROR (un guasto reale), e FATAL (il server si sta spegnendo).

Thread: chi sta parlando

  • Server thread / main
    Il ciclo di gioco principale. Gli errori qui di solito influiscono direttamente sul gameplay (e possono mandare in crash il server).
  • Worker / IO threads
    Lavoro in background come l'I/O dei chunk. Utile per problemi di disco e di salvataggio del mondo.
  • Mod/plugin threads
    Prende il nome da un mod o plugin: un rapido indizio su cosa è responsabile.

Cosa cercare

  1. Vai alla prima riga ERROR/FATAL o Exception; gli errori successivi sono spesso solo conseguenze.
  2. Leggi la sezione di avvio per individuare mod/plugin falliti, la versione di Java sbagliata o un EULA non accettato.
  3. Fai attenzione allo spam ripetuto di WARN come «Can't keep up!» (prestazioni, vedi Can't Keep Up) o «moved too quickly».
  4. Annota le ultime righe prima di un blocco o di uno spegnimento: mostrano cosa stava facendo il server quando si è guastato.
  5. Confronta ogni errore con l'elenco Problemi comuni per la soluzione esatta.

Log del server vs log del client

Condividono lo stesso formato ma si trovano in posti diversi. Un log di server registra il salvataggio del mondo, le connessioni dei giocatori e il caricamento di plugin/mod; un log di client registra il rendering, i resource pack e la tua stessa connessione. Quando risolvi un problema di accesso, confrontali entrambi: la causa potrebbe essere solo da un lato.

Condividere i log in sicurezza

I log possono contenere l'IP del tuo server e occasionalmente token, quindi non incollarli pubblicamente senza dare prima un'occhiata. Usa un servizio di paste (come mclo.gs) per la condivisione, oppure carica il file direttamente in MCDoctor.ai, che legge il log e ti spiega causa e soluzione, senza scavare a mano.

Domande frequenti

Nella cartella logs/ nella radice del server o nella cartella instance/.minecraft. La sessione corrente è latest.log; quelle precedenti sono file .log.gz compressi.

Coprono la stessa sessione, ma debug.log è molto più dettagliato. Inizia con latest.log e passa a debug.log solo se ti serve più dettaglio.

WARN significa che qualcosa non va ma non è fatale; ERROR è un guasto reale; FATAL significa che il server si sta spegnendo. Concentrati sulla prima riga ERROR/FATAL.

Sì, carica latest.log o un report di crash e MCDoctor.ai lo analizza e restituisce la causa probabile e la soluzione consigliata.