So zeigst du die Online-Spieleranzahl in der Hytale-Serverliste an

Wenn ein Spieler die Hytale-Serverliste durchsucht, entscheidet eine Zahl, ob er auf "Beitreten" klickt oder weiterschrollt: die Spieleranzahl. Ein Server, der 47/100 Spieler anzeigt, wirkt lebendig. Ein Server, der nichts anzeigt — oder nur "Offline" — wirkt wie eine Geisterstadt, selbst wenn er einwandfrei lauft. HytaleCharts bietet drei Moglichkeiten, die Echtzeit-Spieleranzahl und den Online-Status deines Hytale-Servers anzuzeigen. Jede Methode hat unterschiedliche Kompromisse bei Genauigkeit, Einrichtungsaufwand und Funktionen. Dieser Leitfaden erklart alle drei, damit du die richtige fur dein Setup wahlen kannst. Die drei Methoden im Uberblick MethodeSpieleranzahlAktualisierungsgeschwindigkeitEinrichtungsaufwandAm besten fur Heartbeat-PluginExakte Anzahl + SpielerlisteAlle 60 SekundenPlugin installierenSelbst gehostete Server Externe AbfrageExakte AnzahlAlle 5 MinutenEine URL festlegenNitrado / verwaltete Hosts UDP-PingNur Online/OfflinePeriodischKeiner (automatisch)Grundlegender Status-Fallback Methode 1: HytaleCharts Heartbeat-Plugin (Empfohlen) Das Heartbeat-Plugin ist der beste Weg, deine Spieleranzahl in der Hytale-Serverliste anzuzeigen. Es lauft auf deinem Hytale-Server und sendet alle 60 Sekunden ein Heartbeat-Signal an HytaleCharts, einschliesslich der genauen Anzahl der Online-Spieler und ihrer Benutzernamen. Was es meldet Spieleranzahl — die aktuelle Anzahl verbundener Spieler Maximale Spieler — das Spielerlimit deines Servers Spielerliste — individuelle Benutzernamen und UUIDs der verbundenen Spieler Plugin-Version — damit HytaleCharts dich uber Updates informieren kann Wie es unter der Haube funktioniert Das Plugin sendet alle 60 Sekunden eine POST-Anfrage an /api/heartbeat Die Anfrage enthalt den geheimen Schlussel deines Servers (ein 64-Zeichen-Hex-String) HytaleCharts validiert das Geheimnis, aktualisiert die Spieleranzahl und den Status deines Servers Wenn 5 Minuten lang kein Heartbeat empfangen wird, wird der Server als offline markiert Historische Daten werden fur Analysen und Spieleranzahl-Diagramme gespeichert Einrichtungsschritte Generiere ein Heartbeat-Geheimnis — gehe auf HytaleCharts zu Server bearbeiten und klicke auf "Heartbeat-Geheimnis generieren" im Abschnitt Heartbeat-Plugin Kopiere das Geheimnis — du siehst es nur einmal (du kannst es bei Verlust neu generieren) Installiere das HytaleCharts-Plugin auf deinem Hytale-Server, indem du es in das mods/-Verzeichnis deines Servers legst Konfiguriere das Plugin — erstelle oder bearbeite config.json im Datenverzeichnis des Plugins: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Starte deinen Server neu — das Plugin beginnt sofort mit dem Senden von Heartbeats Uberprufe auf HytaleCharts — dein Server sollte innerhalb von 60 Sekunden als online mit einer Spieleranzahl angezeigt werden Multi-Instanz-Unterstutzung Wenn du mehrere Server-Instanzen betreibst (z.B. einen Lobby-Server und einen Survival-Server), aggregiert das Heartbeat-System die Spieleranzahlen automatisch. Alle Instanzen, die denselben geheimen Schlussel teilen, werden ihre einzigartigen Spieler zusammengefuhrt und die Gesamtzahlen summiert. Das bedeutet, dein Eintrag in der Hytale-Serverliste zeigt die korrekte Gesamtzahl uber dein gesamtes Netzwerk. Das System identifiziert einzigartige Instanzen anhand der IP-Adresse und des Weltnamens, nimmt den letzten Heartbeat von jeder Quelle und fusioniert Spieler anhand der UUID, um Doppelzahlungen bei Spielern zu vermeiden, die mit mehreren Instanzen verbunden sind. Plugin-Updates HytaleCharts verfolgt deine Plugin-Version. Wenn eine neuere Version verfugbar ist, zeigt deine Server-bearbeiten-Seite eine "Update verfugbar"-Warnung an. Das Plugin aktuell zu halten stellt die Kompatibilitat mit API-Anderungen sicher und bringt dir die neuesten Fehlerbehebungen. Methode 2: Externer Abfrage-Endpunkt (Nitrado & verwaltete Hosts) Nicht alle Hytale-Server-Betreiber haben Zugang zur Installation benutzerdefinierter Plugins. Wenn du Nitrado, einen Container-basierten Host oder einen beliebigen Anbieter verwendest, der einen Abfrage-Endpunkt bereitstellt, ist das externe Abfragesystem deine Losung. Wie es funktioniert Du stellst HytaleCharts eine URL bereit, die die Spieleranzahl deines Servers als JSON zuruckgibt HytaleCharts fragt diese URL alle 5 Minuten ab Die Antwort wird analysiert und deine Spieleranzahl wird in der Serverliste aktualisiert Wenn der Endpunkt nicht mehr erreichbar ist, spiegelt der Status deines Servers die Anderung innerhalb von 10 Minuten wider Unterstutzte Antwortformate HytaleCharts erkennt automatisch mehrere JSON-Formate, sodass es mit den meisten Abfrage-Endpunkten sofort funktioniert: Nitrado-Format { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Standardformat { "player_count": 15, "max_players": 100 } Unterstutzt auch camelCase-Varianten (playerCount, maxPlayers) und Kurzformen (online, max). Einrichtungsschritte Finde oder konfiguriere einen Abfrage-Endpunkt bei deinem Hosting-Anbieter (Nitrado stellt standardmassig einen bereit) Gehe auf HytaleCharts zu Server bearbeiten → Externe Abfrage Gib die vollstandige URL deines Abfrage-Endpunkts ein Klicke auf "Endpunkt testen", um zu uberprufen, ob die Antwort analysierbar ist Speichern — HytaleCharts beginnt sofort mit der Abfrage Die externe Abfragemethode aktualisiert seltener als das Heartbeat-Plugin (alle 5 Minuten vs. alle 60 Sekunden), erfordert aber keine serverseitigen Anderungen. Methode 3: UDP-Ping (Automatischer Fallback) Wenn du weder das Heartbeat-Plugin noch einen externen Abfrage-Endpunkt konfiguriert hast, versucht HytaleCharts, den Status deines Servers uber UDP-Ping zu prufen. Dies ist ein passives System, das keine Einrichtung deinerseits erfordert. Wie es funktioniert HytaleCharts sendet eine minimale QUIC-Protokoll-Sonde an den offentlichen Port deines Servers (Standard: 5520) Wenn eine Antwort empfangen wird, wird der Server als online markiert Wenn nach mehreren Versuchen keine Antwort erfolgt, wird der Server als offline markiert Einschrankungen Keine Spieleranzahl — UDP-Ping kann nur Online vs. Offline bestimmen, nicht wie viele Spieler verbunden sind Keine Spielerliste — keine individuellen Spielerdaten verfugbar Weniger genaues Timing — Statusaktualisierungen hangen vom Abfragezeitplan ab, nicht von Echtzeit-Heartbeats UDP-Ping ist als Grundlinie nutzlich, aber Server, die in den Rankings der Hytale-Serverliste aufsteigen wollen, sollten das Heartbeat-Plugin installieren oder eine externe Abfrage fur genaue Spieleranzahlen konfigurieren. Wie HytaleCharts den Status deines Servers bestimmt Wenn mehrere Methoden verfugbar sind, verwendet HytaleCharts ein Prioritatssystem, um zu entscheiden, welcher Datenquelle vertraut wird: Externe Abfrage (hochste Prioritat, falls aktiviert) — online, wenn die letzte erfolgreiche Abfrage innerhalb von 10 Minuten war Heartbeat-Plugin (falls konfiguriert) — online, wenn der letzte Heartbeat innerhalb von 5 Minuten war UDP-Ping (Fallback) — verwendet das gespeicherte Online/Offline-Ergebnis der letzten Prufung Das bedeutet, wenn du sowohl das Heartbeat-Plugin als auch eine externe Abfrage konfiguriert hast, hat die externe Abfrage Vorrang. Die meisten Betreiber werden eines von beiden verwenden, nicht beides. Was Spieler sehen In der Hytale-Serverliste erscheint der Status deines Servers als farbiges Abzeichen: Grunes Abzeichen mit Spieleranzahl (z.B. "Online — 47 Spieler") — wenn online und Spieler erkannt werden Grunes Abzeichen ("Online") — wenn online, aber keine Spieler oder Anzahl nicht verfugbar Rotes Abzeichen ("Offline") — wenn kein aktueller Heartbeat, keine Abfrage oder Ping-Antwort Server mit sichtbaren Spieleranzahlen ziehen konsistent mehr Klicks an. Ein Server, der "Online — 23 Spieler" anzeigt, ist weitaus uberzeugender als einer, der nur "Online" ohne Anzahl sagt. Deshalb ist das Heartbeat-Plugin oder die externe Abfrage wichtig fur Top-Hytale-Server. Fehlerbehebung ProblemWahrscheinliche UrsacheLosung Server zeigt "Offline" trotz BetriebFirewall blockiert Heartbeat oder PingStelle sicher, dass dein Server ausgehende HTTPS-Anfragen an hytalecharts.com senden kann Spieleranzahl bleibt bei 0Plugin verfolgt keine Spieler-EventsUberprufe, ob das Plugin geladen wurde (Server-Logs prufen) und starte neu Heartbeat stoppt nach einer WeilePlugin abgesturzt oder entladenPrufe Server-Logs auf Fehler, installiere das Plugin bei Bedarf neu Externe Abfrage zeigt falsche AnzahlEndpunkt liefert veraltete DatenUberprufe die JSON-Antwort direkt im Browser Multi-Instanz-Anzahl ist zu niedrigInstanzen verwenden verschiedene GeheimnisseAlle Instanzen mussen dasselbe Heartbeat-Geheimnis teilen "Update verfugbar"-WarnungPlugin ist veraltetLade die neueste Plugin-Version von HytaleCharts herunter Best Practices Betreiber von Top-Hytale-Servern folgen diesen Mustern: Verwende das Heartbeat-Plugin wann immer moglich — es ist die genaueste und reaktionsschnellste Option Setze eine realistische maximale Spieleranzahl — aufgeblahte Limits (z.B. 999) wirken unehrlich und reduzieren das Vertrauen Uberwache deinen Heartbeat-Status — uberprufe regelmassig die Server-bearbeiten-Seite auf Fehler Halte das Plugin aktuell — veraltete Plugins konnen nach API-Anderungen aufhoren zu funktionieren Verwende die externe Abfrage als Backup — wenn dein Plugin ausfallt, halt ein funktionierender externer Endpunkt deinen Status genau Stelle sicher, dass deine Domain korrekt ist — der UDP-Ping-Fallback verwendet deine konfigurierte Domain, also halte sie genau, auch wenn du hauptsachlich den Heartbeat verwendest Erste Schritte Die Anzeige deiner Spieleranzahl dauert mit dem Heartbeat-Plugin weniger als funf Minuten. Generiere ein Geheimnis, installiere das Plugin, fuge dein Geheimnis zur Konfiguration hinzu und starte neu. Dein Hytale-Server erscheint innerhalb einer Minute mit einer Live-Spieleranzahl in der Hytale-Serverliste. Fur verwaltete Hosting-Anbieter wie Nitrado ist die externe Abfrage noch einfacher — fuge einfach eine URL ein und HytaleCharts erledigt den Rest. So oder so ist das Anzeigen einer echten Spieleranzahl eine der einfachsten Massnahmen, die du ergreifen kannst, um die Sichtbarkeit deines Servers zu erhohen und neue Spieler anzuziehen. Server, die aktive Spieleranzahlen in der Hytale-Serverliste anzeigen, ubertreffen durchweg diejenigen, die es nicht tun.