Jak skonfigurować haki i powiadomienia dla serwera Hytale

< p > HytaleCharts oferuje kilka opcji integracji, które pozwalają na połączenie Lista serwerów Hytale na Discord, serwer gier i narzędzia zewnętrzne. Kiedy gracz głosuje na Twój serwer, możesz otrzymać powiadomienie Discord, uruchomić w grze nagrody za pomocą Votifier, odpalić własny haczyk na własny backend i utrzymać status serwera na bieżąco z wtyczką do bicia serca. < p > Niniejszy przewodnik opisuje, jak skonfigurować każdą integrację od podstaw. Wszystkie te funkcje są dostępne na stronie edycji serwera w HytaleCharts po zalogowaniu się jako właściciel serwera lub członek zespołu. < / p > < h2 > Discord Vote Webhacks < / h2 > < p > Discord webhacks pozwala na otrzymywanie powiadomienia w kanale Discord za każdym razem, gdy ktoś głosuje na, Ulubione lub zostawia recenzję na liście serwerów. < / p > < h3 > Ustawienie Discord Webhacks < / h3 > < ol > < li > < strong > Tworzenie haka na serwerze Discord. < / strong > Przejdź do ustawień serwera, potem Integrations, potem Webhacks. Kliknij przycisk "New Webhook", podaj nazwę (np. "HytaleCharts Vootes"), wybierz kanał i skopiuj adres URL. < / li > < li > < strong > Dodaj adres URL haka na HytaleCharts. < / strong > Przejdź do strony edycji serwera, znajdź sekcję Discord Webhook i wklej adres URL. < / li > < li > < silny > Zapisz ustawienia. < / silny > Hytale Wykresy będą teraz wysyłać sformatowany embed na kanał Discord za każdym razem, gdy odbędzie się głosowanie, ulubiony lub review event. < / li > < / ol > < h3 > Co wysyła < / h3 > < p > Każde powiadomienie o haku jest wysyłane jako zagnieżdżone Discord zawierające: < / p > < ul > < li > Rodzaj wydarzenia (głosowanie, ulubione, przegląd) < / li > < li > Nazwa użytkownika gracza, który wykonał akcję < / li > < li > A timestamp < / li > < li > Nazwa serwera i odnośnik do listy HytaleCharts < / li > < / ul > < p > Dostawa webhook wykorzystuje system ponownych prób z 3 próbami i 5-sekundowym backupem pomiędzy powtórkami. Jeśli wszystkie próby zawiodą, awaria jest zalogowana, a HytaleCharts śledzi kolejne niepowodzenia na serwerze. Jeśli adres URL webhook konsekwentnie zawodzi (zwraca błędy HTTP lub times out), zostanie on ostatecznie oznaczony, dzięki czemu można go zaktualizować lub naprawić. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba23b50cbcd001176c66b _ 66 _ _ farm.jpg" alt = "A Hytale farm pokazujący rodzaj serwera buduje, które korzystają z narzędzi zaangażowania społeczności" loading = "leniwy" styl = "szerokość: 100%; wysokość: auto; promień graniczny: 8px; margines: 1.5rem 0;" / > < h2 > Votifier: In-Game Głosuj na nagrody < / h2 > < p > Votifier jest protokołem, który wysyła powiadomienia o głosach bezpośrednio do serwera gier, pozwalając nagradzać graczy w grze podczas głosowania na HytaleCharts. Hytale Wykresy obsługują trzy warianty Votifier. < / p > < h3 > Votifier v1 (RSA Szyfrowane) < / h3 > < p > Oryginalny protokół Votifier używa szyfrowania RSA. Po oddaniu głosowania HytaleCharts szyfruje wiadomość głosową za pomocą klucza publicznego serwera i wysyła ją za pośrednictwem TCP. < / p > < p > Aby skonfigurować Votifier v1: < / p > < ol > < li > Zainstaluj wtyczkę kompatybilną z Votifier- Serwer Hytale < / li > < li > Generowanie pary kluczy RSA (wtyczka zazwyczaj robi to automatycznie przy pierwszym uruchomieniu) < / li > < li > Kopiuj swój < silny > klucz publiczny < / silny > z konfiguracji wtyczki < / li > < li > Na Hytale Wykresy, przejdź do strony edycji serwera i ustaw typ Votifier na "v1" < / li > < li > Podaj swój serwer < strong > host < / strong > (adres IP lub domena), < strong > port < / strong > (port nasłuchowy Votifier, nie port gry) i wklej < strong > klucz publiczny < / strong > < / li > < li > Zapisz i użyj przycisku "Test Connection", aby sprawdzić, czy działa < / li > < / ol > < p > Wiadomość do głosowania jest zgodna ze standardowym formatem Votifier: < code > VOTE\ nHytaleCharts\ n {username}\ n {ip _ address}\ n {timestamp}\ n < / code >, zaszyfrowany PKCS # 1 v1.5 Padding. < / p > < h3 > Votifier v2 (HMAC- SHA256) < / h3 > < p > Votifier v2 jest bardziej nowoczesnym protokołem. Zamiast szyfrowania RSA, używa podpisów HMAC- SHA256 ze współdzielonym tokerem. Uścisk dłoni zawiera ciąg wyzwań z serwera, aby zapobiec atakom powtórki. < / p > < p > Aby skonfigurować Votifier v2: < / p > < ol > < li > Instaluj kompatybilny v2- Wtyczka Wtyczki < / li > < li > Znajdź < silny > token < / silny > (wspólny sekret) w pliku konfiguracyjnym wtyczki < / li > < li > Na Hytale Wykresy, ustawić typ Votifier na "v2" < / li > < li > Wprowadź serwer < strong > host < / strong >, < strong > port < / strong > i < strong > token < / strong > < / li > < li > Zapisz i przetestuj połączenie < / li > < / ol > < p > Protokół v2 łączy się przez TCP, czyta powitanie uściskiem dłoni za pomocą symbolu wyzwania, a następnie wysyła pakiet binarny zawierający ładunek JSON podpisany z HMAC- SHA256. Ładunek zawiera nazwę usługi ("HytaleCharts"), nazwę użytkownika, adres IP, znacznik czasu w milisekundach oraz ciąg zadań. < / p > < h3 > HTTP Votifier < / h3 > < p > W przypadku wtyczek specyficznych dla Hytalea, które używają HTTP zamiast surowego TCP, HytaleCharts obsługuje tryb końcowy HTTP. Jest to najprostszy protokół do wdrożenia dla programistów plugin. < / p > < p > Aby skonfigurować Votifier HTTP: < / p > < ol > < li > Zainstaluj wtyczkę, która ujawnia punkt końcowy HTTP dla otrzymania głosów < / li > < li > Na Hytale Wykresy, ustawić typ głośnika na "HTTP" < / li > < li > Wprowadź pełny < silny > punkt końcowy URL < / silny > (np., < kod > https: / / your- server.com: 8080 / vote < / code >) < / li > < li > Jeśli wtyczka wymaga symbolu, wpisz go w polu token. HytaleCharts podpisze wniosek podpisem HMAC- SHA256 w < kodzie > X- Votifier- Signature < / code > nagłówek. < / li > < li > Zapisz i przetestuj < / li > < / ol > < p > Żądanie HTTP wysyła ciało JSON z < kodem > nazwa usługi < / kod >, < kod > nazwa użytkownika < / kod >, < kod > adres < / kod > i < kod > znacznik czasu < / kod > pola. < / p > < h3 > Ważne uwagi dla wszystkich typów głośników < / h3 > < ul > < li > < strong > Nazwy użytkowników są skrócone do 16 znaków < / strong >, aby dopasować limit nazwy użytkownika Hytale. HytaleCharts używa Hytale użytkownika gracza jeśli jest ustawiony, w przeciwnym razie ich nazwa użytkownika Discord. < / li > < li > < silny > Czas połączenia wynosi 5 sekund. < / silny > Jeśli serwer nie odpowie w ciągu 5 sekund, próba zostanie uznana za nieudaną. < / li > < li > < silny > Próby nieudane ponownie spróbować do 3 razy < / silny > z wykładniczym backup (10s, 30s, 60s między próbami). < / li > < li > Możesz użyć przycisku < strong > Test Connection < / strong > w HytaleCharts, aby zweryfikować konfigurację bez konieczności prawdziwego głosowania. Sprawdza, czy serwer jest osiągalny i odpowiada oczekiwanym uściskiem dłoni. < / li > < / ul > < h2 > Generic Webhacks < / h2 > < p > Jeśli chcesz wysyłać powiadomienia o głosowaniach na własną usługę, bot lub aplikację, ogólne haki internetowe pozwalają zdefiniować własny adres URL i szablon obciążenia. < / p > < h3 > Jak działają ogólne haki internetowe < / h3 > < ol > < li > Na stronie edycji serwera przejdź do sekcji konfiguracji haka webowego < / li > < li > Podaj < silny > URL < / silny > punktu końcowego < / li > < li > Konfiguracja szablonu < silnej > ładowności < / silnej > z danymi, które chcesz otrzymać < / li > < li > Zapisz ustawienia < / li > < / ol > < p > W przypadku wystąpienia zdarzenia głosującego, HytaleCharts wysyła żądanie HTTP POST na adres URL z skonfigurowanym ładunkiem. System obsługuje zmienne szablonów, które zastępuje się wartościami rzeczywistymi w czasie wysyłania (nazwa użytkownika głosującego, nazwa serwera, znacznik czasu itp.). < / p > < p > Generic webhacks używać ten sam ponowny logika jak Discord webhacks: 3 próby z progressive backuff (10, następnie 30 między retries). Jeśli wszystkie powtórzenia nie powiodą się, awaria zostanie wyśledzona na serwerze, a trwałe awarie będą oznaczone na tablicy rozdzielczej. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba02d50cbcd001176c5ff _ 30 _ _ outlander _ settlement.jpg" alt = "An Outlander osada w Hytale pokazująca rodzaj serwerów społecznościowych, które korzystają z integracji webhook" loading = "leniwy" style = "szerokość: 100%; wysokość: auto; promień graniczny: 8px; margines: 1.5rem 0;" / > < h2 > Wtyczka Heartbeat: Śledzenie statusu online < / h2 > < p > Wtyczka HytaleCharts do bicia serca działa na serwerze gry i wysyła okresowe aktualizacje statusu, tak aby lista zawsze pokazuje dokładny status online / offline i liczy graczy. < / p > < h3 > Jak to działa < / h3 > < p > Wtyczka wysyła bicie serca do < kodu > https: / / hytalecharts.com / api / bicie serca < / kod > co 5 minut (lub co 20 sekund dla serwerów premium). Każde bicie serca obejmuje: < / p > < ul > < li > Twój serwer jest < silny > tajemnica bicia serca < / strong > (64- znak symbolu) < / li > < li > Bieżący < silny > Liczba graczy < / silny > i < silny > Max gracze < / silny > < / li > < li > A < strong > players array < / strong > with indywidual player details (username, UUID, world, ping) < / li > < li > Metadane serwera jak < strong > nazwa serwera < / strong >, < strong > MOTD < / strong >, < strong > uptime < / strong >, i < strong > use pamięci < / strong > < / li > < li > Lista < mocne > zainstalowane wtyczki < / silne > i < silne > nazwy świata < / silne > < / li > < / ul > < h3 > Etapy konfiguracji < / h3 > < ol > < li > < strong > Generowanie sekretu bicia serca. < / strong > Na stronie edycji serwera przejdź do sekcji Heartbeat i kliknij "Generuj tajemnicę". Tworzy to unikalny 64-znakowy symbol. < / li > < li > < strong > Instaluj wtyczkę. < / strong > Umieść wtyczkę HytaleCharts w serwerze < code > mods / < / code > < / li > < li > < silny > Konfiguracja wtyczki. < / silny > Edytuj plik < kod wtyczki > config.json < / code > i ustaw sekret: < pre > < kod > { "Secret": "Your _ 64 _ CHAR _ HEARTBEAT _ SECRET", "debug": false < / kod > < / przed > < / li > < li > < strong > Przywróć serwer. < / strong > Wtyczka rozpocznie wysyłanie uderzeń serca natychmiast. < / li > < li > < silny > Weryfikuj na HytaleCharts. < / silny > Zaznacz stronę edycji serwera; powinien pokazać ostatni znacznik czasu bicia serca i wskazać, że połączenie jest aktywne. < / li > < / ol > < h3 > Agregacja wieloserwerowa < / h3 > < p > Jeśli uruchomisz wiele instancji serwera (lobby, przetrwanie, kreatywność) udostępniając ten sam sekret bicia serca, HytaleCharts automatycznie je agreguje. Identyfikuje różne instancje według ich adresu IP i nazwy serwera, pobiera najnowsze bicie serca od każdego, i łączy graczy przez UUID, aby uniknąć podwójnego liczenia. Całkowita liczba graczy i max graczy pokazanych na liście odzwierciedlają połączone wartości we wszystkich instancjach. < / p > < h3 > Priorytet statusu online < / h3 > < p > Hytale Wykresy określają status online serwera za pomocą systemu priorytetowego: < / p > < ol > < li > < silny > Zewnętrzny punkt końcowy zapytania < / silny > (jeśli skonfigurowany, np. API zapytania Nitrado) < / li > < li > < silny > Wtyczka do serca < / silny > (serwer wyświetla się w trybie online, jeśli w ciągu ostatnich 5 minut otrzymano bicie serca) < / li > < li > < strong > UDP ping < / strong > (zapytanie serwera zapasowego) < / li > < / ol > < p > Jeśli plugin serca uciszy się na dłużej niż 5 minut i nie zostanie skonfigurowane żadne zapytanie zewnętrzne, serwer wraca do statusu ping UDP. < / p > < h2 > Toki API serwera publicznego < / h2 > < p > HytaleCharts dostarcza publiczny API, który pozwala na zapytanie danych wyborców, statystyki serwerów i inne informacje programowo. Aby go używać, potrzebny jest token API. < / p > < h3 > Pobieranie Token API < / h3 > < ol > < li > Przejdź do strony edycji serwera na HytaleCharts < / li > < li > Przejdź do sekcji API < li > Generuj żeton API < / li > < li > Kopiuj i przechowuj bezpiecznie. Token uwierzytelnia wszystkie żądania do punktów końcowych API serwera publicznego. < / li > < / ol > < h3 > Stosowanie API < / h3 > < p > Dołącz token do < kodu > Autoryzacja < / kod > Nagłówek żądań API: < / p > < pre > < kod > GET / api / public / servers / {server _ id} / wyborcy Autoryzacja: Posiadacz _ API _ TOKEN < / kod > < / pre > < p > Publiczny API pozwala pobrać ostatnich wyborców, statystyki serwerów i inne dane, które można wykorzystać do tworzenia niestandardowych integracje, liderów lub systemów nagród na serwerze. < / p > < p > W celu uzyskania kompletnej dokumentacji API i szczegółowych informacji na temat punktu końcowego należy sprawdzić < a href = "/ server- api" > Strona API serwera < / a > na HytaleCharts. < / p > < h2 > Rozwiązywanie problemów < / h2 > < tabela > < głowa > < tr > < th > Issue < / th > < th > Możliwe przyczyny < / th > < th > Roztwór < / th > < / tr > < / głowa > < tbody > < tr > < td > Discord webhook niewysyłający < / td > < td > Nieprawidłowy adres URL < / td > < td > Usuwanie i odtwarzanie haka webhook w Discord, a następnie aktualizacja URL na HytaleCharts < / td > < / tr > < tr > < td > Test Votifier nie powiódł się z "Brak odpowiedzi" < / td > < td > Firewall blokujący port Votifier < / td > < td > Upewnij się, że port Votifier (nie port gry) jest otwarty w firewall < / td > < / tr > < tr > < td > Test Votifier mówi "Nieprawidłowy uścisk dłoni V2" < / td > < td > Serwer obsługuje tylko v1, ale wybrałeś v2 < / td > < td > Zmień typ Votifier na v1 i podaj klucz publiczny RSA zamiast symbolu < / td > < / tr > < tr > < td > Heartbeat nie rejestruje < / td > < td > Zły sekret w konfiguracji wtyczki < / td > < td > Double- sprawdź, czy sekret w konfiguracji. json pasuje do tego pokazanego na HytaleCharts dokładnie < / td > < / tr > < tr > < td > Liczba graczy pokazuje 0 < / td > < td > Wersja wtyczki powyżej 1.5.0 < / td > < td > Aktualizacja Hytale Wyświetla wtyczkę do najnowszej wersji, która wysyła dane dla poszczególnych graczy < / td > < / tr > < tr > < td > Haczyk internetowy oznaczony jako niepowodzenie < / td > < td > 100 + kolejne niepowodzenia < / td > < td > Poprawić punkt końcowy URL, a następnie przetestować go. Udana dostawa resetuje licznik awarii. < / td > < / tr > < / tbody > < / tabela > < p > Jeśli natkniesz się na problemy, które nie zostały tu omówione, wyciągnij je przez < a href = "/ about" > formularz kontaktowy < / a > na HytaleCharts. Możemy sprawdzić logi i historię bicia serca Twojego serwera, aby pomóc w diagnozowaniu problemów. < / p > < p > Ustawianie tych całek zajmuje kilka minut, ale znacząco poprawia interakcje pomiędzy serwerem a HytaleCharts i twoją społecznością. Serwery z aktywnymi powiadomieniami o głosowaniach i nagrodą w grze konsekwentnie widzą większe zaangażowanie i wizyty powrotne od wyborców. < a href = "/ serwery" > Przeglądaj inne listy serwerów < / a >, aby zobaczyć, jak najlepsze serwery opisują swoje funkcje integracyjne i upewnij się, że twoja własna lista wymienia to, co ustawiłeś. < / p >