Hoe uw online speler te laten zien op de Hytale Serverlijst

Wanneer een speler door de bladeren Hytale serverlijst, een nummer bepaalt of ze op "Join" klikken of blijven scrollen: het aantal spelers . Een server met 47/100 spelers voelt levend aan. Een server die niets laat zien of gewoon "Offline" voelt als een spookstad, zelfs als het goed loopt. HytaleCharts biedt drie manieren om uw weer te geven Hytale server's real-time spelersaantal en online status. Elke methode heeft verschillende tradeoffs in nauwkeurigheid, setup inspanning, en functies. Deze gids legt alle drie uit zodat u de juiste kunt kiezen voor uw installatie. The Three Methods at a Glance MethodeSpeleraantalVerhoog snelheid Instellen van inspanningBeste voor Heartbeat Plugin Exacte telling + spelerslijstElke 60 secondenInstalleer pluginSelf-hosted servers Externe zoekopdrachtExact aantal Elke 5 minuten Een URL instellenNitrado / beheerde hosts UDP PingOnline/offline alleenPeriodicGeen (automatisch)Basisstatus fallback Methode 1: HytaleCharts Hartslagplugin (aanbevolen) De hartslag plugin is de beste manier om uw speler aantal tonen op de Hytale-serverlijst. Het draait op uw Hytale server en stuurt elke 60 seconden een hartslagsignaal naar HytaleCharts, inclusief het exacte aantal spelers online en hun gebruikersnamen. Wat het rapporteert Player count Het huidige aantal verbonden spelers Maxspelers Spelerlijst Individuele gebruikersnamen en UUIDs van verbonden spelers Pluginversie Zodat HytaleCharts u kan waarschuwen voor updates Hoe het werkt onder de kap De plugin stuurt een POST-verzoek naar /api/heartbeat elke 60 seconden Het verzoek bevat de geheime sleutel van uw server (een 64-character hex string) Hytale Grafieken valideert het geheim, updatet het aantal spelers van uw server en status Als er geen hartslag wordt ontvangen gedurende 5 minuten, wordt de server offline aangegeven Historische gegevens worden opgeslagen voor analytics en spelerstellingsgrafieken Setup Steps Ga naar Bewerken Server en klik op "Generate Heartbeat Secret" in de Heartbeat Plugin sectie Kopiëren van het geheim Je zult het slechts één keer zien (je kunt regenereren als je verloren bent) Installeer de HytaleCharts-plugin op uw computer Hytale server door deze in de mods/ directory van uw server te plaatsen Configureren van de plugin { "geheim": "YOUR_64_CHARACTER_SECRET_HERE," "debug": onwaar Herstart uw server Verifiëren op HytaleCharts Uw server moet tonen als online met een aantal spelers binnen 60 seconden Multi-Instance ondersteuning Als u meerdere server instanties uitvoert (bijv. een lobbyserver en een survival server), telt de hartslagsysteem contribution speler automatisch. Alle instanties delen dezelfde geheime sleutel zal hun unieke spelers samengevoegd en totalen samengevat. Dit betekent uw Hytale serverlijst item toont het juiste totaal over uw hele netwerk. Het systeem identificeert unieke instanties door IP-adres en wereldnaam, neemt de nieuwste hartslag van elke bron, en mergets spelers door UUID om te voorkomen dat dubbeltelling iedereen verbonden met meerdere instanties. Pluginupdates Hytale Grafieken volgt uw plugin-versie. Als er een nieuwere versie beschikbaar is, zal uw Bewerken Serverpagina een "Update Available" waarschuwing tonen. Het houden van de plugin stroom zorgt voor compatibiliteit met eventuele API wijzigingen en krijgt u de nieuwste bug fixes. Methode 2: Extern Query Endpoint (Nitrado & Managed Hosts) Niet alle Hytale server operators hebben toegang tot aangepaste plugins te installeren. Als u gebruik maakt van Nitrado, een op containers gebaseerde host, of een provider die een query-eindpunt blootlegt, is het externe query-systeem uw oplossing. Hoe het werkt Je geeft HytaleCharts een URL die het aantal spelers van uw server teruggeeft als JSON HytaleCharts polls that URL every 5 minutes Het antwoord wordt ontleed en uw aantal spelers wordt bijgewerkt in de serverlijst Als het eindpunt onbereikbaar wordt, weerspiegelt uw serverstatus de verandering binnen 10 minuten Ondersteunde responsformaten HytaleCharts detecteert automatisch meerdere JSON-formaten, zodat het werkt met de meeste query-eindpunten uit de doos: Nitrado-formaat { "Universe": { "Huidige spelers": 15 }, "Server": { "MaxPlayers": 100 } } Standaardformaat { "player_count": 15, "max_spelers": 100 } Ook ondersteunt camelCase (playerCount, maxPlayers) en steno (online, max) varianten. Setup Steps Zoek of configureer een query-eindpunt op uw hostingprovider (Nitrado levert er standaard één) Op Hytale Grafieken, ga naar Server bewerken → Externe zoekopdracht Voer de volledige URL in naar uw query-eindpunt Klik "Test Endpoint" om te controleren of het antwoord ontleedbaar is Hytale opslaan Grafieken beginnen onmiddellijk met polling De externe query methode updates minder vaak dan de hartslag plugin (elke 5 minuten vs. elke 60 seconden), maar het vereist nul server-side wijzigingen. Methode 3: UDP Ping (Automatic Fallback) Als je de hartslagplugin of een extern query-eindpunt niet hebt geconfigureerd, zal HytaleCharts proberen de status van je server te controleren via UDP ping. Dit is een passief systeem dat geen installatie nodig heeft aan uw kant. Hoe het werkt Hytale Grafieken stuurt een minimale QUIC protocol probe naar de publieke poort van uw server (standaard: 5520) Als een antwoord wordt ontvangen, wordt de server gemarkeerd met online Als er geen antwoord is na meerdere herhalingen, wordt de server gemarkeerd met offline Limitaties Geen enkel aantal spelers UDP-ping kan alleen online vs. offline bepalen, niet hoeveel spelers verbonden zijn Geen lijst van spelers Er zijn geen individuele spelersgegevens beschikbaar Minder nauwkeurige timing UDP ping is nuttig als basislijn, maar servers zijn serieus over het beklimmen van de Hytale serverlijst rankings moeten de hartslagplugin installeren of een externe query configureren voor nauwkeurige spelerstellingen. Hoe HytaleCharts de status van uw server bepaalt Wanneer meerdere methoden beschikbaar zijn, gebruikt HytaleCharts een prioritaire systeem om te bepalen welke gegevensbron te vertrouwen: Externe zoekopdracht (hoogste prioriteit, indien ingeschakeld) online als de laatste succesvolle peiling binnen 10 minuten was Hartbeat-plugin (indien geconfigureerd) UDP Ping (fallback) gebruikt het opgeslagen online/offline resultaat van de laatste controle Dit betekent dat als je zowel de hartslag plugin en een externe query geconfigureerd, de externe query heeft voorrang. De meeste operators zullen het ene of het andere gebruiken, niet beide. Wat spelers zien Op de Hytale-serverlijst verschijnt de status van uw server als een gekleurde badge: Green badge met spelersaantal (bijv. "Online 47 spelers") Green badge ("Online") Rode badge ("Offline") Servers met zichtbaar aantal spelers trekken consequent meer klikken aan. Een server die "Online Daarom is de hartslag plugin of externe query belangrijk voor top Hytale servers. Probleemoplossing ProbleemEcht waar OorzaakFix Server toont "Offline" ondanks het uitvoeren van Firewall blokkerende hartslag of pingZorg ervoor dat uw server uitgaande HTTPS-verzoeken kan doen naar hytalecharts.com Het aantal spelers dat vastzit op 0Plugin die geen playergebeurtenissen volgtVerifiëren van de geladen plugin (controleer de logs van de server) en herstart Hartbeat stopt na een tijdjePlugin is gecrasht of gelostServerlogs controleren op fouten, indien nodig de plugin opnieuw installeren Externe query toont foute tellingEndpoint returning stale dataVerifiëren het antwoord van JSON direct in een browser Multi-instance count is too lowInstances using different secretsAlle instanties moeten hetzelfde hartslaggeheim delen "Update Beschikbaar" waarschuwingPlugin is verouderdDownload de nieuwste pluginversie van HytaleCharts Beste praktijken Operatoren die top draaien Hytale-servers volg deze patronen: Gebruik de hartslag plugin waar mogelijk Het is de meest accurate en responsieve optie Instellen van een realistische max player count ingedrukte caps (bijv. 999) zien er oneerlijk uit en verminderen het vertrouwen Monitor je hartslagstatus Controleer periodiek de pagina Server bewerken voor fouten Houd de plugin bijgewerkt Verouderde plugins kunnen stoppen met werken na API-wijzigingen Externe query gebruiken als back-up als uw plugin naar beneden gaat, houdt een werkend extern eindpunt uw status nauwkeurig Zorg ervoor dat uw domein correct is De UDP ping fallback maakt gebruik van uw geconfigureerde domein, dus houd het nauwkeurig, zelfs als u primair de hartslag gebruikt Aan de slag Het afspelen van uw spelers tellen duurt minder dan vijf minuten met de hartslag plugin. Genereer een geheim, installeer de plugin, voeg je geheim toe aan de configuratie en herstart. Uw Hytale server verschijnt op de Hytale-serverlijst met een aantal livespelers binnen een minuut. Voor managed hosting providers zoals Nitrado is de externe query nog eenvoudiger en plak gewoon een URL en HytaleCharts verwerkt de rest. Ether way, het tonen van een echte speler tellen is een van de makkelijkste dingen die u kunt doen om de zichtbaarheid van uw server te verhogen en nieuwe spelers aan te trekken. Servers die actieve spelers tonen tellen op de Hytale-serverlijst overtreft consequent degenen die dat niet doen.