Hoe Webhooks en meldingen voor uw Hytale Server instellen

HytaleCharts biedt verschillende integratieopties waarmee u uw Hytale server lijst met Discord, uw gameserver en externe tools. Wanneer een speler voor uw server stemt, kunt u een Discord notificatie ontvangen, in-game beloningen activeren via Votifier, een aangepaste webhook afvuren op uw eigen backend en uw serverstatus up-to-date houden met de hartslagplugin. Deze gids beschrijft hoe elke integratie vanaf nul kan worden opgezet. Al deze functies zijn toegankelijk vanaf de bewerkingspagina van uw server op HytaleCharts nadat u bent ingelogd als servereigenaar of teamlid. Discord Stem Webhooks Discord webhooks laten je elke keer een melding in een Discord-kanaal ontvangen wanneer iemand stemt voor, favorieten of een recensie achterlaat op je serverlijst. Discord Webhooks instellen Maak een webhook aan in uw Discord-server. Ga naar Serverinstellingen, dan Integraties, dan Webhooks. Klik op "New Webhook," geef het een naam (bijv. "HytaleCharts Stemmen"), kies het kanaal, en kopieer de webhook URL. Voeg de webhook-URL toe op HytaleCharts. Ga naar de bewerkingspagina van uw server, zoek de Discord Webhook sectie en plak de URL. Uw instellingen opslaan. Hytale Grafieken sturen nu een geformatteerde inbed naar uw Discord-kanaal wanneer een stem, favoriet of recensie-evenement optreedt. Wat wordt verzonden Elke webhook notificatie wordt verzonden als Discord-embed met: Het type evenement (stemming, favoriet, beoordeling) De gebruikersnaam van de speler die de actie heeft uitgevoerd Een tijdstempel Uw servernaam en een link naar uw HytaleCharts-lijst Webhook delivery maakt gebruik van een opnieuw proberen systeem met 3 pogingen en een 5-seconde backoff tussen retries. Als alle pogingen mislukken, wordt de storing geregistreerd, en HytaleCharts volgt opeenvolgende storingen per server. Als een webhook-URL consequent faalt (returns HTTP fouten of times-out), zal het uiteindelijk worden gemarkeerd, zodat je het kunt bijwerken of repareren. http://cdn.hytale.com/5e7ba23b50cbcd001176c66b_66_farm.jpg" alt="A Hytale boerderij toont het soort server bouwt die profiteren van community engagement tools" loading="lazy" stijl="breedte: 100%; hoogte: auto; randradius: 8px; marge: 1.5rem 0;" /> Votifier: In-game Stem Rewards Votifier is een protocol dat stemmeldingen rechtstreeks naar uw spelserver stuurt, zodat u spelers in-game kunt belonen wanneer ze stemmen op HytaleCharts. Hytale Grafieken ondersteunt drie Votifier varianten. Votifier v1 (RSA-versleuteld) Het originele Votifier protocol gebruikt RSA-encryptie. Als er gestemd wordt, versleutelt HytaleCharts een stembericht met de publieke sleutel van uw server en stuurt het via TCP. Instellen Votifier v1: Installeer een Votifier-compatibele plugin op uw Hytale-server Genereer een RSA sleutelpaar (de plugin doet dit meestal automatisch bij de eerste run) Kopieer je public key van de configuratie van de plugin Op Hytale Grafieken, ga naar de bewerkingspagina van uw server en stel het type Votifier in op "v1" Voer de -host van uw server in (IP-adres of domein), -poort (de Votifier-luisterpoort, niet de spelpoort), en plak de -publieke sleutel Opslaan en gebruik de "Test Connection" knop om te controleren of het werkt Het stembericht volgt het standaard Votifier formaat: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n, versleuteld met PKCS#1 v1.5 padding. V2 (HMAC-SHA256) V2 is het modernere protocol. In plaats van RSA-encryptie, gebruikt het HMAC-SHA256 ondertekening met een gedeelde token. De handshake bevat een challenge string van de server om herhalingsaanvallen te voorkomen. Instellen Votifier v2: Een v2-compatibel installeren Votifierplugin Find the token (shared secret) in het configuratiebestand van de plugin Op Hytale Grafieken, stel het type Votifier in op "v2" Voer de host van uw server in, port en token Opslaan en testen van de verbinding Het v2 protocol verbindt via TCP, leest een handshake begroeting met een challenge token, stuurt dan een binair pakket met een JSON payload ondertekend met HMAC-SHA256. De lading bevat de servicenaam ("HytaleCharts"), gebruikersnaam, IP-adres, tijdstempel in milliseconden, en de challenge string. HTTP Votifier Voor Hytale-specifieke plugins die HTTP gebruiken in plaats van rauwe TCP, ondersteunt HytaleCharts een HTTP-eindpuntmodus. Dit is het eenvoudigste protocol voor plugin-ontwikkelaars. Instellen van HTTP Votifier: Installeer een plugin die een HTTP eindpunt blootlegt voor het ontvangen van stemmen Op Hytale Grafieken, stel het type Votifier in op "HTTP" Enter the full endpoint URL (bijv. https://your-server.com:8080/vote) Als de plugin een token vereist, voer het in het token veld. HytaleCharts zal het verzoek ondertekenen met een HMAC-SHA256 handtekening in de X-Votifier-Handtekening header. Opslaan en testen Het HTTP-verzoek stuurt een JSON-lichaam met serviceNaam, gebruikersnaam, adres en tijdstempel velden. Belangrijke opmerkingen voor alle Votifiertypes Gebruikersnamen worden afgekapt tot 16 tekens om de gebruikersnaamlimiet van Hytale te halen. HytaleCharts gebruikt de Hytale gebruikersnaam van de speler indien ingesteld, anders hun Discord gebruikersnaam. Verbindingstijd is 5 seconden. Als uw server niet binnen 5 seconden reageert, wordt de poging als mislukt beschouwd. Failed pogingen proberen tot 3 keer met exponentiële backoff (10s, 30s, 60s tussen pogingen). U kunt de Test Connection knop op HytaleCharts gebruiken om uw installatie te verifiëren zonder dat u echt hoeft te stemmen. Dit controleert of de server bereikbaar is en reageert met de verwachte Votifier-handshake. Generic Webhooks Als u stemmeldingen wilt verzenden naar uw eigen backend service, bot, of applicatie, dan kunt u een aangepaste URL en payload sjabloon definiëren. Hoe algemene webhooks werken Op de bewerkingspagina van uw server, navigeer naar de webhook configuratie sectie Voer de URL in van uw eindpunt Configureer het payload sjabloon met de gegevens die u wilt ontvangen Uw instellingen opslaan Wanneer er een stemgesprek plaatsvindt, stuurt HytaleCharts een HTTP POST-verzoek naar uw URL met de geconfigureerde lading. Het systeem ondersteunt sjabloonvariabelen die worden vervangen door werkelijke waarden op verzendtijd (stem gebruikersnaam, servernaam, tijdstempel, enz.). Generieke webhooks gebruiken dezelfde retry logica als Discord webhooks: 3 pogingen met progressieve backoff (10s, dan 30s tussen retrieves). Als alle herhalingen falen, wordt de fout gevolgd tegen uw server en worden aanhoudende fouten gemarkeerd in uw dashboard. Heartbeat-plugin: Online Status Tracking De HytaleCharts hartslag plugin draait op uw spelserver en stuurt periodieke status-updates zodat uw lijst altijd nauwkeurige online/offline status en speler telt. Hoe het werkt De plugin stuurt een hartslag naar https://hytalecharts.com/api/heartbeat elke 5 minuten (of elke 20 seconden voor premium servers). Elke hartslag omvat: Uw server's heartbeat secret (een 64-karakter hex token) Current player count en max spelers A players array met individuele spelersdetails (gebruikersnaam, UUID, wereld, ping) Servermetadata zoals servernaam, MOTD, uptime en geheugengebruik Een lijst van geïnstalleerde plugins en wereldnamen Setup Steps Genereer een hartslaggeheim. Op de pagina van uw server bewerken, ga naar de sectie Heartbeat en klik op "Generate Secret." Dit creëert een uniek 64-teken token. Installeer de plugin. Plaats de HytaleCharts-plugin in de mods/ van uw server map. De plugin instellen. Bewerk het bestand config.json en stel het geheim in: { "geheim": "YOUR_64_CHAR_HEARTBEAT_SECRET," "debug": onwaar } Server herstarten. De plugin zal onmiddellijk hartslagen sturen. Verifiëren op HytaleCharts. Controleer de bewerkingspagina van uw server; het moet de laatste hartslag tijdstempel tonen en aangeven dat de verbinding actief is. Multi-Server-aggregatie Als u meerdere server instanties (lobby, survival, creative) het delen van hetzelfde hartslag geheim, HytaleCharts automatisch aggregaten hen. Het identificeert verschillende gevallen door hun IP-adres en servernaam, neemt de nieuwste hartslag van elke, en mergets spelers door UUID om dubbeltelling te voorkomen. Het totale aantal spelers en de maximale spelers op uw lijst weerspiegelen de gecombineerde waarden voor alle instanties. Onlinestatusprioriteit Hytale Grafieken bepalen de online status van uw server via een prioriteitssysteem: Externe query eindpunt (indien geconfigureerd, bijv., Nitrado query API) Hartbeat-plugin (server toont als online als een hartslag binnen de laatste 5 minuten werd ontvangen) UDP ping (fallback server query) Als de hartslagplugin langer dan 5 minuten stil blijft en er geen externe query is geconfigureerd, valt de server terug naar UDP ping status. Public Server API Tokens HytaleCharts biedt een publieke API waarmee u stemmersgegevens, serverstatistieken en andere informatie programmamatisch kunt opvragen. Om het te gebruiken, heb je een API token nodig. Uw API Token ophalen Ga naar de bewerkingspagina van uw server op HytaleCharts Navigeer naar de API sectie Genereer een API token Kopiëren en veilig bewaren. Het token authenticeert alle verzoeken aan de publieke server API eindpunten. De API gebruiken Inclusief de token in de Authorisatie header van uw API-verzoeken: GET /api/public/servers/{server_id}/stemmers Authorization: Bearer YOUR_API_TOKEN Met de publieke API kunt u recente kiezers, serverstatistieken en andere gegevens ophalen die u kunt gebruiken om aangepaste integraties, leaderboards of beloningssystemen op uw server te bouwen. Voor volledige API documentatie en eindpunt details, controleer de Server API pagina op HytaleCharts. Probleemoplossing Issue Mogelijke oorzaakSolution Discord webhook stuurt geen Ongeldige webhook URLVerwijder en maak de webhook in Discord opnieuw aan, en update vervolgens de URL op HytaleCharts Votifiertest mislukt met "No response"Firewall blokkeert de VotifierpoortZorg ervoor dat de Votifierpoort (niet de spelpoort) geopend is in uw firewall Votifyer test zegt "Invalid V2 handshake"Server ondersteunt alleen v1 maar je hebt v2 Verander het Votifyer type naar v1 en geef de RSA publieke sleutel in plaats van een token Hartbeat registreert niet Fout geheim in plugin-configuratieTweevoudige controle dat het geheim in config. json komt overeen met die op HytaleCharts precies Het aantal spelers toont 0Pluginversie ouder dan 1.5.0Hytale bijwerken Grafieken-plugin naar de nieuwste versie, die individuele spelersgegevens verstuurt Webhook gemarkeerd als mislukt100+ opeenvolgende foutenVix de eindpunt-URL, test het vervolgens. Succesvolle bezorging resetten de fout teller. Als u problemen tegenkomt die hier niet worden behandeld, contacteer dan via het contactformulier op HytaleCharts. We kunnen de webhooklogs van uw server en de hartslaggeschiedenis controleren om problemen te diagnostiseren. Het instellen van deze integraties duurt een paar minuten, maar verbetert aanzienlijk de interactie van uw server met HytaleCharts en uw community. Servers met actieve stemmeldingen en in-game beloningen zien consequent hogere betrokkenheid en terugkeer bezoeken van kiezers. Blader door andere serverlijsten om te zien hoe topservers hun integratiefuncties beschrijven, en zorg ervoor dat uw eigen lijst vermeldt wat u hebt ingesteld.