Hogyan kell beállítani a webhorog és értesítések a Hytale Server

< p > HytaleCharts számos integrációs lehetőséget biztosít, amelyek lehetővé teszik a kapcsolat Hytale szerver listázza Discord, a játék szerver, és a külső eszközök. Amikor a játékos a szerverre szavaz, akkor kap egy Discord értesítést, indítsa el az in-game jutalmat Votifier-en keresztül, tűz egy egyéni webhorog a saját backend, és tartsa a szerver státusz up-to-date a szívverés plugin. < / p > < p > Ez az útmutató tartalmazza, hogyan lehet minden egyes integrációt a semmiből. Mindezek a funkciók elérhetők a szerver szerkesztési oldalán HytaleCharts bejelentkezés után, mint a szerver tulajdonosa vagy csapattag. < / p > < h2 > Diszkord Szavazz Webhorog < / h2 > < p > Discord webhorog lehetővé teszi, hogy egy Discord csatornában minden alkalommal értesítést kapjon, amikor valaki szavaz, kedvencei, vagy egy értékelést hagy a szerverén. < / p > < h3 > Beállítás Discord Webhows < / h3 > < ol > < li > < erős > Hozzon létre egy webhorog a Discord szerveren. < / erős > Menj a Server Beállítások, majd Integrations, majd Webhows. Kattintson az "Új webhorog" gombra, adja meg a nevét (pl. "HytaleCharts Votes"), válassza ki a csatornát, és másolja a webhook URL. < / li > < li > < erős > Adja hozzá a webhorog URL HytaleCharts. < / erős > Menj a szerver szerkesztési oldalára, keresd meg a Discord Webhook részt, és illeszd be az URL-t. < / li > < li > < erős > Mentse a beállításokat. < / erős > Hiúz A Charts most küld egy formázott beágyazott a Discord csatorna, amikor szavazás, kedvenc, vagy felülvizsgálat esemény történik. < / li > < / ol > < h3 > What Gets Sent < / h3 > < p > Minden webhorog értesítést egy Discord beágyazott tartalmaz: < / p > < ul > < li > Az esemény típusa (szavazás, kedvenc, felülvizsgálat) < / li > < li > A műveletet végző játékos felhasználóneve < / li > < li > Időbélyeg < / li > < li > A kiszolgáló neve és egy link vissza a HytaleCharts felsorolás < / li > < / ul > < p > Webhorog szállítás használ egy retry rendszer 3 kísérlet és egy 5 másodperces mentés közötti relék. Ha minden kísérlet sikertelen, a hiba naplózva van, és a HytaleCharts szerverenként egymást követő hibákat követ. Ha egy webhorog URL következetesen nem sikerül (HTTP hibákkal vagy időpontokkal tér vissza), akkor végül megjelölik, így frissítheti vagy javíthatja. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba23b50cbcd001176c66b _ 66 _ _ _ farm. jpg" alt = "A Hytale farm mutatja a fajta szerver épít, hogy előnyös a közösségi eljegyzési eszközök" betöltés = "lusta" stílus = "szélesség: 100%; magasság: auto; határvonal: 8px; margin: 1.5rem 0;" / > < h2 > Votifier: in-Game Szavazók < / h2 > < p > Votifier egy protokoll, amely a szavazatok értesítését közvetlenül a játék szerverére küldi, így a HytaleCharts-on való szavazáskor a játékosokat is megjutalmazhatja. Hiúz A Charts három Votifier változatot támogat. < / p > < h3 > Votifier v1 (RSA kódolva) < / h3 > < p > Az eredeti Votifier protokoll RSA titkosítást használ. Szavazáskor a HytaleCharts titkosítja a szavazási üzenetet a szerver nyilvános kulcsával és elküldi TCP-n keresztül. < / p > < p > Votifier v1 beállításához: < / p > < ol > < li > Telepíts egy Votifier- kompatibilis plugint a Hibaszerver < / li > < li > RSA kulcspár létrehozása (a plugin ezt általában automatikusan teszi első futáskor) < / li > < li > Másold le a < erős > nyilvános kulcsot < / erős > a plugin konfigurációjából < / li > < li > A hibrid Charts, menj a szerver szerkesztési oldalára és állítsd be a Votifier típust "v1" < / li > < li > Adja meg a szerver < erős > host < / erős > (IP cím vagy domain), < erős > port < / erős > (Votifier lehallgató port, nem a játék port), és illessze be a < erős > nyilvános kulcsot < / erős > < / li > < li > Mentse meg és használja a "Test Connection" gombot annak ellenőrzésére, hogy működik < / li > < / ol > < p > A szavazási üzenet a standard Votifier formátumot követi: < kód > VOTE\ nHytaleCharts\ n {username}\ n {ip _ address}\ n {timestop}\ n < / code >, kódolva PKCS # 1 v1.5 pavel. < / p > < h3 > Votifier v2 (HMAC- SHA256) < / h3 > < p > Votifier v2 a modernebb protokoll. RSA titkosítás helyett HMAC- SHA256 aláírást használ egy közös jelszóval. A kézfogás tartalmaz egy kihívás string a szerver, hogy megakadályozzák a visszajátszás támadások. < / p > < p > A Votifier v2 beállításához: < / p > < ol > < li > V2kompatibilis telepítése Votifier plugin < / li > < li > Keresse meg a < erős > token < / strong > (megosztott titok) a plugin konfigurációs fájljában < / li > < li > A hibrid Charts, állítsa be a Votifier típust "v2" < / li > < li > Adja meg a kiszolgáló < erős > gazdatest < / erős >, < erős > port < / erős > és < erős > token < / erős > < / li > < li > A kapcsolat mentése és tesztelése < / li > < / ol > < p > A v2 protokoll TCP-n keresztül csatlakozik, egy kézfogást olvas, egy kihívás jelszóval, majd küld egy bináris csomagot, amely egy JSON hasznos terhet tartalmaz, amit HMAC- SHA256-al írt alá. A hasznos teher tartalmazza a szolgáltatás nevét ("HytaleCharts"), a felhasználónevet, az IP-címet, az időbélyeget milliszekundumokban, és a kihívó sztringet. < / p > < h3 > HTTP Votifier < / h3 > < p > A HTTP-t a nyers TCP helyett használó hisztalespecifikus pluginoknál a HytaleCharts HTTP végpontot támogat. Ez a legegyszerűbb protokoll a plugin fejlesztők számára. < / p > < p > HTTP Votifier beállításához: < / p > < ol > < li > Olyan bővítmény telepítése, amely HTTP végpontot mutat be a < / li > szavazatok fogadására < li > A hibrid Charts, állítsa be a Votifier type to "HTTP" < / li > < li > Adja meg a teljes < erős > végpontot URL < / erős > (pl., < kód > https: / / your- server.com: 8080 / szavazás < / kód >) < / li > < li > Ha a pluginnak szüksége van egy zsetonra, írja be a zsetonmezőbe. A HytaleCharts HMAC- SHA256 aláírással írja alá a kérelmet < kód > X- Votifier- Signature < / kód > fejléc. < / li > < li > Mentés és vizsgálat < / li > < / ol > < p > A HTTP kérése a < kód > szerviz név < / kód >, < kód > felhasználónév < / kód >, < kód > cím < / kód > és < kód > időbélyegző < / kód > mezők < / p > < h3 > Fontos megjegyzések < / h3 > < ul > < li > < erős > A felhasználóneveket 16 karakterre csonkítják, < / erős > a Hytale felhasználónév-határértékének megfelelő értékre. A HytaleCharts a játékos Hytale felhasználónevét használja, ha be van állítva, máskülönben Discord felhasználónevét használja. < / li > < li > < erős > Csatlakozási idő 5 másodperc. Ha a szerver 5 másodpercen belül nem reagál, a kísérlet sikertelennek tekinthető. < / li > < li > < erős > sikertelen kísérletek újra legfeljebb 3-szor < / erős > exponenciális háttérrel (10, 30, 60-as évek a kísérletek között). < / li > < li > Használhatja a < strong > Test Connection < / strong > gombot a HytaleCharts-on, hogy ellenőrizze a beállítást anélkül, hogy egy igazi szavazat. Ez ellenőrzi, hogy a szerver elérhető-e, és reagál-e a várt Votifier kézfogásra. < / li > < / ul > < h2 > Általános horog < / h2 > < p > Ha szavazást szeretne küldeni saját háttérszolgáltatására, robotjára vagy alkalmazására, a generikus webhorog lehetővé teszi, hogy egyedi URL és hasznos teher sablont határozzon meg. < / p > < h3 > Hogyan működik az általános webhorog < / h3 > < ol > < li > A szerver szerkesztési oldalán navigálj a webhorog konfigurációs részhez < / li > < li > Adja meg a < erős > URL < / erős > végpontot < / li > < li > A < erős > hasznos teher sablon (< / erős >) beállítása a < / li > < li > Mentse a beállításokat < / li > < / ol > < p > Szavazási esemény esetén a HytaleCharts HTTP POST kérést küld az URL-re a beállított hasznos teher segítségével. A rendszer támogatja a sablon változókat, amelyeket a küldés időpontjában a tényleges értékekkel helyettesítenek (választó felhasználónév, szerver neve, időbélyegző stb.). < / p > < p > Generikus horog ugyanazt a retry logikát használja, mint a Discord webhook: 3 kísérlet progresszív háttérrel (10, majd 30 a retry között). Ha az összes visszaállítás sikertelen, a hiba a szerverhez kerül, és a tartós hibák a műszerfalon lesznek megjelölve. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba02d50cbcd001176c5ff _ 30 _ _ _ outlander _ settlement.jpg" alt = "An Outlander settlement.jpg" alt = "An Outlander settlement in Hytale show the kind of community servers that benefits of webhook integrations" locker = "lusta" style = "wide: 100%; height: auto; borer: 8px; marge: 1.5rem 0;" / > < h2 > Heartbeat bővítőmodul: Online állapotkövetés < / h2 > < p > A HytaleCharts szívbillentyű plugin fut a játék szerver és küld időszakos állapotfrissítéseket, így a lista mindig mutatja a pontos online / offline állapot és a játékos száma. < / p > < h3 > Hogyan működik < / h3 > < p > A plugin egy szívverést küld < kód > https: / / hytalecharts.com / api / heart < / code > 5 percenként (vagy prémium szerverek esetén 20 másodpercenként). Minden szívverés tartalmazza: < / p > < ul > < li > A szerver < erős > szívverés titka < / erős > (64 karakteres hex token) < / li > < li > Jelenlegi < erős > játékos szám < / erős > és < erős > max játékos < / erős > < / li > < li > A < erős > játékos tömb < / erős > egyéni játékos részletekkel (felhasználónév, UUID, világ, ping) < / li > < li > Szerver metaadatok, mint pl. < erős > szerver neve < / erős >, < erős > MOTD < / erős >, < erős > uptime < / erős > és < erős > memóriahasználat < / erős > < / li > < li > A list of < strong > installált plugins < / strong > and < strong > world name < / strong > < / li > < / ul > < h3 > Beállítási lépések < / h3 > < ol > < li > < erős > generáljon szívdobogástitkot. < / erős > A szerver szerkesztési oldalán, menj a Heartbeat részhez, és kattints a "Titok generálása" gombra. Ez létrehoz egy egyedi 64 karakteres szimbólumot. < / li > < li > < erős > Telepítse a plugint. < / erős > Helyezze a HytaleCharts plugint a szerver < kódja > mods / < / kód > könyvtár. < / li > < li > < erős > A plugin beállítása. A bővítmény szerkesztése > config.json < / kód > fájl és a titok beállítása: < pre> < kód > { "secret": "Your _ 64 _ CHAR _ Heartbeat _ SECRET", "debug": hamis } < / kód > < / pre> < / li > < li > < erős > Szerver újraindítása. < / erős > A plugin azonnal elkezd szívverést küldeni. < / li > < li > < erős > HitaleChartok ellenőrzése. < / erős > Ellenőrizze a szerver szerkesztési oldalát; meg kell mutatnia az utolsó szívverés időbélyegzőjét, és jeleznie kell, hogy a kapcsolat aktív. < / li > < / ol > < h3 > Multi- Server Aggregation < / h3 > < p > Ha több szerver esetét futtatja (lobby, túlélés, kreatív), és ugyanazt a szívdobbanási titkot használja, a HytaleCharts automatikusan aggregálja azokat. Különböző eseteket azonosít az IP-címük és a szerver neve alapján, mindegyik által a legfrissebb szívdobbanást veszi igénybe, és egyesíti a UUID játékosait, hogy elkerülje a kettős számolást. A listában szereplő összes játékos száma és max. játékosai minden esetben tükrözik az összesített értékeket. < / p > < h3 > Online státusz prioritás < / h3 > < p > Hytale Charts meghatározza a szerver online állapotát prioritási rendszer segítségével: < / p > < ol > < li > < erős > Külső lekérdezési végpont < / erős > < li > < erős > Heartbeat plugin < / erős > (a szerver online, ha a szívverést az elmúlt 5 percben kapták) < / li > < li > < erős > UDP ping < / erős > (defback server query) < / li > < / ol > < p > Ha a szívverés plugin megy néma több mint 5 perc és nincs külső lekérdezés konfigurálva, a szerver esik vissza UDP ping status. < / p > < h2 > Public Server API Tokens < / h2 > < p > A HytaleCharts nyilvános API-t biztosít, amely lehetővé teszi, hogy lekérdezd a szavazók adatait, a szerver statisztikáit és más információkat programosan. A használatához API jelképre van szükség. < / p > < h3 > Kapás API Token < / h3 > < ol > < li > Ugrás a kiszolgáló szerkesztési oldalára a HytaleCharts < / li > < li > Az API rész naiv < li > API token létrehozása < / li > < li > Másolja le és tárolja biztonságosan. A token hitelesíti az összes kérést a nyilvános kiszolgáló API végpontjaira. < / li > < / ol > < h3 > Az API < / h3 > használata < p > Tartalmazza a jelszót a < kódban > Engedélyezés < / kód > API kéréseinek fejléce: < / p > < pre > < kód > GET / api / public / servers / {server _ id} / szavazók Engedélyezés: Bearer Your _ API _ TOKEN < / Code > < / pre> < p > A nyilvános API lehetővé teszi, hogy a legutóbbi szavazókat, a szerver statisztikákat és más adatokat, amelyek segítségével egyedi integrációk, ólomtáblák vagy jutalomrendszerek épülhetnek a szerveren. < / p > < p > Az API teljes dokumentációjának és végpontjainak részleteit lásd: < a href = "/ server- api" > Szerver API oldal < / a > a HytaleCharts oldalon. < / p > < h2 > Hibaelhárítás < / h2 > < táblázat > < fej > < tr > < th > Lehetséges ok < / th > < th > Oldat < / th > < / tr > < / fej > < tbody > < tr > < td > Discord webhook nem küld < / td > < td > Érvénytelen webhook URL < / td > < td > Törölje és újítsa meg a webhorog in Discord-ot, majd frissítse az URL-t a HytaleCharts-on < / td > < / tr > < tr > < td > Votifier teszt sikertelen "No response" < / td > < td > Tűzfal blokkolja a Votifier portot < / td > < td > Győződjön meg róla, hogy a Votifier port (nem a játékport) nyitva van a tűzfalban < / td > < / tr > < tr > < td > Votifier teszt azt mondja, hogy "Érvénytelen V2 kézfogás" < / td > < td > Server csak a v1-et támogatja, de a v2 < / td > < td > Votifier típust v1-re cserélted, és az RSA nyilvános kulcsot adtad meg a < / td > < / tr > token helyett < tr > < td > Heartbeat nem regisztrál < / td > < td > Tad secret in plugin config < / td > < td > Double- check that the secret in config. json megegyezik a HytaleCharts-on látható képpel, pontosan < / td > < / tr > < tr > < td > A játékosszám 0 < / td > < td > A bővítmény > 1, 5 < / td > < td > A Hytale frissítése Charts plugin a legújabb verzió, amely küld egyéni játékos adatok < / td > < / tr > < tr > < td > Webhorog jelölése: sikertelen < / td > < td > 100 + egymást követő sikertelen < / td > < td > Javítsa meg az URL végpontot, majd vizsgálja meg. A sikeres szállítás visszaállítja a hibaszámlálót. < / td > < / tr > < / test > < / táblázat > < p > Ha itt nem érintett kérdésekbe futsz bele, a < a href = "/ about" > kapcsolatfelvételi űrlap < / a > a HytaleCharts-on. Ellenőrizhetjük a szerver webhorog naplóit és szívritmusát, hogy segítsen a problémák diagnosztizálásában. < / p > < p > Az integrációk beállítása néhány percet vesz igénybe, de jelentősen javítja a szerver és a HytaleCharts közötti kölcsönhatást. Az aktív szavazással kapcsolatos értesítésekkel és a játékbeli jutalmakkal rendelkező szerverek következetesen nagyobb szerepvállalást és visszatérési látogatásokat látnak a választóktól. < a href = "/ szerverek" > Böngészés más szerverlisták < / a >, hogy a felső szerverek leírják integrációs funkciók, és győződjön meg róla, hogy a saját lista említi, amit létrehozott. < / p >