RealisticNode Docs
Risoluzione dei problemi

Leggere log e crash report

Trova e leggi i log e i crash report del tuo server Minecraft su RealisticNode, capisci gli stack trace, condividi i log e scova il plugin o la mod che non funziona.

Quando qualcosa va storto, il tuo server quasi sempre scrive il perché. Questa guida ti mostra dove trovare queste informazioni e come leggerle, anche se non hai mai visto un errore Java.

Dove trovare i log

Apri Files nel pannello. Questi sono i file e le cartelle che contano:

File o cartellaCosa contiene
logs/latest.logTutto quello che il server ha scritto dal suo ultimo avvio. È il primo file da controllare.
logs/*.log.gzI log più vecchi, uno per giorno o per avvio (per esempio 2026-10-24-1.log.gz). Sono compressi.
crash-reports/Un file .txt per ogni crash, con la data e l’ora nel nome. Apri il più recente.
logs/debug.logSolo Forge e NeoForge. Molto più dettagliato di latest.log, utile quando una mod non si carica.
hs_err_pid*.logNella cartella principale. Viene scritto quando è Java stesso a crashare (raro).

latest.log viene sostituito a ogni avvio. Se il problema è successo prima di un riavvio, guarda invece nel file .log.gz più recente.

Apri un log più vecchio

I log più vecchi finiscono in .gz, quindi non puoi aprirli direttamente nel browser. Puoi:

  • Cliccare con il tasto destro sul file e scegliere Unarchive (Estrai): il file .log normale compare nella stessa cartella. Cliccalo per leggerlo.
  • Oppure scegliere Download e aprirlo sul tuo computer con 7-Zip (Windows) o Utility Archivio (Mac).

I file più grandi di 4 MB non si possono aprire nell’editor del browser: scaricali o usa SFTP.

Usa la console

La Console mostra in tempo reale lo stesso output di latest.log.

  • Clicca Error o Warning sopra l’output per nascondere tutto il resto. È il modo più veloce per trovare i problemi in un avvio lungo.
  • Premi Ctrl + F dentro l’output per cercare una parola, come il nome di un plugin.
  • Clicca l’icona Share Logs (Condividi log) per caricare le ultime 500 righe su mclo.gs. Il link viene copiato per te, pronto da inviare al nostro team. mclo.gs evidenzia anche gli errori e dà dei suggerimenti.

I log condivisi sono pubblici

Chiunque abbia il link può leggere il log. Controlla che non mostri password, dati del database, token API o indirizzi IP che vuoi tenere privati.

Come leggere un errore

Gli errori Java fanno paura, ma ti servono solo poche righe. Ecco un esempio tipico:

logs/latest.log
[12:04:31 ERROR]: Error occurred while enabling ShopPlus v2.3 (Is it up to date?)
java.lang.IllegalStateException: Could not load the shop list
    at com.example.shopplus.config.ShopConfig.load(ShopConfig.java:42)
    at com.example.shopplus.ShopPlus.onEnable(ShopPlus.java:18)
    at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:288)
    ...
Caused by: java.io.FileNotFoundException: plugins/ShopPlus/shops.yml (No such file or directory)
    at java.io.FileInputStream.open0(Native Method)
    ...

Leggi la prima riga

Spesso dice direttamente cosa non ha funzionato: qui il plugin ShopPlus non è riuscito ad avviarsi.

Trova le righe "Caused by"

Un errore lungo può avere diverse righe Caused by:. Di solito l’ultima è il vero motivo. Qui manca un file.

Guarda i nomi dei pacchetti

Le righe at ... mostrano dove è successo l’errore. Salta quelle che iniziano con java., net.minecraft., org.bukkit., io.papermc. o net.minecraftforge. (sono il gioco e il software del server). Il primo nome diverso, come com.example.shopplus, indica il plugin o la mod responsabile.

Cerca l’errore

Copia la riga dell’errore (senza l’orario) e cercala insieme al nome del plugin o della mod. Spesso qualcuno ha già avuto lo stesso problema. Controlla anche la pagina del plugin o della mod per una versione più recente.

Leggi un crash report

I crash report in crash-reports/ seguono la stessa idea. Guarda:

  • Description: un breve riassunto come Ticking entity o Exception in server tick loop.
  • L’errore e le sue righe Caused by subito sotto.
  • Sezioni come -- Entity being ticked -- o -- Block entity being ticked --: mostrano il tipo e la posizione della cosa che ha crashato.
  • Su Forge e NeoForge, alcuni report elencano le Suspected Mods (mod sospette). È un buon indizio, ma non sempre è giusto.

La pagina Errori comuni spiega i messaggi che vedrai più spesso.

Trova un plugin o una mod rotta dividendo a metà

Se i log non indicano un colpevole, prova metà dei tuoi plugin o mod alla volta. Con 40 mod trovi quella difettosa in circa 6 riavvii.

Fai prima un backup

Crea un backup prima di rimuovere qualsiasi cosa. Alcune mod eliminano i loro blocchi e oggetti dal mondo quando mancano.

Sposta fuori metà dei file

Ferma il server. In Files, crea una cartella chiamata disabled nella cartella principale e sposta con Move metà dei file .jar da plugins (o mods) dentro di essa.

Prova

Avvia il server. Se il problema è sparito, il colpevole è nella cartella disabled. Se c’è ancora, è nella metà rimasta.

Ripeti

Continua a dividere a metà il gruppo sospetto finché resta un solo file. Poi aggiornalo, cerca un’alternativa o segnala il bug al suo autore, e rimetti a posto gli altri file.

Tieni le librerie insieme alle mod che ne hanno bisogno (per esempio Fabric API, Architectury o Cloth Config). Altrimenti otterrai errori di "dipendenza mancante" che nascondono il vero problema.

Ti serve aiuto?

Clicca Share Logs nella console, oppure carica il crash report su mclo.gs, e invia il link al nostro team su Discord insieme al tuo Server ID e a cosa è cambiato prima che iniziasse il problema.

In questa pagina