Jak wyświetlić liczbę graczy online na liście serwerów Hytale

Gdy gracz przegląda listę serwerów Hytale, jedna liczba decyduje, czy kliknie "Dołącz" czy będzie przewijać dalej: liczba graczy. Serwer pokazujący 47/100 graczy wygląda na żywy. Serwer nie pokazujący niczego — lub tylko "Offline" — wygląda jak miasto duchów, nawet jeśli działa prawidłowo. HytaleCharts oferuje trzy sposoby wyświetlania liczby graczy w czasie rzeczywistym i statusu online Twojego serwera Hytale. Każda metoda ma różne kompromisy w zakresie dokładności, wysiłku konfiguracji i funkcji. Ten przewodnik wyjaśnia wszystkie trzy, abyś mógł wybrać odpowiednią dla swojej konfiguracji. Trzy metody w skrócie MetodaLiczba graczySzybkość aktualizacjiWysiłek konfiguracjiNajlepsze dla Plugin HeartbeatDokładna liczba + lista graczyCo 60 sekundZainstaluj pluginSerwery self-hosted Zapytanie zewnętrzneDokładna liczbaCo 5 minutUstaw URLNitrado / hosty zarządzane Ping UDPTylko online/offlineOkresowoBrak (automatyczny)Podstawowy status awaryjny Metoda 1: Plugin Heartbeat HytaleCharts (Zalecany) Plugin heartbeat to najlepszy sposób na wyświetlenie liczby graczy na listę serwerów Hytale. Działa na Twoim serwerze Hytale i wysyła sygnał heartbeat do HytaleCharts co 60 sekund, w tym dokładną liczbę graczy online i ich nazwy użytkowników. Co raportuje Liczba graczy — aktualna liczba podłączonych graczy Maksymalna liczba graczy — limit graczy Twojego serwera Lista graczy — indywidualne nazwy użytkowników i UUID podłączonych graczy Wersja pluginu — aby HytaleCharts mógł ostrzec o aktualizacjach Jak to działa wewnętrznie Plugin wysyła żądanie POST do /api/heartbeat co 60 sekund Żądanie zawiera klucz tajny Twojego serwera (64-znakowy ciąg szesnastkowy) HytaleCharts weryfikuje sekret, aktualizuje liczbę graczy i status Twojego serwera Jeśli nie otrzymano heartbeat przez 5 minut, serwer zostaje oznaczony jako offline Dane historyczne są przechowywane do analiz i wykresów liczby graczy Kroki konfiguracji Wygeneruj sekret heartbeat — w HytaleCharts przejdź do Edytuj serwer i kliknij "Wygeneruj sekret Heartbeat" w sekcji Plugin Heartbeat Skopiuj sekret — zobaczysz go tylko raz (możesz wygenerować ponownie w razie utraty) Zainstaluj plugin HytaleCharts na swoim serwerze Hytale, umieszczając go w katalogu mods/ serwera Skonfiguruj plugin — utwórz lub edytuj config.json w katalogu danych pluginu: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Uruchom ponownie serwer — plugin natychmiast zacznie wysyłać heartbeaty Sprawdź na HytaleCharts — Twój serwer powinien pokazać się jako online z liczbą graczy w ciągu 60 sekund Obsługa wielu instancji Jeśli uruchamiasz wiele instancji serwera (np. serwer lobby i serwer survival), system heartbeat automatycznie agreguje liczby graczy. Wszystkie instancje współdzielące ten sam klucz tajny będą miały scalonych unikalnych graczy i zsumowane liczby. Oznacza to, że Twój wpis na listę serwerów Hytale pokazuje prawidłowy łączny wynik w całej sieci. System identyfikuje unikalne instancje po adresie IP i nazwie świata, pobiera najnowszy heartbeat z każdego źródła i scala graczy po UUID, aby uniknąć podwójnego liczenia osób podłączonych do wielu instancji. Aktualizacje pluginu HytaleCharts śledzi wersję Twojego pluginu. Jeśli dostępna jest nowsza wersja, strona Edytuj serwer wyświetli ostrzeżenie "Dostępna aktualizacja". Utrzymywanie pluginu na bieżąco zapewnia kompatybilność z zmianami API i daje najnowsze poprawki błędów. Metoda 2: Zewnętrzny endpoint zapytania (Nitrado i hosty zarządzane) Nie wszyscy operatorzy serwerów Hytale mają dostęp do instalacji niestandardowych pluginów. Jeśli korzystasz z Nitrado, hosta kontenerowego lub dowolnego dostawcy udostępniającego endpoint zapytania, system zewnętrznego zapytania jest Twoim rozwiązaniem. Jak to działa Podajesz HytaleCharts URL zwracający liczbę graczy serwera jako JSON HytaleCharts odpytuje ten URL co 5 minut Odpowiedź jest analizowana, a liczba graczy jest aktualizowana na liście serwerów Jeśli endpoint stanie się nieosiągalny, status Twojego serwera odzwierciedli zmianę w ciągu 10 minut Obsługiwane formaty odpowiedzi HytaleCharts automatycznie wykrywa wiele formatów JSON, więc działa z większością endpointów zapytań bez dodatkowej konfiguracji: Format Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Format standardowy { "player_count": 15, "max_players": 100 } Obsługuje również warianty camelCase (playerCount, maxPlayers) i skrócone (online, max). Kroki konfiguracji Znajdź lub skonfiguruj endpoint zapytania u swojego dostawcy hostingu (Nitrado udostępnia go domyślnie) W HytaleCharts przejdź do Edytuj serwer → Zapytanie zewnętrzne Wprowadź pełny URL endpointu zapytania Kliknij "Testuj endpoint" aby sprawdzić, czy odpowiedź jest parsowalna Zapisz — HytaleCharts natychmiast rozpocznie odpytywanie Metoda zewnętrznego zapytania aktualizuje się rzadziej niż plugin heartbeat (co 5 minut vs. co 60 sekund), ale nie wymaga żadnych modyfikacji po stronie serwera. Metoda 3: Ping UDP (Automatyczny fallback) Jeśli nie skonfigurowałeś ani pluginu heartbeat, ani zewnętrznego endpointu zapytania, HytaleCharts spróbuje sprawdzić status serwera przez ping UDP. To pasywny system, który nie wymaga konfiguracji z Twojej strony. Jak to działa HytaleCharts wysyła minimalną sondę protokołu QUIC na publiczny port serwera (domyślnie: 5520) Jeśli otrzymano jakąkolwiek odpowiedź, serwer jest oznaczany jako online Jeśli brak odpowiedzi po wielu próbach, serwer jest oznaczany jako offline Ograniczenia Brak liczby graczy — ping UDP może jedynie określić online vs. offline, nie ilu graczy jest podłączonych Brak listy graczy — dane indywidualnych graczy nie są dostępne Mniej dokładne taktowanie — aktualizacje statusu zależą od harmonogramu odpytywania, a nie od heartbeatów w czasie rzeczywistym Ping UDP jest przydatny jako punkt odniesienia, ale serwery chcące wspinać się w rankingach listę serwerów Hytale powinny zainstalować plugin heartbeat lub skonfigurować zewnętrzne zapytanie dla dokładnych liczb graczy. Jak HytaleCharts określa status Twojego serwera Gdy dostępnych jest wiele metod, HytaleCharts używa systemu priorytetów do decydowania, któremu źródłu danych zaufać: Zapytanie zewnętrzne (najwyższy priorytet, jeśli włączony) — online, jeśli ostatnie pomyślne odpytanie było w ciągu 10 minut Plugin Heartbeat (jeśli skonfigurowany) — online, jeśli ostatni heartbeat był w ciągu 5 minut Ping UDP (fallback) — używa zapisanego wyniku online/offline z ostatniego sprawdzenia Oznacza to, że jeśli masz skonfigurowane zarówno plugin heartbeat, jak i zewnętrzne zapytanie, zewnętrzne zapytanie ma priorytet. Większość operatorów użyje jednego lub drugiego, nie obu. Co widzą gracze Na listę serwerów Hytale status Twojego serwera pojawia się jako kolorowa odznaka: Zielona odznaka z liczbą graczy (np. "Online — 47 graczy") — gdy online i wykryto graczy Zielona odznaka ("Online") — gdy online, ale bez graczy lub liczba niedostępna Czerwona odznaka ("Offline") — gdy brak ostatniego heartbeatu, zapytania lub odpowiedzi ping Serwery z widocznymi liczbami graczy konsekwentnie przyciągają więcej kliknięć. Serwer pokazujący "Online — 23 graczy" jest znacznie bardziej atrakcyjny niż ten, który mówi tylko "Online" bez liczby. Dlatego plugin heartbeat lub zewnętrzne zapytanie jest ważne dla najlepszych serwerów Hytale. Rozwiązywanie problemów ProblemPrawdopodobna przyczynaRozwiązanie Serwer pokazuje "Offline" mimo działaniaZapora blokuje heartbeat lub pingUpewnij się, że serwer może wykonywać wychodzące żądania HTTPS do hytalecharts.com Liczba graczy utknęła na 0Plugin nie śledzi zdarzeń graczySprawdź, czy plugin się załadował (sprawdź logi serwera) i uruchom ponownie Heartbeat zatrzymuje się po pewnym czasiePlugin się zawiesił lub został wyładowanySprawdź logi serwera pod kątem błędów, w razie potrzeby przeinstaluj plugin Zewnętrzne zapytanie pokazuje błędną liczbęEndpoint zwraca przestarzałe daneZweryfikuj odpowiedź JSON bezpośrednio w przeglądarce Liczba wielu instancji jest zbyt niskaInstancje używają różnych sekretówWszystkie instancje muszą współdzielić ten sam sekret heartbeat Ostrzeżenie "Dostępna aktualizacja"Plugin jest przestarzałyPobierz najnowszą wersję pluginu z HytaleCharts Najlepsze praktyki Operatorzy prowadzący najlepszych serwerów Hytale stosują te wzorce: Używaj pluginu heartbeat zawsze, gdy to możliwe — to najdokładniejsza i najszybciej reagująca opcja Ustaw realistyczną maksymalną liczbę graczy — zawyżone limity (np. 999) wyglądają nieuczciwie i zmniejszają zaufanie Monitoruj status heartbeat — regularnie sprawdzaj stronę Edytuj serwer pod kątem błędów Aktualizuj plugin — przestarzałe pluginy mogą przestać działać po zmianach API Używaj zewnętrznego zapytania jako kopii zapasowej — jeśli plugin przestanie działać, działający zewnętrzny endpoint utrzyma dokładność statusu Upewnij się, że Twoja domena jest prawidłowa — fallback ping UDP używa skonfigurowanej domeny, więc utrzymuj ją dokładną, nawet jeśli głównie używasz heartbeat Rozpoczęcie Wyświetlanie liczby graczy zajmuje mniej niż pięć minut z pluginem heartbeat. Wygeneruj sekret, zainstaluj plugin, dodaj sekret do konfiguracji i uruchom ponownie. Twój serwer Hytale pojawi się na listę serwerów Hytale z liczbą graczy na żywo w ciągu minuty. Dla zarządzanych dostawców hostingu, takich jak Nitrado, zewnętrzne zapytanie jest jeszcze prostsze — po prostu wklej URL, a HytaleCharts zajmie się resztą. Tak czy inaczej, pokazanie prawdziwej liczby graczy jest jedną z najłatwiejszych rzeczy, które możesz zrobić, aby zwiększyć widoczność serwera i przyciągnąć nowych graczy. Serwery, które pokazują aktywne liczby graczy na listę serwerów Hytale konsekwentnie przewyższają te, które tego nie robią.