Hur man ställer in Webhooks och meddelanden för din Hytale Server

HytaleCharts erbjuder flera integrationsalternativ som låter dig ansluta din Hytale server notering till Discord, din spelserver och externa verktyg. När en spelare röstar för din server kan du få en Discord-meddelande, utlösa belöningar i spelet via Votifier, skjuta en anpassad webhook till din egen backend och hålla din serverstatus uppdaterad med hjärtslagsplugin. Denna guide täcker hur man ställer in varje integration från början. Alla dessa funktioner är tillgängliga från din servers redigeringssida på HytaleCharts efter inloggning som serverägare eller en gruppmedlem. Discord Vote Webhooks Discord webhooks låter dig få ett meddelande i en Discord-kanal varje gång någon röstar för, favoriter eller lämnar en recension på din serverlista. Setting Up Discord Webhooks Skapa en webhook i din Discord-server. Gå till Server Inställningar, sedan Integrationer, sedan Webhooks. Klicka på "New Webhook", ge det ett namn (t.ex. "HytaleCharts Votes"), välj kanalen och kopiera webhook URL. Lägg till webhook URL på HytaleCharts. Gå till din servers redigeringssida, hitta Discord Webhook-sektionen och klistra in URL. Spara dina inställningar. Hytale Diagram skickar nu en formaterad inbäddad i din Discord-kanal när en röst, favorit eller granskning inträffar. Vad blir Sent Varje webhook-meddelande skickas som en Discord inbäddad som innehåller: Typ av händelse (röst, favorit, granskning) Användarnamnet för den spelare som utförde åtgärden A timestamp Ditt servernamn och en länk tillbaka till din HytaleCharts listning Webhook-leverans använder ett retrysystem med 3 försök och en 5-sekunders backoff mellan retries. Om alla försök misslyckas är misslyckandet inloggat, och HytaleCharts spårar på varandra följande fel per server. Om en webhook URL konsekvent misslyckas (returer HTTP-fel eller tider ut), kommer det så småningom att flaggas så att du kan uppdatera eller åtgärda det. Votifier: In-Game Vote Rewards Votifier är ett protokoll som skickar röstmeddelanden direkt till din spelserver, så att du kan belöna spelare i spelet när de röstar på HytaleCharts. Hytale Diagram stöder tre Votifier varianter. Votifier v1 (RSA Krypterad) Det ursprungliga Votifier-protokollet använder RSA-kryptering. När en röst kastas krypterar HytaleCharts ett röstmeddelande med din servers offentliga nyckel och skickar den via TCP. Att ställa in Votifier v1: Installera en Votifier-kompatibel plugin på din Hytale server Generera ett RSA-nyckelpar (plugin brukar göra detta automatiskt på första körningen) Kopiera din public key från plugins konfiguration På Hytale Diagram, gå till din servers redigeringssida och ange Votifier-typen till "v1" Ange din servers host (IP-adress eller domän), port (the Votifier Lyssningsport, not the game port) och klistra in public key Spara och använd knappen "Test Connection" för att verifiera att den fungerar Röstmeddelandet följer standarden Votifier-format: VOTE\nHytaleCharts\n{usernameňn{ip_addressňn{timestampőn, krypterad med PKCS#1 v1.5 padding. Votifier v2 (HMAC-SHA256) Votifier v2 är det modernare protokollet. Istället för RSA-kryptering använder den HMAC-SHA256-signering med en delad token. Handskakningen innehåller en utmaning som sträcker sig från servern för att förhindra replayattacker. Att ställa in Votifier v2: Installera en v2-kompatibel Votifier plugin Hitta token (delad hemlighet) i plugins konfigurationsfil På Hytale Diagram, ställa in Votifier-typen till "v2" Ange din servers host, port och token Spara och testa anslutningen V2-protokollet ansluts via TCP, läser en handskakning hälsning med en utmaning token, skickar sedan ett binärt paket som innehåller en JSON nyttolast undertecknad med HMAC-SHA256. Betalningen inkluderar servicenamnet ("HytaleCharts"), användarnamn, IP-adress, tidsstämpel i millisekunder och utmaningen sträng. HTTP Votifier För Hytale-specifika plugins som använder HTTP istället för rå TCP, stöder HytaleCharts ett HTTP endpoint-läge. Detta är det enklaste protokollet att genomföra för plugin utvecklare. Att ställa in HTTP Votifier: Installera ett plugin som avslöjar en HTTP-slutpunkt för att få röster På Hytale Diagram, ställa in Votifier-typen till "HTTP" Enter the full endpoint URL (t.ex. https://your-server.com:8080/vote) Om plugin kräver en token, ange den i token fältet. HytaleCharts kommer att underteckna begäran med en HMAC-SHA256 signatur i X-Votifier-Signature header. Spara och testa HTTP-förfrågan skickar en JSON-kropp med serviceName, username, adress och timestamp fält. Important Notes for All Votifier Types Usernames är truncerade till 16 tecken för att matcha Hytales användargräns. HytaleCharts använder spelarens Hytale-användarnamn om det anges, annars deras Discord-användarnamn. Connection timeout är 5 sekunder. Om din server inte svarar inom 5 sekunder anses försöket vara misslyckat. Failed försök retry up to 3 times med exponentiell backoff (10s, 30s, 60s mellan försöken). Du kan använda knappen Test Connection på HytaleCharts för att verifiera din inställning utan att behöva en riktig röst. Detta kontrollerar att servern är tillgänglig och svarar med den förväntade Votifier handskakning. Generiska Webhooks Om du vill skicka röstmeddelanden till din egen backend-tjänst, bot eller applicering, låter generiska webhooks dig definiera en anpassad URL och payload mall. Hur Generiska Webhooks fungerar På serverns redigeringssida, navigera till webhook-konfigurationssektionen Ange URL av din endpoint Konfigurera payload mallen med de data du vill ta emot Spara dina inställningar När ett omröstningsevenemang inträffar skickar HytaleCharts en HTTP POST-förfrågan till din URL med den konfigurerade nyttolast. Systemet stöder mallvariabler som ersätts med faktiska värden vid sändningstid (voter användarnamn, servernamn, timestamp, etc.). Generiska webhooks använder samma retry logik som Discord webhooks: 3 försök med progressiv backoff (10s, sedan 30s mellan retries). Om alla retries misslyckas spåras misslyckandet mot din server, och ihållande fel kommer att flaggas i din instrumentpanel.