Come mostrare il conteggio giocatori online nella lista server Hytale

Quando un giocatore naviga nella lista server Hytale, un numero decide se clicca "Unisciti" o continua a scorrere: il conteggio giocatori. Un server che mostra 47/100 giocatori sembra vivo. Un server che non mostra nulla — o solo "Offline" — sembra una città fantasma anche se funziona bene. HytaleCharts offre tre modi per mostrare il server Hytale conteggio giocatori in tempo reale e lo stato online. Ogni metodo ha diversi compromessi in termini di precisione, impegno di configurazione e funzionalità. Questa guida spiega tutti e tre in modo da poter scegliere quello giusto per la tua configurazione. I tre metodi a colpo d'occhio MetodoConteggio giocatoriVelocità aggiornamentoImpegno configurazioneIdeale per Plugin HeartbeatConteggio esatto + lista giocatoriOgni 60 secondiInstalla pluginServer self-hosted Query esternaConteggio esattoOgni 5 minutiImposta URLNitrado / host gestiti Ping UDPSolo online/offlinePeriodicoNessuno (automatico)Stato di fallback base Metodo 1: Plugin Heartbeat HytaleCharts (Consigliato) Il plugin heartbeat è il modo migliore per mostrare il conteggio giocatori nella lista server Hytale. Funziona sul tuo server Hytale e invia un segnale heartbeat a HytaleCharts ogni 60 secondi, includendo il numero esatto di giocatori online e i loro nomi utente. Cosa riporta Player count — il numero attuale di giocatori connessi Giocatori massimi — il limite di giocatori del tuo server Lista giocatori — nomi utente individuali e UUID dei giocatori connessi Versione plugin — affinché HytaleCharts possa avvisarti sugli aggiornamenti Come funziona internamente The plugin sends a POST request to /api/heartbeat every 60 seconds The request includes your server's secret key (a 64-character hex string) HytaleCharts validates the secret, updates your server's player count and status If no heartbeat is received for 5 minutes, the server is marked offline Historical data is stored for analytics and player count graphs Passaggi di configurazione Genera un segreto heartbeat — on HytaleCharts, go to Edit Server and click "Generate Heartbeat Secret" in the Heartbeat Plugin section Copy the secret — you'll only see it once (you can regenerate if lost) Install the HytaleCharts plugin on your Hytale server by placing it in your server's mods/ directory Configure the plugin — create or edit config.json in the plugin's data directory: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Restart your server — the plugin will begin sending heartbeats immediately Verify on HytaleCharts — your server should show as online with a player count within 60 seconds Supporto multi-istanza If you run multiple server instances (e.g., a lobby server and a survival server), the heartbeat system aggregates player counts automatically. All instances sharing the same secret key will have their unique players merged and totals summed. This means your Hytale server list entry shows the correct total across your entire network. The system identifies unique instances by IP address and world name, takes the latest heartbeat from each source, and merges players by UUID to avoid double-counting anyone connected to multiple instances. Aggiornamenti del plugin HytaleCharts tracks your plugin version. If a newer version is available, your Edit Server page will show an "Update Available" warning. Keeping the plugin current ensures compatibility with any API changes and gets you the latest bug fixes. Metodo 2: Endpoint di query esterna (Nitrado e host gestiti) Not all Hytale server operators have access to install custom plugins. If you're using Nitrado, a container-based host, or any provider that exposes a query endpoint, the external query system is your solution. Come funziona You provide HytaleCharts with a URL that returns your server's player count as JSON HytaleCharts polls that URL every 5 minutes The response is parsed and your player count is updated on the server list If the endpoint becomes unreachable, your server status reflects the change within 10 minutes Formati di risposta supportati HytaleCharts auto-detects multiple JSON formats, so it works with most query endpoints out of the box: Formato Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Formato standard { "player_count": 15, "max_players": 100 } Also supports camelCase (playerCount, maxPlayers) and shorthand (online, max) variants. Passaggi di configurazione Trova o configura un endpoint di query presso il tuo provider di hosting a query endpoint on your hosting provider (Nitrado provides one by default) On HytaleCharts, go to Edit Server → External Query Enter the full URL to your query endpoint Click "Test Endpoint" to verify the response is parseable Save — HytaleCharts starts polling immediately The external query method updates less frequently than the heartbeat plugin (every 5 minutes vs. every 60 seconds), but it requires zero server-side modifications. Metodo 3: Ping UDP (Fallback automatico) If you haven't configured either the heartbeat plugin or an external query endpoint, HytaleCharts will attempt to check your server's status via UDP ping. This is a passive system that requires no setup on your end. Come funziona HytaleCharts sends a minimal QUIC protocol probe to your server's public port (default: 5520) If any response is received, the server is marked online If no response after multiple retries, the server is marked offline Limitazioni No player count — UDP ping can only determine online vs. offline, not how many players are connected No player list — no individual player data is available Less accurate timing — status updates depend on the polling schedule rather than real-time heartbeats UDP ping is useful as a baseline, but servers serious about climbing the Hytale server list rankings should install the heartbeat plugin or configure an external query for accurate player counts. Come HytaleCharts determina lo stato del tuo server When multiple methods are available, HytaleCharts uses a sistema di priorità per decidere a quale fonte dati fidarsi: External Query (priorità più alta, se abilitata) — online se l'ultimo sondaggio riuscito è stato entro 10 minuti Heartbeat Plugin (se configurato) — online se l'ultimo heartbeat è stato entro 5 minuti UDP Ping (fallback) — usa il risultato online/offline memorizzato dall'ultimo controllo This means if you have both the heartbeat plugin and an external query configured, the external query takes precedence. Most operators will use one or the other, not both. Cosa vedono i giocatori On the Hytale server list, lo stato del tuo server appare come un badge colorato: Green badge with player count (e.g., "Online — 47 players") — when online and players are detected Green badge ("Online") — when online but no players or count unavailable Red badge ("Offline") — when no recent heartbeat, query, or ping response Servers with visible player counts consistently attract more clicks. A server showing "Online — 23 players" is far more compelling than one that just says "Online" with no count. This is why the heartbeat plugin or external query is important for migliori server Hytale. Risoluzione dei problemi ProblemaCausa probabileSoluzione Il server mostra "Offline" nonostante sia in esecuzioneFirewall che blocca heartbeat o pingAssicurati che il server possa effettuare richieste HTTPS in uscita verso hytalecharts.com Conteggio giocatori bloccato a 0Il plugin non traccia gli eventi dei giocatoriVerifica che il plugin sia caricato (controlla i log del server) e riavvia L'heartbeat si interrompe dopo un po'Il plugin è crashato o è stato scaricatoControlla i log del server per errori, reinstalla il plugin se necessario La query esterna mostra un conteggio erratoL'endpoint restituisce dati obsoletiVerifica la risposta JSON direttamente in un browser Il conteggio multi-istanza è troppo bassoLe istanze usano segreti diversiTutte le istanze devono condividere lo stesso segreto heartbeat Avviso "Aggiornamento disponibile"Il plugin è obsoletoScarica l'ultima versione del plugin da HytaleCharts Migliori pratiche Gli operatori che gestiscono i migliori server Hytale seguono queste pratiche: Usa il plugin heartbeat quando possibile — è l'opzione più precisa e reattiva Imposta un conteggio massimo di giocatori realistico — limiti gonfiati (es. 999) sembrano disonesti e riducono la fiducia Monitora lo stato del tuo heartbeat — controlla periodicamente la pagina Modifica server per errori Mantieni il plugin aggiornato — i plugin obsoleti potrebbero smettere di funzionare dopo modifiche API Usa la query esterna come backup — se il plugin si guasta, un endpoint esterno funzionante mantiene il tuo stato preciso Assicurati che il tuo dominio sia corretto — il fallback ping UDP usa il dominio configurato, quindi mantienilo preciso anche se usi principalmente l'heartbeat Per iniziare Mostrare il conteggio giocatori richiede meno di cinque minuti con il plugin heartbeat. Genera un segreto, installa il plugin, aggiungi il segreto alla configurazione e riavvia. Il tuo server Hytale apparirà nella lista server Hytale con un conteggio giocatori in tempo reale entro un minuto. Per i provider di hosting gestito come Nitrado, la query esterna è ancora più semplice — basta incollare un URL e HytaleCharts si occupa del resto. In ogni caso, mostrare un conteggio reale di giocatori è una delle cose più facili che puoi fare per aumentare la visibilità del tuo server e attirare nuovi giocatori. I server che mostrano conteggi attivi di giocatori nella lista server Hytale superano costantemente quelli che non lo fanno.