Documentazione Voltick
Voltick è un profiler e toolkit di diagnostica per server Paper 1.21+ su Java 21. Un solo jar, zero dipendenze, report pubblici su voltick.it.
Per iniziare
1. Scarica l'ultima versione di Voltick.
2. Metti il jar nella cartella plugins/ del server.
3. Riavvia. Fine: nessuna configurazione richiesta.
/voltick profiler start --timeout 60Dopo 60 secondi il profiler si ferma da solo e il link al report compare in chat.
Comandi
| Comando | Descrizione |
|---|---|
| /voltick tps | TPS, MSPT e uso CPU del server. |
| /voltick health | Memoria, GC, CPU, disco e stato dei mondi. |
| /voltick ping [player] | Latenza dei giocatori online. |
| /voltick profiler start|stop|cancel|info | Gestisce il sampler dei thread. |
| /voltick tickmonitor [ms|off] | Avvisa in chat quando un tick supera la soglia. |
| /voltick gc | Statistiche del Garbage Collector. |
| /voltick gcmonitor | Notifiche GC in tempo reale. |
| /voltick heapsummary | Classi che occupano più memoria. |
| /voltick heapdump | Snapshot .hprof della memoria. |
| /voltick reload | Ricarica configurazione e lingua. |
| /voltick help | Elenco comandi. |
Profiler
Il sampler campiona gli stack dei thread e attribuisce il tempo CPU a ogni plugin. Flag disponibili su profiler start:
| Flag | Effetto |
|---|---|
| --interval <ms> | Intervallo di campionamento (default da config). |
| --thread <nome> | Campiona solo i thread che contengono il nome. |
| --all | Campiona tutti i thread, non solo il main. |
| --timeout <s> | Ferma il profiler automaticamente dopo N secondi. |
| --only-ticks-over <ms> | Conserva solo i campioni dei tick più lenti della soglia. |
| --ignore-sleeping | Ignora i thread dormienti. |
| --comment <testo> | Aggiunge una nota al report. |
| --save-to-file | Salva il report in locale invece di pubblicarlo. |
Report pubblici
Con profiler stop (o allo scadere del timeout) il report viene pubblicato su voltick.it e il link arriva in chat:
Report pronto » https://voltick.it/r/VK-8fKq2Lp1Il report mostra verdetto automatico, salute del server (TPS, MSPT, memoria, CPU, giocatori), tempo per plugin e metodi più caldi — con un pulsante Analisi IA che spiega tutto in parole semplici. I link sono permanenti e condivisibili. Con --save-to-file il report resta invece in plugins/Voltick/reports/.
Endpoint per integrazioni: POST https://voltick.it/api/reports con il JSON del report — risponde con l'URL pubblico in testo semplice.
Monitor & alert
/voltick tickmonitor 80 avvisa gli admin quando un tick supera 80ms, indicando la fase responsabile. /voltick gcmonitor notifica ogni ciclo GC con durata e memoria liberata. Entrambi si disattivano con off / rieseguendo il comando.
Memoria & GC
/voltick heapsummary elenca le classi con più istanze e byte occupati — utile per trovare memory leak. /voltick heapdump scrive un file .hprof analizzabile con VisualVM o Eclipse MAT nella cartella del plugin.
Permessi
| Permesso | Cosa sblocca |
|---|---|
| voltick.cmd.admin | Accesso a tutti i comandi /voltick. |
Configurazione
Il file plugins/Voltick/config.yml permette di impostare lingua (it/en), intervallo di default del profiler, scope dei thread e cronologia del tick monitor. Dopo ogni modifica: /voltick reload.