Cum să afișezi numărul de jucători online pe lista de servere Hytale

Când un jucător navighează pe lista de servere Hytale, un număr decide dacă face clic pe „Alătură-te" sau continuă să deruleze: numărul de jucători. Un server care arată 47/100 jucători pare viu. Un server care nu arată nimic — sau doar „Offline" — pare un oraș fantomă chiar dacă funcționează bine. HytaleCharts oferă trei moduri de a afișa serverului tău Hytale numărul de jucători în timp real și starea online. Fiecare metodă are compromisuri diferite în ceea ce privește acuratețea, efortul de configurare și funcționalitățile. Acest ghid explică toate trei pentru a putea alege cea potrivită pentru configurația ta. Cele trei metode dintr-o privire MetodăNumăr jucătoriViteză actualizareEfort configurareCel mai bun pentru Plugin HeartbeatNumăr exact + listă jucătoriLa fiecare 60 secundeInstalează pluginServere auto-găzduite Interogare externăNumăr exactLa fiecare 5 minuteSetează un URLNitrado / hosturi gestionate Ping UDPDoar online/offlinePeriodicNiciunul (automat)Stare de bază de rezervă Metoda 1: Pluginul Heartbeat HytaleCharts (Recomandat) Pluginul heartbeat este cea mai bună modalitate de a arăta numărul de jucători pe lista de servere Hytale. Rulează pe serverul tău Hytale și trimite un semnal heartbeat către HytaleCharts la fiecare 60 de secunde, incluzând numărul exact de jucători online și numele lor de utilizator. Ce raportează Player count — numărul actual de jucători conectați Jucători maximi — limita de jucători a serverului Lista jucătorilor — numele de utilizator individuale și UUID-urile jucătorilor conectați Versiunea pluginului — pentru ca HytaleCharts să te poată avertiza despre actualizări Cum funcționează intern 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 Pași de configurare Generează un secret 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 Suport multi-instanță 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. Actualizări 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. Metoda 2: Endpoint de interogare externă (Nitrado și hosturi gestionate) 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. Cum funcționează 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 Formate de răspuns suportate HytaleCharts auto-detects multiple JSON formats, so it works with most query endpoints out of the box: Format Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Format standard { "player_count": 15, "max_players": 100 } Also supports camelCase (playerCount, maxPlayers) and shorthand (online, max) variants. Pași de configurare Găsește sau configurează un endpoint de interogare la furnizorul tău de 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. Metoda 3: Ping UDP (Rezervă automată) 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. Cum funcționează 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 Limitări 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. Cum determină HytaleCharts starea serverului tău When multiple methods are available, HytaleCharts uses a sistem de priorități pentru a decide în ce sursă de date să aibă încredere: External Query (cea mai mare prioritate, dacă este activată) — online dacă ultimul sondaj reușit a fost în ultimele 10 minute Heartbeat Plugin (dacă este configurat) — online dacă ultimul heartbeat a fost în ultimele 5 minute UDP Ping (rezervă) — folosește rezultatul online/offline stocat de la ultima verificare 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. Ce văd jucătorii On the Hytale server list, starea serverului tău apare ca o insignă colorată: 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 cele mai bune servere Hytale. Depanare ProblemăCauză probabilăSoluție Serverul arată „Offline" deși funcționeazăFirewall-ul blochează heartbeat sau pingAsigură-te că serverul poate face cereri HTTPS de ieșire către hytalecharts.com Numărul de jucători blocat la 0Pluginul nu urmărește evenimentele jucătorilorVerifică dacă pluginul s-a încărcat (verifică log-urile serverului) și repornește Heartbeat-ul se oprește după un timpPluginul s-a blocat sau a fost descărcatVerifică log-urile serverului pentru erori, reinstalează pluginul dacă e necesar Interogarea externă arată un număr greșitEndpoint-ul returnează date învechiteVerifică răspunsul JSON direct într-un browser Numărul multi-instanță este prea micInstanțele folosesc secrete diferiteToate instanțele trebuie să partajeze același secret heartbeat Avertisment „Actualizare disponibilă"Pluginul este învechitDescarcă cea mai recentă versiune a pluginului de pe HytaleCharts Cele mai bune practici Operatorii care administrează cele mai bune servere Hytale urmează aceste practici: Folosește pluginul heartbeat ori de câte ori este posibil — este cea mai precisă și receptivă opțiune Setează un număr maxim realist de jucători — limitele umflate (de ex., 999) par necinstite și reduc încrederea Monitorizează starea heartbeat — verifică periodic pagina Editare server pentru erori Menține pluginul actualizat — pluginurile învechite pot să nu mai funcționeze după modificări API Folosește interogarea externă ca rezervă — dacă pluginul se defectează, un endpoint extern funcțional menține starea precisă Asigură-te că domeniul tău este corect — rezerva ping UDP folosește domeniul configurat, deci menține-l precis chiar dacă folosești în principal heartbeat Primii pași Afișarea numărului de jucători durează mai puțin de cinci minute cu pluginul heartbeat. Generează un secret, instalează pluginul, adaugă secretul în configurație și repornește. Serverul tău Hytale va apărea pe lista de servere Hytale cu un număr de jucători în timp real într-un minut. Pentru furnizorii de hosting gestionat precum Nitrado, interogarea externă este și mai simplă — doar lipește un URL și HytaleCharts se ocupă de restul. Oricum ar fi, afișarea unui număr real de jucători este una dintre cele mai ușoare lucruri pe care le poți face pentru a crește vizibilitatea serverului și a atrage noi jucători. Serverele care arată numere active de jucători pe lista de servere Hytale depășesc constant pe cele care nu o fac.