Cum de a configura site-uri web și notificări pentru serverul Hytale

HytaleCharts oferă mai multe opțiuni de integrare care vă permit să conectați Server Hytale listare la Discord, server de joc, și instrumente externe. Atunci când un jucător votează pentru serverul dvs., puteți primi o notificare Discord, declanșa recompense în joc prin Votifier, foc un webhook personalizat la backend-ul propriu, și să păstreze starea serverului la zi cu modulul de bătaie a inimii. Acest ghid acoperă modul de configurare a fiecărei integrări de la zero. Toate aceste caracteristici sunt accesibile din pagina de editare a serverului dvs. pe HytaleCharts după logare ca proprietar de server sau membru al echipei. Discord Votează site-uri Discord webhooks permite primirea unei notificări pe un canal Discord de fiecare dată când cineva votează pentru, favorite, sau lasă o recenzie pe lista serverului. Setarea discordiilor Creați un webhook în serverul dvs. Discord. Du-te la Setări Server, apoi Integrari, apoi Webhooks. Faceți clic pe "New Webhook," dați un nume (de exemplu, "HytaleCharts Votes"), alegeți canalul, și copiați URL-ul webhook. Adauga URL-ul webhook pe HytaleCharts. Du-te la pagina de editare a serverului tău, găsi secțiunea Discord Webhook, și lipi URL-ul. Salvați setările. Hytale Graficele vor trimite acum un format înglobat pe canalul Discord ori de câte ori are loc un vot, un eveniment preferat sau o recenzie. Ce devine trimis Fiecare notificare webhook este trimisa ca o incorporare a discordiei ce contine: Tipul evenimentului (vot, favorit, recenzie) Numele de utilizator al jucătorului care a efectuat acțiunea A timestamp Numele serverului și un link înapoi la listarea HytaleCharts Livrarea Webhook utilizează un sistem de rejudecare cu 3 încercări și o rezervă de 5 secunde între retururi. Dacă toate încercările eşuează, eşecul este înregistrat, iar HytaleCharts urmăreşte eşecuri consecutive pe server. Dacă un URL webhook eșuează în mod constant (returnează erori HTTP sau ori afară), acesta va fi în cele din urmă marcat astfel încât să puteți actualiza sau repara. Votificator: Recompense în joc Votifier este un protocol care trimite notificări de vot direct serverului de joc, permițându-vă să recompenseze jucătorii în joc atunci când votează pe HytaleCharts. Hytale Graficele suportă trei variante de votifier. Votificator v1 (RSA criptat) Protocolul original de votificare utilizează criptarea RSA. Când un vot este distribuit, HytaleCharts criptează un mesaj de vot cu cheia publică a serverului și îl trimite prin TCP. Pentru a seta Votifier v1: Instalează un modul compatibil cu Votifier pe modulul tău Server Hytale Generează o pereche de chei RSA (modulul face de obicei acest lucru automat pe primul run) Copy your public key din configurația modulului Pe Hytale Charts, du-te la pagina de editare a serverului și setează tipul de Votifier la "v1" Introduceți serverul host (adresă sau domeniu IP), port (portul de ascultare al Votifierului, nu portul de joc) și lipiți cheia publică Salvați și utilizați butonul "Test Connection" pentru a verifica dacă funcționează Mesajul de vot urmează formatul standard de votare: VOTE\nHytaleCharts\n {utilizator}\n {ip_address}\n{timestamp}\n, criptat cu PKCS#1 v1.5 padding. Votifier v2 (HMAC-SHA256) Voltifier v2 este un protocol mai modern. În loc de criptare RSA, acesta utilizează HMAC-SHA256 semnarea cu un jeton comun. Strângerea de mână include un șir de provocare de la server pentru a preveni atacurile de reluare. Pentru a configura Votifier v2: Install a v2 compatibil Modul de votifier Găsește token (secret partajat) în fișierul de configurare al modulului Pe Hytale Grafice, setați tipul de Votifier la "v2" Introduceți serverul host, port și token Salvați și testați conexiunea Protocolul V2 se conectează prin intermediul TCP, citește un salut mână cu un jeton provocare, apoi trimite un pachet binar care conține o sarcină utilă JSON semnat cu HMAC-SHA256. Sarcina utilă include numele de serviciu ("HytaleCharts"), numele de utilizator, adresa IP, timbrul temporal în milisecunde și șirul de provocare. HTTP Votifier Pentru module specifice Hytale care utilizează HTTP în loc de TCP brut, HytaleCharts susține un mod final HTTP. Acesta este cel mai simplu protocol de implementat pentru dezvoltatorii de module. Pentru a configura Votificatorul HTTP: Instalează un modul care expune un obiectiv HTTP pentru primirea voturilor Pe Hytale Grafice, setați tipul de Votificator la "HTTP" Enter the full endpoint URL (ex., https://your-server.com:8080/vot) Dacă modulul necesită un jeton, introduceți-l în câmpul jeton. HytaleCharts va semna cererea cu o semnătură HMAC-SHA256 în X-Votifier-Signature header. Salvați și testați Cererea HTTP trimite un organism JSON cu serviceName, username, address și timestamp câmpurile. Note importante pentru toate tipurile de alegatoare Usernames are trunchiated to 16 caractere to matching Hytale's username limit. HytaleCharts folosește numele de utilizator Hytale al jucătorului dacă este setat, altfel numele de utilizator Discord. Connection timeout is 5 seconds. Dacă serverul dumneavoastră nu răspunde în 5 secunde, încercarea este considerată eșuată. Încercări eşuate de reîncercare de până la 3 ori cu retragere exponenţială (10s, 30s, 60s între încercări). Puteți utiliza butonul Test Connection de pe HytaleCharts pentru a verifica configurarea fără a avea nevoie de un vot real. Acest lucru verifică dacă serverul este accesibil și răspunde cu strângerea de mână a Votificatului așteptat. Generic Webhooks Dacă doriţi să trimiteţi notificări de vot la propriul serviciu backend, bot, sau aplicaţie, webhooks generice vă permit să definiţi un URL personalizat şi şablon sarcină utilă. How Generic Webhooks Work Pe pagina de editare a serverului, navigați la secțiunea de configurare webhook Introduceţi URL a obiectivului final Configurați șablonul payload cu datele pe care doriți să le primiți Salvaţi setările Când are loc un eveniment de vot, HytaleCharts trimite o cerere HTTP POST URL-ului cu sarcina utilă configurată. Sistemul suportă variabilele șablonului care sunt înlocuite cu valori reale la momentul trimiterii (nume de utilizator, nume de server, timbru, etc.). WEBhooks Generic folosesc aceeași logică retry ca și Discord webhooks: 3 încercări cu backoff progresiv (10s, apoi 30s între retries). În cazul în care toate retries eșuează, eșecul este urmărit împotriva serverului, iar eșecurile persistente vor fi marcate în tabloul de bord.