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:

Output di /spark tps: TPS, durate dei tick e utilizzo della CPU (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
Il profiler è in esecuzione in background; spark mostra i comandi per visualizzarlo, fermarlo e annullarlo (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-range in paper-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 ping mostra la latenza di ogni giocatore.
  • Link del profiler dimenticato. /spark profiler senza 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