spark è il profiler per i server Minecraft. Quando il server scatta, spark ti dice in pochi secondi se il tick rate ne risente, quali plugin o farm divorano il tempo e se la CPU o la memoria sono al limite. Questa guida ti mostra i tre comandi che ti servono davvero e come leggere i numeri. Gli screenshot provengono da un server di prova con Paper 1.21.4.
Installazione
spark funziona come plugin su Paper e Spigot e come mod su Fabric, NeoForge e Forge. Nel pannello lo trovi in Plugin → Browser. Non richiede alcuna configurazione. I comandi vanno assegnati al gruppo dei moderatori; il nodo corrispondente si chiama spark. Per sapere come assegnarlo, leggi LuckPerms: configurare i permessi.
Primo sguardo: TPS e durata dei tick
/spark tps mostra tre righe:
(Enlarge image)- TPS (tick al secondo) negli ultimi 5 secondi, 10 secondi, 1, 5 e 15 minuti. 20,0 è il massimo. Fino a circa 19 i giocatori non notano nulla, sotto 15 gli animali si muovono a scatti, sotto 10 il server diventa ingiocabile.
- Durata dei tick come minimo, mediana, 95° percentile e massimo in millisecondi. Un tick può durare al massimo 50 ms per mantenere 20 TPS. Nell'immagine la mediana è di 2,4 ms, quindi il server ha molto margine. Il valore decisivo è il 95° percentile: se si avvicina a 50 ms, compaiono gli scatti anche se la media sembra buona.
- Utilizzo della CPU suddiviso tra sistema (l'intera macchina) e processo (solo il tuo server). Su un server a noleggio, il valore che conta è quello del processo.
/spark healthreport riassume gli stessi valori in un unico report, insieme a memoria e disco.
Il profiler: chi divora il tempo?
Quando i TPS crollano, avvia il profiler:
/spark profiler start
spark conferma l'avvio e continua a funzionare in background. Lascialo attivo per almeno un minuto mentre il problema si presenta, poi esegui:
/spark profiler stop
(Enlarge image)Quando lo fermi, spark carica il report su spark.lucko.me e ti restituisce un link. Il report non contiene nomi dei giocatori, indirizzi IP o messaggi di chat, ma solo gli alberi delle chiamate del processo Java. /spark profiler open lo apre già durante l'esecuzione, mentre /spark profiler cancel lo scarta senza caricarlo.
Nel report espandi l'albero partendo dall'alto. Ecco cosa trovi di solito:
- Tick delle entità di un certo tipo: una farm con centinaia di animali o oggetti. Riduci la farm o alleggeriscila con
entity-activation-rangeinpaper-world-defaults.yml. - Un plugin in un event listener: aggiorna il plugin, controlla la configurazione o sostituiscilo.
- Caricamento dei chunk causato da giocatori che volano velocemente: riduci la distanza visiva o pregenera il mondo con Chunky.
- Clock di redstone: un circuito che non si ferma mai. Chiedi al giocatore di spegnerlo.
Garbage collection e memoria
/spark gc mostra quanto spesso e per quanto tempo si ferma la garbage collection di Java. Molte pause lunghe indicano troppa poca RAM o un memory leak in un plugin. /spark heapsummary elenca i tipi di oggetti che occupano la memoria. Prima di acquistare altra RAM, vale la pena dare un'occhiata qui: spesso basta aggiornare un plugin per risolvere il problema.
Errori tipici
- TPS a 20, ma lag comunque. Il problema è nel client o nella rete.
/spark pingmostra la latenza di ogni giocatore. - Link del profiler dimenticato.
/spark profilersenza argomenti mostra lo stato; dopo l'arresto, il link si trova anche nella console del server. - Numeri senza confronto. Un valore di TPS da solo dice poco. Fai una misurazione a server vuoto come riferimento.
Guide correlate
Generare un mondo in anticipo evita al server il caricamento dei chunk: Chunky: pregenerare il mondo. Come il pannello segnala TPS costantemente bassi è spiegato in Lag del server Minecraft: TPS e Watchdog.
Fonti
- Documentazione di spark: https://spark.lucko.me/docs/
- Comandi: https://spark.lucko.me/docs/Command-Usage
- Leggere i report del profiler: https://spark.lucko.me/docs/guides/Finding-lag-spikes