Sådan indstilles Webkrogs og meddelelser til din Hytale Server

< p > HytaleCharts giver flere integrationsmuligheder, der lader dig tilslutte din Hytaleserver liste til Discord, din spilserver, og eksterne værktøjer. Når en spiller stemmer på din server, kan du modtage en Discord meddelelse, udløse in- game belønninger via Votifier, fyre en brugerdefineret webhook til din egen motor, og holde din server status up-to- date med hjerterytmen plugin. < / p > < p > Denne vejledning dækker, hvordan man opretter hver integration fra bunden. Alle disse funktioner er tilgængelige fra din servers redigeringsside på HytaleCharts efter logning i som server ejer eller et team medlem. < / p > < h2 > Discord Stem Webkroge < / h2 > < p > Diskord webkroge lader dig modtage en meddelelse i en Diskord kanal hver gang nogen stemmer for, favoritter, eller efterlader en gennemgang på din server liste. < / p > < h3 > Opsætning af discord Webkroge < / h3 > < ol > < li > < stærk > Opret en webhook i din Discord server. < / stærk > Gå til Serverindstillinger, derefter Integrationer, derefter Webkrogs. Klik på "New Webhook", giv det et navn (fx "HytaleCharts Stemmer"), vælg kanalen, og kopiere webhook URL. < / li > < li > < stærk > Tilføj webshook URL på HytaleCharts. < / stærk > Gå til din servers redigeringsside, find afsnittet Discord Webhook, og indsæt URL 'en. < / li > < li > < stærk > Gem dine indstillinger. < / stærk > Hytale Tegn vil nu sende en formateret indlejret til din Discord kanal, når en stemme, favorit, eller gennemgang begivenhed. < / li > < / ol > < h3 > Hvad bliver sendt < / h3 > < p > Hver webhook meddelelse sendes som en Discord, der indeholder: < / p > < ul > < li > Type begivenhed (stemme, favorit, anmeldelse) < / li > < li > Brugernavnet på den spiller, der udførte handlingen < / li > < li > Et tidsstempel < / li > < li > Dit servernavn og et link tilbage til din HytaleCharts liste < / li > < / ul > < p > Webhook levering bruger et gentry system med 3 forsøg og en 5-sekunders backoff mellem reles. Hvis alle forsøg mislykkes, er fejlen logget, og HytaleCharts sporer hinanden fejl per server. Hvis en webhook URL konsekvent mislykkes (returnerer HTTP fejl eller tidspunkter ud), vil det i sidste ende blive markeret, så du kan opdatere eller løse det. < / p > < img src = "https: / / cdn.hytalie.com / 5e7ba23b50cbcd001176c66b _ 66 _ _ _ farm.jpg" alt = "A Hytale farm viser den type server bygger, der drager fordel af community engagement værktøjer" loading = "doven" stil = "bredde: 100%; højde: auto; border-radius: 8px; margin: 1,5 rem 0;" / > < h2 > Votifier: In-Game Stem Belønninger < / h2 > < p > Votifier er en protokol, der sender stemmemeddelelser direkte til din spilserver, så du kan belønne spillere in- spil, når de stemmer på HytaleCharts. Hytale Tegn understøtter tre Votifier varianter. < / p > < h3 > Votifier v1 (RSA krypteret) < / h3 > < p > Den oprindelige Votifier protokol bruger RSA kryptering. Når en stemme er afgivet, HytaleCharts krypterer en stemme besked med din servers offentlige nøgle og sender den via TCP. < / p > < p > Opsætning af votifier v1: < / p > < ol > < li > Installer et Votifier- kompatibelt plugin på din Hytaleserver < / li > < li > Generér et RSA nøglepar (plugin gør normalt dette automatisk ved første kørsel) < / li > < li > Kopier din < stærk > offentlig nøgle < / stærk > fra pluginets konfiguration < / li > < li > På HytaleCity in Ontario Canada Tegn, gå til din servers redigeringsside og sæt votifier typen til "v1" < / li > < li > Indtast din servers < stærk > vært < / stærk > (IP-adresse eller domæne), < stærk > port < / stærk > (Votifier lytteporten, ikke spilporten), og indsæt < stærk > offentlig nøgle < / stærk > < / li > < li > Gem og brug "Test Connection" knappen til at kontrollere det virker < / li > < / ol > < p > Stemmemeddelelsen følger standard votifier format: < kode > VOTE\ nHytaleCharts\ n {brugernavn}\ n {ip _ address}\ n {tidsstempel}\ n < / kode >, krypteret med PKCS # 1 v1.5 polstring. < / p > < h3 > Votifier v2 (HMAC- SHA256) < / h3 > < p > Votifier v2 er den mere moderne protokol. I stedet for RSA kryptering, det bruger HMAC-SHA256 signering med en delt token. Håndtryk omfatter en udfordring streng fra serveren for at forhindre replay angreb. < / p > < p > Opsætning af votifier v2: < / p > < ol > < li > Installer en v2- kompatibel Name < li > Find < stærk > token < / stærk > (delt hemmelighed) i pluginets indstillingsfil < / li > < li > På HytaleCity in Ontario Canada Tegn, sæt votifier typen til "v2" < / li > < li > Indtast din servers < stærk > vært < / stærk >, < stærk > port < / stærk >, og < stærk > token < / stærk > < / li > < li > Gem og test forbindelsen < / li > < / ol > < p > v2 protokollen forbinder via TCP, læser et håndtryk hilsen med en udfordring token, derefter sender en binær pakke indeholdende en JSON nyttelast underskrevet med HMAC-SHA256. Lasten indeholder servicenavnet ("HytaleCharts"), brugernavn, IP-adresse, tidsstempel i millisekunder og udfordringsstrengen. < / p > < h3 > HTTP- votifier < / h3 > < p > For Hytale- specifikke plugins, der bruger HTTP i stedet for rå TCP, understøtter HytaleCharts en HTTP endpoint mode. Dette er den enkleste protokol til at gennemføre for plugin udviklere. < / p > < p > Opsætning af HTTP- votifier: < / p > < ol > < li > Installer et plugin, der udsætter et HTTP endpoint for at modtage stemmer < / li > < li > På HytaleCity in Ontario Canada Tegn, sæt votifier typen til "HTTP" < / li > < li > Indtast den fulde < stærk > endpoint URL < / stærk > (fx < kode > https: / / your- server.com: 8080 / vote < / code >) < / li > < li > Hvis plugin kræver en token, skal du indtaste det i token felt. HytaleCharts vil underskrive anmodningen med en HMAC- SHA256 signatur i < koden > X- Votifier- Signature < / code > header. < / li > < li > Gem og test < / li > < / ol > < p > HTTP-anmodningen sender et JSON-organ med < kode > serviceName < / kode >, < kode > brugernavn < / kode >, < kode > adresse < / kode > og < kode > tidsstempel < / kode > felter. < / p > < h3 > Vigtige noter for alle votifier typer < / h3 > < ul > < li > < stærk > Brugernavne trunkeres til 16 tegn < / stærk > for at matche Hytales brugernavnsgrænse. HytaleCharts bruger spillerens Hytale brugernavn hvis det er angivet, ellers deres Diskord brugernavn. < / li > < li > < stærk > Tilslutningstiden er 5 sekunder. < / stærk > Hvis din server ikke reagerer inden for 5 sekunder, anses forsøget for mislykkedes. < / li > < li > < stærk > Mislykkede forsøg igen op til 3 gange < / stærk > med eksponentiel backoff (10 'ere, 30' ere, 60 'ere mellem forsøg). < / li > < li > Du kan bruge < stærk > Test Connection < / stærk > knappen på HytaleCharts til at verificere din opsætning uden brug af en rigtig stemme. Dette kontrollerer at serveren er tilgængelig og reagerer med det forventede votifier håndtryk. < / li > < / ul > < h2 > Generisk Webkroge < / h2 > < p > Hvis du ønsker at sende stemme meddelelser til din egen backend service, bot, eller program, generiske webkroge lader dig definere en brugerdefineret URL og nyttelast skabelon. < / p > < h3 > Hvordan Generiske Webkroge arbejde < / h3 > < ol > < li > På din servers redigeringsside kan du navigere til webhook konfigurationssektionen < / li > < li > Indtast < stærk > URL < / stærk > for dit endepunkt < / li > < li > Indstil < stærk > nyttelast skabelon < / stærk > med de data, du ønsker at modtage < / li > < li > Gem dine indstillinger < / li > < / ol > < p > Når en afstemning begivenhed opstår, sender HytaleCharts en HTTP POST anmodning til din URL med den konfigurerede nyttelast. Systemet understøtter skabelonvariabler, der erstattes med faktiske værdier på sendetidspunktet (vælgerbrugernavn, servernavn, tidsstempel osv.). < / p > < p > Generiske webkroge bruger samme gentry logik som Discord webkroge: 3 forsøg med progressiv backoff (10 s, derefter 30 'ere mellem reles). Hvis alle forsøg mislykkes, er fejlen sporet mod din server, og vedvarende fejl vil blive markeret i dit instrumentbræt. < / p > < img src = "https: / / cdn.hytalie.com / 5e7ba02d50cbcd001176c5ff _ 30 _ _ outlander _ settlement.jpg" alt = "An Outlander settlement in Hytale, der viser den slags fællesskabsservere, der drager fordel af webhook-integration" loading = "doven" stil = "bredde: 100%; højde: auto; grænseradius: 8px; margin: 1.5rem 0; / > < h2 > Heartbeat Plugin: Online statussporing < / h2 > < p > Den HytaleCharts hjerteslag plugin kører på din spilserver og sender periodiske statusopdateringer, så din liste altid viser præcis online / offline status og spiller tæller. < / p > < h3 > Hvordan virker det < / h3 > < p > Pluginet sender et hjerteslag til < kode > https: / / hytalecharts.com / api / hjerteslag < / kode > hvert 5. minut (eller hvert 20. sekund for premium-servere). Hvert hjerteslag omfatter: < / p > < ul > < li > Din server er < stærk > hjerterytme hemmelighed < / stærk > (en 64-tegn hex token) < / li > < li > Nuværende < stærk > spiller tæller < / stærk > og < stærk > max spillere < / stærk > < / li > < li > A < stærk > spiller array < / stærk > med individuelle spillerdetaljer (brugernavn, UUID, verden, ping) < / li > < li > Servermetadata som < stærk > servernavn < / stærk >, < stærk > MOTD < / stærk >, < stærk > optid < / stærk >, og < stærk > hukommelsesbrug < / stærk > < / li > < li > En liste over < stærke > installerede plugins < / stærke > og < stærke > verdens navne < / stærke > < / li > < / ul > < h3 > Opsætning trin < / h3 > < ol > < li > < stærk > Generér et hjerteslag hemmelighed. < / stærk > På din servers redigeringsside, gå til Heartbeat sektionen og klik på "Generate Secret". Dette skaber en unik 64-tegn token. < / li > < li > < stærk > Installer plugin. < / stærk > Placer HytaleCharts plugin i din servers < kode > mods / < / kode > mappe. < / li > < li > < stærk > Indstil plugin. < / stærk > Redigér pluginets < kode > config.json < / kode > fil og sæt hemmeligheden: < pre > < kode > [ "Secret": "DIT _ 64 _ CHAR _ HEARTBEAT _ SECRET" "debug": false } < / kode > < / pre > < / li > < li > < stærk > Genstart din server. < / stærk > plugin vil begynde at sende hjerteslag med det samme. < / li > < li > < stærk > Verificér på HytaleCharts. < / stærk > Tjek din servers redigeringsside; den skal vise det sidste hjerteslag tidsstempel og angive at forbindelsen er aktiv. < / li > < / ol > < h3 > Multi- Server aggregering < / h3 > < p > Hvis du kører flere server tilfælde (lobby, overlevelse, kreativ) deler den samme hjerteslag hemmelighed, HytaleCharts automatisk aggregerer dem. Det identificerer forskellige instanser ved deres IP-adresse og server navn, tager den nyeste hjerteslag fra hver, og fusionerer spillere ved UUID for at undgå dobbelttælling. Det samlede antal spillere og max spillere vist på din liste afspejler de kombinerede værdier på tværs af alle tilfælde. < / p > < h3 > Online status prioritet < / h3 > < p > Hytale Tegn bestemmer din servers online status ved hjælp af et prioriteret system: < / p > < ol > < li > < stærk > Ekstern forespørgsel endepunkt < / stærk > (hvis konfigureret, fx, Nitrado forespørgsel API) < / li > < li > < stærk > Heartbeat plugin < / stærk > (server viser som online hvis et hjerteslag blev modtaget inden for de sidste 5 minutter) < / li > < li > < stærk > UDP ping < / stærk > (fallback server forespørgsel) < / li > < / ol > < p > Hvis hjertestop plugin går tavs i mere end 5 minutter og ingen ekstern forespørgsel er konfigureret, serveren falder tilbage til UDP ping status. < / p > < h2 > Public Server API Tokens < / h2 > < p > HytaleCharts giver en offentlig API, der lader dig spørge vælgerdata, server statistik, og andre oplysninger programmatisk. For at bruge det, skal du bruge en API token. < / p > < h3 > Få din API Token < / h3 > < ol > < li > Gå til din servers redigeringsside på HytaleCharts < / li > < li > Naviger til API sektionen < / li > < li > Generér en API token < / li > < li > Kopiér og gem det sikkert. Den token autentificerer alle anmodninger til den offentlige server API endepunkter. < / li > < / ol > < h3 > Brug API < / h3 > < p > Inkludér token i < koden > Tilladelse < / kode > header af din API anmodninger: < / p > < pre > < kode > GET / api / public / server / {server _ id} / vælgere Autorisation: Bearer DINE _ API _ TOKEN < / code > < / pre > < p > Den offentlige API kan du hente seneste vælgere, server statistik, og andre data, som du kan bruge til at opbygge brugerdefinerede integreringer, leaderboards, eller belønningssystemer på din server. < / p > < p > For komplet API dokumentation og endpoint detaljer, kontrollere < a Horif = "/ server- api" > Server API side < / a > på HytaleCharts. < / p > < h2 > Fejlfinding < / h2 > < tabel > < tead > < st > < th > Udstedelse < / th > < th > Mulig årsag < / th > < th > Opløsning < / th > < / st > < / thead > < tbody > < st > < td > Diskord webhook ikke sende < / td > < td > Ugyldig webhook URL < / td > Slet og gendan webhook i Discord, og opdater derefter URL 'en på HytaleCharts < / td > < / tr > < tr > < td > Votifier test mislykkes med "No response" < / td > < td > Firewall blokerer votifier port < / td > < td > Sikre votifier port (ikke spillet port) er åben i din firewall < / td > < / tr > < tr > < td > Votifier test siger "Ugyldig V2 håndtryk" < / td > < td > Server understøtter kun v1, men du valgte v2 < / td > < td > Skift votifier type til v1 og give RSA offentlige nøgle i stedet for en token < / td > < / tr > < tr > < td > Hjerteslag ikke registrerer < / td > < td > Forkert hemmelighed i plugin config < / td > < td > Double- check at hemmeligheden i config. json matcher den, der vises på HytaleCharts nøjagtigt < / td > < / tr > < st > < td > Spillertal viser 0 < / td > < td > Plugin- version ældre end 1.5.0 < / td > < td > Opdatér Hytalen Indstiller plugin til den nyeste version, som sender individuelle spillerdata < / td > < / tr > < tr > < td > Webhook markeret som svigtende < / td > < td > 100 + fortløbende svigt < / td > < td > Retter endpoint URL 'en og tester den derefter. Succesfuld levering nulstiller fejltælleren. < / td > < / tr > < / tbody > < / tabel > < p > Hvis du løber ind i problemer, der ikke er dækket her, nå ud via < a HURF = "/ about" > kontakt formular < / a > på HytaleCharts. Vi kan tjekke din servers webhook logs og hjerterytme historie for at hjælpe med at diagnosticere problemer. < / p > < p > Opsætning af disse integreringer tager et par minutter, men væsentligt forbedrer, hvordan din server interagerer med HytaleCharts og dit samfund. Servere med aktive stemme meddelelser og ingame belønninger konsekvent se højere engagement og returnere besøg fra vælgere. < a HURF = "/ server" > Gennemse andre serverlister < / a > for at se hvordan de øverste servere beskriver deres integrationsfunktioner, og sørg for at din egen liste nævner hvad du har sat op. < / p >