Ticks, TPS e main thread su Minecraft: comprendere il lag del server
Tick, TPS e main thread: questi tre concetti spiegano perché un server Minecraft lagga. Un server sano calcola 20 tick al secondo, cioè un tick ogni 50 millisecondi. Questa guida spiega come Minecraft divide il tempo, perché quasi tutto passa da un solo thread, quando i TPS calano e come trovare la causa con Spark.
Se la console mostra di continuo «Can't keep up!», ecco il messaggio in questione:
[Server thread/WARN] [minecraft/MinecraftServer]: Can't keep up! Is the server overloaded? Running 4681ms or 93 ticks behind
I tick, cosa sono esattamente?
Minecraft gira su un ciclo che si ripete senza sosta. Ogni giro del ciclo si chiama tick. A ogni tick il server ricalcola tutto ciò che accade nel mondo:
le azioni dei giocatori (spostamenti, clic, blocchi piazzati o rotti);
la posizione di tutte le entità, poi inviata a ogni giocatore;
la comparsa delle creature, la loro IA e i loro spostamenti;
la redstone e tutte le altre meccaniche del gioco.
Un server che funziona bene punta a 20 tick al secondo, un tick ogni 50 millisecondi. È questo ritmo a rendere fluido il gioco. La pagina «Tick» del Minecraft Wiki dà la definizione tecnica completa.
Il main thread, perché un solo core fa tutto il lavoro
È il punto che sorprende di più. La grande maggioranza dei calcoli di gioco passa da un solo thread di esecuzione, il main thread. In ogni momento è quindi un solo core del processore a fare la maggior parte del lavoro.
Prendiamo uno zombie che attacca un giocatore. Il server controlla la sua posizione, calcola la distanza, cerca un percorso, verifica la linea di vista, applica i danni. Tutto avviene in ordine, sullo stesso thread, e il tick non può andare avanti prima della fine.
Per questo, in un server Minecraft, un processore veloce per singolo core conta molto più del numero totale di core, soprattutto con molte entità o molta redstone.
Le versioni recenti spostano parte del lavoro altrove: generazione e illuminazione dei chunk, rete. Ma entità, IA e redstone restano sul main thread.
Quando tutto va bene, il server respira
Di norma ogni tick si calcola in meno di 50 ms. Se il server finisce in anticipo, aspetta semplicemente il tick successivo per mantenere il ritmo.
Per esempio, un tick di 15 ms lascia 35 ms di margine. I giocatori non sentono ritardi, le creature reagiscono subito, la redstone risponde senza attese e il server resta a 20 TPS. Questo tempo per tick si chiama MSPT, millisecondi per tick.
Quando lagga, il tick supera i 50 ms
Il problema inizia appena un tick supera i 50 ms. I tick non girano in parallelo: il successivo slitta e, se succede di nuovo, il ritardo si accumula.
Per i giocatori i segnali sono chiari: le creature si teletrasportano, i blocchi rotti ricompaiono prima di sparire, la redstone risponde al rallentatore, ogni azione arriva in ritardo.
Il messaggio «Can't keep up!» compare quando il server ha accumulato più di 2.000 ms di ritardo. Se un solo tick resta bloccato troppo a lungo, il watchdog considera il server bloccato e lo arresta. Questo limite è fissato da max-tick-time in server.properties: 60000 ms di default, cioè un minuto.
Un server può «girare» ed essere comunque ingiocabile. I giocatori sentono il lag molto prima di un vero crash.
Perché i tick diventano troppo lunghi
La causa numero uno è un main thread sovraccarico: troppe cose da calcolare in troppo poco tempo. Poiché tutto si rifà 20 volte al secondo, anche la minima fonte di carico si moltiplica in fretta. I colpevoli abituali:
troppe entità attive: 500 zombie in una zona sono 500 volte i calcoli di IA, percorso e collisione a ogni tick;
fattorie di creature progettate male, che ammassano centinaia di entità in poco spazio;
redstone intensiva: un circuito complesso in loop può occupare da solo il main thread;
chunk sempre caricati, per via di tramogge, chunk loader o giocatori AFK in zone dense;
collisioni di massa: 50 galline in 2 per 2 blocchi sembrano innocue, ma per il server sono un incubo di calcoli.
Il lag compare solo quando i giocatori sono in un punto preciso? Cerca prima lì una fattoria, un grosso circuito di redstone o un ammasso di entità.
I TPS, la salute del server in un numero
I TPS, o tick al secondo, misurano quanti tick il server riesce a produrre ogni secondo. A 20 TPS va tutto bene. Appena il server resta indietro, i TPS calano e il gioco rallenta.
Una formula semplice per visualizzare l'effetto:
(1000 - ritardo in ms) / 50 = TPS
Se il server accumula 250 ms di ritardo in un secondo, scende a (1000 - 250) / 50 = 15 TPS. Un altro modo di vederlo: un tick di 66 ms lascia spazio solo a 15 tick al secondo. In gioco 15 TPS si sentono già chiaramente. Sotto 10 è quasi ingiocabile.
Misurare TPS e MSPT
| Comando | Server | Risultato |
|---|---|---|
/tick query | Java 1.20.3 e successive, tutti | Ritmo previsto e tempo medio per tick |
/tps | Paper, Spigot, Purpur | TPS su 1, 5 e 15 minuti |
/mspt | Paper, Purpur | Tempo per tick, medio e massimo |
/neoforge tps | NeoForge | TPS e tempo per tick, per dimensione |
/forge tps | Forge | TPS e tempo per tick, per dimensione |
/spark tps | Con Spark | TPS, MSPT e carico del processore |
Nella console di OuiPanel scrivi questi comandi senza la barra. La guida +150 comandi Minecraft descrive /tick, che serve anche a bloccare o accelerare il gioco.
Trovare la causa con Spark
Sapere che il server lagga è una cosa, sapere perché è un'altra. Lo strumento più efficace è Spark: profila il main thread e mostra con precisione cosa prende tempo a ogni tick, che sia un plugin, un'entità o una meccanica di gioco.
Su Paper e Purpur Spark è incluso dalla 1.21: la console mostra «[spark] Starting background profiler» all'avvio.
Su Spigot installalo dalla pagina Plugin di OuiPanel.
Su Forge, NeoForge o Fabric installa la mod spark dal Mods Manager.
spark profiler start
# Lascialo girare qualche minuto mentre i giocatori giocano
spark profiler stop
Queste righe si scrivono nella console di OuiPanel. All'arresto Spark fornisce un link al suo rapporto. Pochi minuti di profilo di solito bastano per trovare il colpevole, invece di andare a tentoni.

La scheda Statistiche in tempo reale, a destra della console, mostra memoria e processore usati. Non dà i TPS: per quelli usa i comandi qui sopra.
Per ridurre il carico una volta trovata la causa, vedi le guide Come ottimizzare un server Minecraft per Paper e Spigot, e Mod NeoForge per Minecraft per un server moddato.
Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.
Scopri le nostre offerte di hosting Minecraft a partire da 1,99€/mese con installazione automatica delle mod.
Hosting server Minecraft →