Miten perustaa Webhooks ja ilmoitukset Hytale Server

HytaleCharts tarjoaa useita integrointivaihtoehtoja, joiden avulla voit yhdistää Hytale palvelimen listaus Discord, pelin palvelimen, ja ulkoiset työkalut. Kun pelaaja äänestää palvelimellesi, voit saada Discord-ilmoituksen, käynnistää pelin palkinnot valitsijan kautta, ampua mukautetun webkoukun omaan taustaosaan ja pitää palvelimen tilan ajan tasalla sydämenlyönnin kanssa. Tässä oppaassa kerrotaan, miten kukin integraatio toteutetaan tyhjästä. Kaikki nämä ominaisuudet ovat saatavilla palvelimen muokkaussivulta HytaleCharts kirjauduttuasi sisään palvelimen omistajana tai ryhmän jäsenenä. • • • • Discord webkoukkujen avulla voit saada ilmoituksen discord-kanavalla joka kerta, kun joku äänestää, suosikkeja, tai jättää arvostelun palvelimen listalle. Setting up discord Webkooks Luo webkoukku Discord-palvelimessa. Mene Palvelinasetuksiin, sitten integraatioihin, sitten Webhooks. Valitse "New Webhook," anna sille nimi (esim., "HytaleCharts Äänestysten"), valitse kanava, ja kopioi webkookin URL. Lisää verkkotunnus HytaleChartsiin. Siirry palvelimesi muokkaussivulle, etsi Discord Webhook -osio ja liitä URL. Tallenna asetukset. Hytale Kaaviot lähettävät nyt muokatun upotuksen Discord-kanavallesi aina, kun äänestys, suosikki tai tarkistustapahtuma tapahtuu. Mitä lähetetään Jokainen webkookin ilmoitus lähetetään discord-pohjana, joka sisältää: Tapahtuman tyyppi (äänestys, suosikki, tarkistus) Toiminnon suorittaneen pelaajan käyttäjätunnus A-aikaleima Palvelimen nimi ja linkki takaisin HytaleCharts listalle Webhook-toimituksessa käytetään uusintakoneita, joissa on 3 yritystä ja 5 sekunnin takaisku. Jos kaikki yritykset epäonnistuvat, vika kirjataan ja HytaleCharts seuraa peräkkäisiä epäonnistumisia palvelimelta. Jos webkookin URL epäonnistuu johdonmukaisesti (palautaa HTTP-virheet tai ajat pois), se lopulta merkitään, jotta voit päivittää tai korjata sen. Voittaja: Pelin sisäiset äänioikeudet Votifier on protokolla, joka lähettää äänestysilmoitukset suoraan pelipalvelimelle, jonka avulla voit palkita pelaajia pelissä, kun he äänestävät HytaleCharts. Hytale Kaaviot tukevat kolmea äänestäjän versiota. Voittaja v1 (RSA Salattu) Alkuperäinen Votifier-protokolla käyttää RSA-salausta. Kun äänestys toimitetaan, HytaleCharts salaa ääniviestin palvelimen julkisella avaimella ja lähettää sen TCP:n kautta. Voittaja v1: Asenna äänittäjä-yhteensopiva plugin Hytale- palvelin Luo RSA-avainpari (liitännäinen yleensä tekee tämän automaattisesti ensimmäisellä juoksulla) Copy your public key liitännäisen kokoonpanosta On Hytale Kaaviot, siirry palvelimen muokkaussivulle ja aseta valitsijan tyyppi "v1" Anna palvelimesi host (IP-osoite tai -verkkotunnus), port (äänittäjän kuunteluportti, ei peliportti) ja liitä public key Tallenna ja käytä "Testausyhteys"-painiketta sen toiminnan varmistamiseksi Äänestysviesti noudattaa standardiäänitysmuotoa: vote\nHytaleCharts\n{username}\n{ip_address}\n{aikaleima}\n , salattu PKCS#1 v1.5 pehmusteella. Voittaja v2 (HMAC-SHA256) Voitija v2 on modernimpi protokolla. RSA-salauksen sijaan se käyttää HMAC-SHA256-allekirjoitusta jaetulla rahakkeella. Kädenpuristus sisältää haastejonon palvelimelta estääksesi uusintahyökkäykset. Voittaja v2: Asenna v2-yhteensopiva Tulostusliitännäinen Etsi token (jaettu salaisuus) liitännäisen asetustiedostossa On Hytale Kaaviot, aseta äänestäjän tyyppi "v2" Anna palvelimen host , port ja token Tallenna ja testaa yhteys V2-protokolla yhdistää TCP:n kautta, lukee kädenpuristuksen haastemerkillä, lähettää binääripaketin, joka sisältää HMAC-SHA256:n kanssa allekirjoitetun JSON-kuorman. Kuorma-auto sisältää palvelun nimen ("HytaleCharts"), käyttäjätunnuksen, IP-osoitteen, aikaleiman millisekunneissa ja haastemerkkijonon. HTTP-äänittäjä Hytale-spesifisille plugineille, joissa käytetään HTTP:tä eikä raakaa TCP:tä, HytaleCharts tukee HTTP-päätetilaa. Tämä on yksinkertaisin protokolla liitännäisten kehittäjille. HTTP-äänittimen perustaminen: Asenna liitännäinen, joka paljastaa HTTP- päätepisteen äänille On Hytale Kaaviot, aseta valitsintyyppiksi "HTP" Enter the full endpoint URL (esim., https://your-server.com:8080/vote ) Jos plugin vaatii token, kirjoita se token kentän. HytaleCharts allekirjoittaa pyynnön HMAC-SHA256-allekirjoituksella X-Voitija-allekirjoitus otsikko Tallenna ja testaa HTTP-pyyntö lähettää JSON-elimen, jolla on serviceName , username , addresse ja aikaleima kentät Tärkeimmät huomautukset kaikille äänestäjätyypeille Käyttäjänimet on kutistettu 16 merkkiin vastaamaan Hytalen käyttäjätunnusrajaa. HytaleCharts käyttää soittimen Hytale-käyttäjätunnusta, jos se on asetettuna, muuten niiden discord-käyttäjätunnusta. Konnettomuusaika on 5 sekuntia. Jos palvelimesi ei vastaa 5 sekunnissa, yritys katsotaan epäonnistuneeksi. Failed yrittää uudelleen jopa 3 kertaa eksponentiaalinen backoff (10s, 30s, 60s välillä yritykset). Voit käyttää Test Connection painiketta HytaleCharts tarkistaaksesi asetukset ilman todellista äänestystä. Tämä tarkistaa, että palvelin on saavutettavissa ja vastaa odotetulla Votifier kädenpuristuksella. Generic Webkooks Jos haluat lähettää äänestysilmoituksia omaan backend-palveluun, bottiin tai sovellukseen, yleiset webkoukkusi antavat sinun määritellä mukautetun URL-osoitteen ja hyötykuormamallin. Miten tavalliset verkkokoukut toimivat Navigoi palvelimen muokkaussivulla webkookin konfiguraatio-osioon Anna URL päätetapahtumasta Määritä payload malled tiedoilla, jotka haluat saada Tallenna asetukset Kun äänestystapahtuma tapahtuu, HytaleCharts lähettää HTTP POST -pyynnön URL-osoitteeseen, jossa on määritetty hyötykuorma. Järjestelmä tukee mallimuuttujia, jotka korvataan todellisilla arvoilla lähetyshetkellä (äänenkäyttäjänimi, palvelimen nimi, aikaleima jne.). Generic webkooks käyttää samaa logiikkaa kuin Discord webkooks: 3 yritystä progressiivinen backoff (10s, sitten 30s välillä retries). Jos kaikki retries epäonnistuu, vika jäljitetään palvelimeen ja jatkuvat viat merkitään kojelautaan. Heartbeat-liitännäinen: Online Status Tracking HytaleChartsin sydämenlyönnin plugin toimii pelipalvelimellasi ja lähettää määräaikaisia tilapäivityksiä, joten listautumisesi osoittaa aina tarkan online-/offline-tilan ja pelaajan määrän. Miten se toimii Liitännäinen lähettää sydämenlyönnin osoitteeseen https://hytalecharts.com/api/heartbeat 5 minuutin välein (tai 20 sekunnin välein premium-palvelimille). Jokainen syke sisältää: palvelimen heartbeat screen (64-merkkinen hex token) Vähän pelaajamäärä ja suurimmat pelaajat A players array yksittäisten pelaajien tiedot (käyttäjänimi, UUID, maailma, ping) Server metadata, kuten server name , MOTD , uptime , ja muistin käyttö Luettelo asennettuja plugins ja world names Rakennusvaiheet Sydämen sykkeen salaisuus. Siirry palvelimen muokkaussivulle Heartbeat-osioon ja napsauta "Luo Salainen." Tämä luo ainutlaatuisen 64-merkkisen symbolin. Asenna liitännäinen. Aseta HytaleCharts-liitännäinen palvelimesi mods/ hakemisto. Liitännän asetukset. Muokkaa liitännäisen config.json -tiedostoa ja aseta salaisuus: { "salainen": "YOUR_64_CHAR_HEARTBEAT_SECRET," 'debug': väärä } Käynnistä palvelin uudelleen. Liitännäinen alkaa lähettää sydämenlyöntejä välittömästi. Varmennetaan HytaleCharts. Tarkista palvelimen muokkaussivu; sen pitäisi näyttää viimeinen sykeaikaleima ja osoittaa, että yhteys on aktiivinen. Multi-Server Aggregation Jos suoritat useita palvelintapauksia (lobby, selviytyminen, luova), jotka jakavat saman sydämenlyönnin salaisuuden, HytaleCharts yhdistää ne automaattisesti. Se tunnistaa erillisiä tapauksia niiden IP-osoite ja palvelimen nimi, vie uusimman sykkeen kustakin, ja yhdistää pelaajia UUID välttää kaksinkertainen laskenta. Pelaajien kokonaismäärä ja maksimipelaajat, jotka on esitetty listallasi, heijastavat yhdistettyjä arvoja kaikissa tapauksissa. Online-statusprioriteetti Hytale Kaaviot määrittävät palvelimen online-status käyttäen prioriteettijärjestelmää: Ulkoinen kyselyn päätepiste (jos valittu, esim. Nitrado-kysely API) Heartbeat-liitännäinen (palvelin näyttää verkossa, jos sydämen syke on saatu viimeisten 5 minuutin aikana) UDP ping (fallback-palvelimen kysely) Jos sykeliitännäinen vaikenee yli 5 minuuttia eikä ulkoista kyselyä ole määritetty, palvelin laskee takaisin UDP-ping-tilaan. Public Server API Tokens HytaleCharts tarjoaa julkisen sovellusliittymän, jonka avulla voit tiedustella äänestäjätietoja, palvelintietoja ja muita tietoja ohjelmallisesti. Jos haluat käyttää sitä, tarvitset API-poletin. API-indikaattorin saaminen Siirry palvelimesi muokkaussivulle HytaleCharts Navigate to the API section Generate an API token Kopioi ja säilytä se turvallisesti. Merkintä todentaa kaikki pyynnöt julkiselle palvelimelle API päätetapahtumat. API:n käyttö Sisällytä kuponki < koodi>Valtuutus API-pyyntöjesi otsikko: GET /api/public/servers/{server_id}/voittajat Valtuutus: Bearer YourR_API_TOKEN Julkisen sovellusliittymän avulla voit hakea tuoreita äänestäjiä, palvelintilastoja ja muita tietoja, joilla voit rakentaa mukautettuja integraatioita, tulostauluja tai palkita järjestelmiä palvelimellesi. Täydellinen API-dokumentaatio ja päätetapahtuman yksityiskohdat tarkistetaan Server API page on HytaleCharts. Vianmääritys Issue Mahdollinen syy Solution Discord-verkkokoukku ei lähetä Virheellinen verkkokoukku URL Poista ja luo webkoukku uudelleen Discordissa, päivitä sitten HytaleCharts URL Voittajan testi epäonnistuu "Ei vastetta" Firewall blocking the Votifier port Varmista, että äänimerkkiportti (ei peliporttia) on avoinna palomuurissa Voitijatestissä lukee "V2 kädenpuristus" Server tukee vain v1:tä, mutta valitsit v2 Muuta äänittäjän tyyppi v1:ksi ja anna RSA:n julkinen avain tunnisteen sijasta Heartbeat not registering Väärä salaisuus plugin config Kaksinkertainen tarkistaa, että salaisuus config. Json vastaa HytaleChartsissa täsmälleen Player count shows 0Plugin version ikä yli 1.5.0Päivitä Hytale Kaavioiden liitännäinen viimeisimmäen versioon, joka lähettää yksittäisiä pelaajien tietoja Webhook merkitty epäonnistuvaksi 100+ perättäiset viat