Plugin

Come funziona

Il plugin permette al tuo server Hytale di aggiornare automaticamente le statistiche sulla nostra piattaforma.
Una volta installato e configurato, il plugin invierà automaticamente le statistiche del server ogni 5-10 minuti, mantenendo i dati sempre aggiornati.

Download del Plugin

Scarica il plugin e inseriscilo nella cartella mods del tuo server Hytale.

Scarica Plugin

Passaggi per l'Installazione

  1. Scarica il plugin dal link sopra
  2. Copia il file nella cartella mods del tuo server Hytale
  3. Riavvia il server per caricare il plugin
  4. Apri il file di configurazione HytaleIt_ServerList\config.json
  5. Configura Name, Token e le Capability (vedi sotto)
  6. Riavvia nuovamente il server per applicare le modifiche

Configurazione

Apri il file di configurazione generato dal plugin:

HytaleIt_ServerList\config.json

Il file di configurazione è fatto così:

Per trovare il token segreto del tuo server, devi tornare su questa pagina dopo aver effettuato il login.
{
"Name": "default",
"Token": "il_tuo_token_segreto_qui",
"Capabilities": {
"Performance": true,
"Players": true,
"Plugins": true,
"Worlds": true
},
"DebugTelemetry": true
}

Documentazione

Campo Descrizione
Name Necessario esclusivamente se il tuo server è composto da più istanze server. Identifica in modo univoco questo server all'interno del tuo ecosistema (es. hub, minigame-1, minigame-2). Se hai più server, installa il plugin su ciascuno e usa un Name diverso per ognuno, così da consetire il corretto calcolo del numero di giocatori. Il valore può contenere solo lettere, numeri, trattini (alti o bassi).
Attualmente questa funzionalità è in fast di test.
Token Token segreto del tuo server (non condividerlo).
Capabilities Abilita o disabilita i dati da inviare. Per impostazione predefinita sono tutte disattivate: si consiglia di abilitarle tutte, verranno usate in seguito per arricchire la pagina del tuo server.
Se abilitati, i dati vengono registrati, ma non sono ancora visibili sulla pagina del tuo server.
DebugTelemetry Non è presente di default, ma puoi aggiungerlo. Se attivo, il plugin salverà l'ultimo payload inviato in telemetry.json (nella stessa cartella del config.json).

Dati inviati

Il plugin invia sempre i campi base, e include sezioni aggiuntive solo se abilitate nelle Capabilities.

Il plugin invia sempre un set di informazioni "base" per identificare il server e il suo stato generale.

  • Funzionalità: la lista delle capability attive
  • Sequenza: contatore progressivo delle informazioni inviate
  • Orario Corrente: timestamp del momento in cui vengono misurate le informazioni
  • Orario Avvio: timestamp di avvio del server
  • Versione / Revisione: informazioni sulla versione del gioco
  • Slot Totali / Giocatori Online: capienza totale e giocatori online

Con Players attivo, il plugin invia la lista dei giocatori online, includendo nome e identificativo. Se è attivo anche Worlds, per ogni giocatore viene indicato anche in quale mondo si trova.

  • Nome e UUID di ogni giocatore online
  • Se Worlds è attivo, viene incluso per ogni giocatore il World UUID che identifica il mondo in cui si trova

Con Worlds attivo, il plugin invia l'elenco dei mondi presenti sul server. Se abiliti anche Performance, per ciascun mondo vengono inviate anche le metriche di performance.

  • Per ogni mondo viene indicato Nome, UUID e Nome Visualizzato
  • Se è attiva Performance, ogni mondo include anche le metriche TPS / MSPT

Con Plugins attivo, verrà inviato l'elenco dei plugin caricati sul server.

  • Nome, Versione e Gruppo di ogni plugin presente

Con Performance attivo, vengono inviate informazioni utili a misurare lo "stato di salute" del server.

  • Distanza Rendering: la distanza di rendering attuale