Se il server Minecraft non si avvia, controlla in questo ordine: logs/latest.log, il file eula.txt, la versione di Java installata e i flag di memoria -Xmx. Queste tre verifiche risolvono la maggior parte dei blocchi.
Apri il terminale e lancia tail -n 50 logs/latest.log: se il file esiste ma mostra un’eccezione, hai già la causa. Se il log è vuoto o non viene creato, il problema è precedente all’avvio della JVM, tipicamente Java non trovato o server.jar mancante, come confermano le guide pratiche di troubleshooting. Poi verifica:
eula=truedentroeula.txtjava -versionper confermare la compatibilità con la release del server- i parametri
-Xmxrispetto alla RAM fisica disponibile - un avvio di prova con la cartella
pluginsrinominata
Se compare «Could not reserve enough space», il problema è quasi sempre memoria mal dimensionata: passa subito alla sezione su Java e JVM.
Punti chiave
Il server non si avvia quasi sempre per una causa visibile nel log, nella versione Java o nei permessi file, mai senza motivo.
| Punto | Dettagli |
|---|---|
| Leggi prima il log | Apri logs/latest.log e cerca le prime righe del crash, non solo l’ultima. |
| Controlla l’EULA | Verifica che eula.txt contenga eula=true e che i permessi cartella siano corretti. |
| Verifica la versione Java | Usa java -version e confrontala con la mappatura richiesta dalla tua release Minecraft. |
| Isola plugin o mod | Applica la ricerca binaria spostando e reinserendo gruppi di plugin per trovare il conflitto. |
| Valuta un hosting gestito | AtomSync configura Java, backup e protezione DDoS automaticamente, riducendo gli errori di avvio. |
Indice
- Controllo console e file di log: dove guardare e come interpretare gli errori
- EULA e permessi file: l’errore ricorrente che blocca l’avvio
- Versione Java e parametri JVM: compatibilità e memoria
- Plugin e mod: come isolare i conflitti con la ricerca binaria
- Server.jar, file corrotti e mondo danneggiato
- Pratiche raccomandate per avviare il server senza sorprese
- Hosting gestito: quando conviene evitare il troubleshooting da soli
- Fonti
- Domande frequenti
Controllo console e file di log: dove guardare e come interpretare gli errori
Il file logs/latest.log, nella cartella principale del server, è il primo posto da aprire. Se la cartella crash-reports contiene un file recente, quello è ancora più diretto: descrive esattamente il thread che ha causato l’arresto. Un log completamente assente segnala un problema che avviene prima che la JVM parta, come path Java sbagliato, jar cancellato o permessi negati.
Tre comandi coprono la maggior parte dei casi. tail -n 50 logs/latest.log mostra le ultime righe, utili per capire l’errore finale. grep "Exception" logs/latest.log isola rapidamente le eccezioni Java in mezzo a righe di log ordinarie. Se il server gira come servizio, journalctl -u minecraft.service -n 100 recupera l’output che altrimenti andrebbe perso.
La causa reale, però, spesso non è nell’ultima riga. Secondo la documentazione ufficiale di PaperMC, le prime 20-50 righe del crash contengono di solito l’eccezione radice, mentre quelle successive sono errori a cascata generati dal primo fallimento. Leggere dal basso verso l’alto porta spesso fuori strada.
Un consiglio: prima di chiedere aiuto su un forum o aprire un ticket, copia l’intero blocco di log dal primo errore in poi, non solo l’ultima riga: chi ti assiste risparmia tempo e tu ricevi una risposta più precisa.
EULA e permessi file: l’errore ricorrente che blocca l’avvio
Il messaggio «You need to agree to the EULA in order to run the server» è probabilmente l’errore più comune tra chi installa un server per la prima volta. Mojang genera automaticamente il file eula.txt al primo avvio, ma il server resta fermo finché non viene modificato manualmente.
Basta aprire
eula.txt, cambiare la riga ineula=true, salvare e riavviare. Talvolta su configurazioni Docker o systemd può servire anche il flag-Dcom.mojang.eula.agree=truepassato direttamente al comando java.
Controlla anche i permessi: su Linux usa chmod e chown per assicurarti che l’utente che esegue il processo possa scrivere nella cartella; su systemd, un WorkingDirectory sbagliato nel file unit produce lo stesso identico errore, come segnalato in una discussione su Stack Overflow sui permessi negati durante l’avvio del servizio.
- Verifica
eula=trueineula.txt - Controlla proprietario e permessi della cartella server
- Su Windows, controlla che l’utente non sia in sola lettura
Versione Java e parametri JVM: compatibilità e memoria
java -version è il comando da lanciare prima di qualunque altra diagnosi quando il server non parte con un errore tipo UnsupportedClassVersionError. Ogni release di Minecraft richiede un runtime Java specifico, e usare quello sbagliato blocca l’avvio a prescindere da tutto il resto.
| Versione Minecraft | Java richiesto |
|---|---|
| versioni recenti | versioni recenti di Java |
| versioni da 1.18 fino a 1.20 | Java 17 (versione supportata) |
| versioni fino a 1.12.2 | Java 8 (versione minima supportata) |
Questa mappatura è quella indicata dal wiki ufficiale di Minecraft. Se hai più versioni Java installate, su Linux update-alternatives --config java permette di scegliere quale usare, oppure puoi puntare al binario corretto con il percorso assoluto nello script di avvio.
Sul fronte memoria, l’errore «Could not reserve enough space for object heap» compare quando -Xmx chiede più RAM di quella fisicamente disponibile. La regola pratica, coerente con i requisiti minimi indicati dal wiki Minecraft, è:
- Non assegnare mai tutta la RAM del sistema alla JVM
- Lascia un ammontare adeguato di RAM libera per il sistema operativo
- Riduci
-Xmxse il server crasha subito dopo l’avvio con errori di heap
Plugin e mod: come isolare i conflitti con la ricerca binaria
Quando il server parte senza plugin ma non con la configurazione completa, il colpevole è quasi certamente uno di loro. La procedura più veloce per trovarlo è la ricerca binaria, la stessa tecnica usata nel debug del software.
- Sposta l’intera cartella
plugins(omods) fuori dalla directory del server e riavvia: se funziona, il problema è lì dentro. - Reinserisci metà dei plugin, riavvia, e osserva se l’errore ricompare.
- Ripeti dimezzando ogni volta il gruppo sospetto, finché non resta un singolo plugin.
- Controlla lo stack trace nel log: spesso riporta direttamente il nome del jar incriminato.
Questo metodo dimezza i tentativi rispetto al provare un plugin alla volta, soprattutto su server con trenta o quaranta estensioni installate.
Un consiglio: prima di aggiornare mod o plugin in produzione, testali su un server di prova o su una copia di backup: eviti di scoprire l’incompatibilità mentre i giocatori sono già connessi. Una guida utile su questo fronte è la sezione sull’installazione sicura delle mod.
Server.jar, file corrotti e mondo danneggiato
Un file server.jar corrotto o incompleto genera errori all’avvio anche prima che venga letto un solo plugin. Su Windows capita spesso che l’estensione .jar sia nascosta e il file si chiami effettivamente server invece di server.jar, causando l’errore «Unable to access jarfile», un problema documentato nella guida di PaperMC. Attivare la visualizzazione delle estensioni nel gestore file risolve il caso in pochi secondi.
Se invece l’errore riguarda level.dat, il mondo è probabilmente corrotto. La soluzione più rapida è ripristinare l’ultimo backup automatico; in assenza di backup, rinominare la cartella world forza il server a generarne uno nuovo, utile almeno per confermare che il problema sia isolato al mondo e non alla configurazione generale. Controlla anche che level-name in server.properties corrisponda esattamente al nome della cartella: un mismatch qui produce errori all’apparenza incomprensibili.
Reti, porte e conflitti software: firewall, antivirus e porta occupata
Se il log mostra «Address already in use», un altro processo occupa già la porta 25565. Su Linux ss -tulpn | grep 25565 mostra chi la sta usando; su Windows basta netstat -ano | findstr 25565. Cambiare la porta in server.properties è la soluzione più rapida quando non puoi liberarla.
Firewall e antivirus sono cause sottovalutate:
ufw,iptableso Windows Defender possono bloccare silenziosamente il binding della porta, e alcuni antivirus mettono in quarantenajava.exesenza notifiche chiare. Disattivarli temporaneamente per il test isola subito il problema.
- Verifica la porta con
ssonetstat - Controlla le regole firewall attive
- Disattiva temporaneamente l’antivirus per confermare il sospetto
Avvio come servizio o in container: errori comuni e fix pratici
Con systemd, un WorkingDirectory sbagliato nel file unit è la causa più frequente di FileNotFoundException all’avvio: il processo cerca server.jar nella cartella sbagliata. journalctl -xe mostra l’errore esatto in tempo reale.
Su Docker, un problema ricorrente riguarda la variabile d’ambiente EULA: se viene passata con maiuscole o minuscole inconsistenti, alcune immagini non la normalizzano correttamente e il container resta bloccato, come documentato in una segnalazione sul repository itzg/docker-minecraft-server. La soluzione più affidabile è cancellare eula.txt dal volume e lasciare che il container lo ricrei da zero.
Un consiglio: entra manualmente nel container con docker exec -it nomecontainer bash e prova ad avviare il jar a mano: capisci subito se il problema è nell’immagine o nella configurazione del volume.
Pratiche raccomandate per avviare il server senza sorprese
Uno script di avvio scritto bene evita metà dei problemi descritti finora. Deve impostare esplicitamente il percorso Java corretto, definire -Xmx e -Xms in modo coerente con la RAM disponibile, e gestire la rotazione dei log così da non accumulare file enormi nel tempo. Le guide sui requisiti hardware ricordano anche che un mondo con molte macchine redstone o generatori automatici richiede risorse ben superiori a una mappa vanilla con pochi giocatori.
Backup automatici giornalieri per mondo e plugin sono la rete di sicurezza più semplice da configurare e la più trascurata. Testa sempre gli aggiornamenti di versione in un ambiente di staging prima di applicarli al server che i giocatori usano davvero: un come creare server Minecraft fatto con calma, seguendo una guida completa alla configurazione, riduce drasticamente i problemi di avvio futuri.
Un consiglio: non allocare mai il 100% della RAM disponibile alla JVM: il sistema operativo ne ha bisogno per gestire disco, rete e processi di sistema, e un server che va in OOM killer si comporta in modo identico a uno che “non si avvia”.
Nota dell’autore: esperienza pratica e invito all’azione tecnica
Prima di aprire un ticket, esegui davvero i controlli elencati sopra: log, EULA, versione Java. Se contatti il supporto, allega il log completo, la versione Java installata e l’elenco dei plugin attivi: risparmi ore a entrambe le parti.
Hosting gestito: quando conviene evitare il troubleshooting da soli
Ogni causa descritta finora, versione Java sbagliata, permessi, porte occupate, conflitti tra plugin, richiede tempo e un minimo di esperienza da riga di comando. AtomSync elimina buona parte di questi problemi alla radice: il server viene attivato in meno di 60 secondi con Java già configurato correttamente per la versione scelta, backup automatici quotidiani e un pannello Pterodactyl che gestisce plugin e file senza toccare il terminale.
Non ci sono vincoli contrattuali e puoi cambiare piano in qualsiasi momento. Dai un’occhiata alla pagina dedicata all’hosting per server Minecraft o parti direttamente da AtomSync per attivare un server pronto all’uso in meno di un minuto.
Fonti
- Basic troubleshooting | PaperMC Docs
- Tutorial: Setting up a Java Edition server – Minecraft Wiki
- Server/Requirements – Minecraft Wiki (Fandom)
- Minecraft Server Not Starting? Here’s How to Fix It - Astroworld guide
Domande frequenti
Cosa fare se il server non funziona?
Controlla prima logs/latest.log per individuare l’eccezione, poi verifica eula.txt, la versione Java installata e i flag -Xmx: questi quattro elementi coprono la maggior parte dei blocchi.
Perché il multiplayer di Minecraft non funziona?
Spesso è un problema di porta occupata o firewall che blocca il binding sulla 25565, oppure un server-ip errato in server.properties: verifica entrambi prima di sospettare un bug del gioco.
Cosa fare se Minecraft non si avvia?
Se il client non parte, il problema riguarda spesso il launcher o la RAM allocata al gioco, diverso dal caso di un server che non si avvia: per il server, la diagnosi parte sempre dal log.
Come si avvia un server Minecraft?
Scarica il server.jar ufficiale, esegui java -Xmx2G -Xms1G -jar server.jar nogui, accetta l’EULA in eula.txt e riavvia: la pagina di download ufficiale descrive l’intera procedura.
Un hosting gestito come AtomSync evita questi problemi di avvio?
Riduce drasticamente il rischio, perché Java, permessi e configurazioni di rete vengono già impostati correttamente all’attivazione, con backup automatici e supporto tecnico in italiano in caso di problemi residui.