अपने हाइटेल सर्वर के लिए वेबहुक और अधिसूचना कैसे सेट करें

HytaleCharts कई एकीकरण विकल्प प्रदान करता है जो आपको अपने कनेक्ट करने की अनुमति देता है डिकॉर्ड, आपका गेम सर्वर और बाहरी टूल के लिए Hytale सर्वर सूची। जब आपके सर्वर के लिए कोई खिलाड़ी वोट देता है, तो आप एक डिसकॉर्ड अधिसूचना प्राप्त कर सकते हैं, वोटिफायर के माध्यम से इन-गेम रिवार्ड्स को ट्रिगर कर सकते हैं, एक कस्टम वेबहुक को अपने बैकएंड पर फायर कर सकते हैं, और अपने सर्वर की स्थिति को हार्टबीट प्लगइन के साथ अप-टू-डेट रख सकते हैं। इस गाइड में शामिल हैं कि प्रत्येक एकीकरण को खरोंच से कैसे स्थापित किया जाए। इनमें से सभी विशेषताएं सर्वर मालिक या टीम के सदस्य के रूप में लॉग इन करने के बाद HytaleCharts पर अपने सर्वर के संपादन पृष्ठ से सुलभ हैं। Discord वोट Webhooks Discord webhooks आपको हर बार एक डिस्कॉर्ड चैनल में एक अधिसूचना प्राप्त करने की अनुमति देता है जब कोई वोट करता है, फेवरिट्स, या आपके सर्वर लिस्टिंग पर एक समीक्षा छोड़ देता है। डिस्कार्ड वेबहुक सेट करना अपने डिस्कार्ड सर्वर में एक वेबहुक बनाएँ सर्वर सेटिंग्स पर जाएं, फिर एकीकरण, फिर वेबहुक। "न्यू वेबहुक" पर क्लिक करें, इसे एक नाम दें (उदाहरण के लिए, "HytaleCharts Vote"), चैनल चुनें और वेबहुक यूआरएल की प्रतिलिपि बनाएँ। HarytaleCharts पर वेबहुक यूआरएल जोड़ें। अपने सर्वर के संपादन पृष्ठ पर जाएं, डिसऑर्ड वेबहुक अनुभाग को ढूंढें और यूआरएल पेस्ट करें। आपकी सेटिंग सहेजें हाइटेल चार्ट अब आपके डिकॉर्ड चैनल में एक स्वरूपित एम्बेड भेजेगा जब भी वोट, पसंदीदा या समीक्षा इवेंट होता है। What is Sent प्रत्येक वेबहुक अधिसूचना को एक डिसकॉर्ड एम्बेड के रूप में भेजा जाता है: हिन्दी घटना का प्रकार (वोट, पसंदीदा, समीक्षा) हिन्दी जिस खिलाड़ी ने कार्रवाई की थी उसका उपयोगकर्ता नाम A timestamp हिन्दी आपका सर्वर का नाम और एक लिंक वापस अपने HytaleCharts लिस्टिंग वेबहुक डिलीवरी 3 प्रयासों के साथ एक रिट्री सिस्टम का उपयोग करती है और रिट्रीज के बीच एक 5-सेकेंड बैकऑफ का उपयोग करती है। यदि सभी प्रयास विफल हो जाते हैं, तो विफलता लॉग हो जाती है, और HytaleCharts प्रति सर्वर लगातार असफलताओं को ट्रैक करता है। यदि कोई वेबहुक URL लगातार विफल हो जाता है (HTML त्रुटियां या बार आउट) तो यह अंततः ध्वजांकित हो जाएगा ताकि आप इसे अपडेट या ठीक कर सकें। वोटिफायर: इन-गेम वोट रिवार्ड्स Votifier एक प्रोटोकॉल है जो सीधे अपने गेम सर्वर पर वोट नोटिफिकेशन भेजता है, जिससे आप हाइटेली चार्ट पर वोट करते समय खिलाड़ियों को इन-गेम को पुरस्कृत करने की अनुमति मिलती है। हाइटेल चार्ट तीन Votifier वेरिएंट का समर्थन करता है। वोटिफायर v1 (RSA एन्क्रिप्टेड) मूल Votifier प्रोटोकॉल RSA एन्क्रिप्शन का उपयोग करता है। जब वोट डाला जाता है, तो HytaleCharts अपने सर्वर की सार्वजनिक कुंजी के साथ वोट संदेश एन्क्रिप्ट करता है और इसे टीसीपी के माध्यम से भेजता है। Votifier v1 स्थापित करने के लिए: अपने पर एक Votifier-compatible प्लगइन स्थापित करें हाइटेल सर्वर एक RSA कुंजी जोड़ी उत्पन्न करें (आमतौर पर यह पहली बार स्वचालित रूप से करता है) आपका सार्वजनिक कुंजी प्लगइन के विन्यास से हिन्दी Hytale पर चार्ट, अपने सर्वर के संपादन पृष्ठ पर जाएं और Votifier प्रकार को "v1" में सेट करें हिन्दी अपने सर्वर के होस्ट (आईपी एड्रेस या डोमेन), पोर्ट (वोटिफायर सुनना पोर्ट, गेम पोर्ट नहीं) और पेस्ट सार्वजनिक कुंजी सेव करें और इसे काम करने के लिए "टेस्ट कनेक्शन" बटन का उपयोग करें वोट संदेश मानक Votifier प्रारूप का अनुसरण करता है: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n, PKCS#1 v1.5 padding के साथ एन्क्रिप्टेड. वोटिफायर v2 (HMAC-SHA256) Votifier v2 अधिक आधुनिक प्रोटोकॉल है। RSA एन्क्रिप्शन के बजाय, यह साझा टोकन के साथ हस्ताक्षरित HMAC-SHA256 का उपयोग करता है। हैंडशेक में फिर से खेलना हमलों को रोकने के लिए सर्वर से एक चुनौती स्ट्रिंग शामिल है। Votifier v2 स्थापित करने के लिए: Install a v2-compatible Votifier प्लगइन token (shared secret) प्लगइन की कॉन्फ़िगरेशन फ़ाइल में हिन्दी Hytale पर चार्ट, Votifier प्रकार को "v2" में सेट करें हिन्दी अपने सर्वर के होस्ट, पोर्ट और टोकन सेव और परीक्षण कनेक्शन V2 प्रोटोकॉल TCP के माध्यम से जुड़ता है, एक चुनौती टोकन के साथ एक हथकड़ी बधाई पढ़ता है, फिर HMAC-SHA256 के साथ एक JSON पेलोड हस्ताक्षरित द्विआधारी पैकेट भेजता है। पेलोड में सेवा का नाम ("HytaleCharts"), उपयोगकर्ता नाम, आईपी पता, मिलीसेकेंड में टाइमस्टैम्प और चुनौती स्ट्रिंग शामिल है। HTTP Votifier Hytale-विशिष्ट प्लगइन्स के लिए जो कच्चे टीसीपी के बजाय HTTP का उपयोग करते हैं, HytaleCharts HTTP समापन बिंदु मोड का समर्थन करते हैं। यह प्लगइन डेवलपर्स के लिए कार्यान्वयन के लिए सबसे सरल प्रोटोकॉल है। HTTP Votifier स्थापित करने के लिए: हिन्दी एक प्लगइन स्थापित करें जो वोट प्राप्त करने के लिए HTTP समापन बिंदु को उजागर करता है हिन्दी Hytale पर चार्ट, Votifier प्रकार को "HTTP" में सेट करें पूर्ण endpoint URL (जैसे, https://your-server.com:8080/vote) हिन्दी यदि प्लगइन को टोकन की आवश्यकता होती है, तो इसे टोकन क्षेत्र में दर्ज करें। HytaleCharts X-Votifier-Signature हेडर में HMAC-SHA256 हस्ताक्षर के अनुरोध पर हस्ताक्षर करेगा। सेव और टेस्ट HTTP अनुरोध serviceName, username, address, और timestamp के साथ एक JSON बॉडी भेजता है। क्षेत्र। सभी Votifier प्रकार के लिए महत्वपूर्ण नोट्स Usernames को 16 अक्षरों से जोड़ा जाता है ताकि हाइटेल की यूज़रनेम लिमिट से मिलान किया जा सके। HytaleCharts सेट होने पर खिलाड़ी के Hytale उपयोगकर्ता नाम का उपयोग करता है, अन्यथा उनका Discord उपयोगकर्ता नाम। कनेक्शन टाइमआउट 5 सेकंड है। यदि आपका सर्वर 5 सेकंड के भीतर जवाब नहीं देता है, तो प्रयास विफल रहा है। Failed प्रयास 3 बार को घातीय बैकऑफ (10s, 30s, 60s) के साथ पुनः प्रयास करता है। हिन्दी आप वास्तविक वोट की आवश्यकता के बिना अपने सेटअप को सत्यापित करने के लिए HytaleCharts पर टेस्ट कनेक्शन बटन का उपयोग कर सकते हैं। यह जाँच करता है कि सर्वर पहुंच योग्य है और अपेक्षित Votifier हैंडशेक के साथ जवाब देता है। जेनेरिक वेबहुक यदि आप अपनी खुद की बैकेंड सेवा, बॉट, या एप्लिकेशन को वोट नोटिफिकेशन भेजना चाहते हैं, तो जेनेरिक वेबहुक आपको एक कस्टम यूआरएल और पेलोड टेम्पलेट को परिभाषित करने देता है। कैसे जेनेरिक वेबहुक काम हिन्दी अपने सर्वर के संपादन पृष्ठ पर वेबहुक कॉन्फ़िगरेशन अनुभाग पर नेविगेट करें हिन्दी अपने समापन बिंदु का URL दर्ज करें payload टेम्पलेट को आपके द्वारा प्राप्त डेटा के साथ कॉन्फ़िगर करें अपनी सेटिंग्स सहेजें जब वोट इवेंट होता है, तो HytaleCharts आपके URL को कॉन्फ़िगर किए गए पेलोड के साथ HTTP POST अनुरोध भेजता है। सिस्टम टेम्पलेट चर का समर्थन करता है जो वास्तविक मूल्यों के साथ भेजा जाता है (वोटर यूज़रनेम, सर्वर का नाम, टाइमस्टैम्प आदि)। जेनेरिक वेबहुक डिस्कार्ड वेबहुक के रूप में एक ही रिट्री लॉजिक का उपयोग करते हैं: प्रगतिशील बैकऑफ़ (10s, फिर रिट्री के बीच 30s) के साथ 3 प्रयास। यदि सभी रिट्राइज़ विफल हो जाते हैं, तो आपके सर्वर के खिलाफ असफलता को ट्रैक किया जाता है और आपके डैशबोर्ड में लगातार असफलता को ध्वजांकित किया जाएगा। Heartbeat प्लगइन: ऑनलाइन स्थिति ट्रैकिंग HytaleCharts हार्टबीट प्लगइन अपने गेम सर्वर पर चलता है और आवधिक स्थिति अपडेट भेजता है ताकि आपकी लिस्टिंग हमेशा सटीक ऑनलाइन / ऑफलाइन स्थिति और खिलाड़ी की गिनती दिखा सके। यह कैसे काम करता है प्लगइन https://hytalecharts.com/api/heartbeat को दिल की धड़कन भेजता है हर 5 मिनट (या प्रीमियम सर्वर के लिए हर 20 सेकंड)। प्रत्येक दिल की धड़कन में शामिल हैं: आपका सर्वर हार्टबीट गुप्त (64-character hex token) Current प्लेयर गिनती और max खिलाड़ियों A players array व्यक्तिगत खिलाड़ी विवरण (username, UUID, world, ping) के साथ सर्वर मेटाडाटा जैसे सर्वर नाम, MOTD, uptime, और मेमोरी उपयोग स्थापित प्लगइन्स और World name सेटअप चरण एक दिल की धड़कन रहस्य उत्पन्न करें अपने सर्वर के संपादन पृष्ठ पर, हार्टबीट अनुभाग पर जाएं और "Generate Secret" पर क्लिक करें। यह एक अनूठा 64-character टोकन बनाता है। इंस्टॉल प्लगइन. अपने सर्वर के mods/ में HytaleCharts प्लगइन रखें निर्देशिका प्लगइन को कॉन्फ़िगर करें प्लगइन की config.json फ़ाइल संपादित करें और रहस्य सेट करें: A "secret": "YOUR_64_CHAR_HEARTBEAT_SECRET", "debug": झूठ अपने सर्वर को रिस्टार्ट करें प्लगइन तुरंत दिल की धड़कन भेजेगा। हाइटेल चार्ट पर सत्यापित करें अपने सर्वर के संपादन पृष्ठ की जाँच करें; इसे अंतिम हार्टबीट टाइमस्टैम्प दिखाना चाहिए और इंगित करना चाहिए कि कनेक्शन सक्रिय है। बहु सर्वर एकत्रीकरण यदि आप एकाधिक सर्वर उदाहरण (lobby, उत्तरजीविता, रचनात्मक) चलाते हैं तो उसी हार्टबीट गुप्त को साझा करते हुए, HytaleCharts स्वचालित रूप से उन्हें एकत्र करते हैं। यह उनके आईपी पते और सर्वर नाम से अलग-अलग उदाहरणों की पहचान करता है, प्रत्येक से नवीनतम दिल की धड़कन लेता है, और डबल-काउंटिंग से बचने के लिए UUID द्वारा खिलाड़ियों को मर्ज करता है। आपकी लिस्टिंग पर दिखाए गए कुल खिलाड़ी गिनती और अधिकतम खिलाड़ी सभी उदाहरणों में संयुक्त मूल्यों को दर्शाते हैं। ऑनलाइन स्थिति प्राथमिकता Hytale चार्ट प्राथमिकता प्रणाली का उपयोग करके अपने सर्वर की ऑनलाइन स्थिति निर्धारित करता है: External क्वेरी समापन बिंदु (यदि कॉन्फ़िगर किया गया है, उदाहरण के लिए, Nitrado क्वेरी एपीआई) Heartbeat प्लगइन (सर्वर ऑनलाइन दिखाता है अगर पिछले 5 मिनट के भीतर दिल की धड़कन प्राप्त हुई थी) UDP पिंग यदि हार्टबीट प्लगइन 5 मिनट से अधिक के लिए चुप हो जाता है और कोई बाहरी क्वेरी को कॉन्फ़िगर नहीं किया गया है, तो सर्वर UDP पिंग स्टेटस में वापस आ जाता है। पब्लिक सर्वर एपीआई टोकन HytaleCharts एक सार्वजनिक एपीआई प्रदान करता है जो आपको मतदाता डेटा, सर्वर आँकड़ों और अन्य सूचना प्रोग्रामेटिक रूप से क्वेरी करने देता है। इसका उपयोग करने के लिए, आपको एक एपीआई टोकन की आवश्यकता है। अपना एपीआई टोकन प्राप्त करना हिन्दी HytaleCharts पर अपने सर्वर के संपादन पृष्ठ पर जाएं Navigate to the API अनुभाग एक एपीआई टोकन उत्पन्न करें कॉपी और इसे सुरक्षित रूप से स्टोर करें। टोकन सार्वजनिक सर्वर एपीआई समापन बिंदुओं के सभी अनुरोधों को प्रमाणित करता है। एपीआई का उपयोग Authorization आपके API अनुरोधों के शीर्षलेख: GET /api/public/servers/{server_id}/voter लेखक: Bearer Your_API_TOKEN सार्वजनिक एपीआई आपको हाल के मतदाताओं, सर्वर सांख्यिकी और अन्य डेटा को प्राप्त करने देता है जो आप अपने सर्वर पर कस्टम एकीकरण, लीडरबोर्ड या रिवार्ड सिस्टम बनाने के लिए उपयोग कर सकते हैं। पूर्ण एपीआई प्रलेखन और समापन बिंदु विवरण के लिए, HytaleCharts पर सर्वर एपीआई पेज की जांच करें। Troubleshooting Isue संभावित कारणSolution Discord वेबहुकInvalid वेबहुक यूआरएलDelete और Discord में वेबहुक को फिर से बनाएँ, फिर HytaleCharts पर URL अद्यतन करें Votifier परीक्षण "कोई जवाब नहीं"फ़ायरवॉल के साथ विफल रहता है Votifier पोर्टEnsure Votifier port (not the game port) अपने फ़ायरवॉल में खुला है Votifier परीक्षण कहते हैं "Invalid V2 handhake"Server केवल v1 का समर्थन करता है लेकिन आप v2Votifier प्रकार को v1 में बदलें और RSA सार्वजनिक कुंजी को टोकन के बजाय प्रदान करें Heartbeat पंजीकृत नहीं हैWrong secret in प्लगइन config Double-check that secret in config. जेसन एक से मेल खाता है जिसे हाइटेला चार्ट्स बिल्कुल पर दिखाया गया है Player count 0plugin संस्करण 1.5.0Htale अद्यतन करें चार्ट नवीनतम संस्करण में प्लगइन करते हैं, जो व्यक्तिगत खिलाड़ी डेटा भेजता है वेबहुक को विफल होने के रूप में चिह्नित किया गया100+ लगातार असफलताओंFix the endpoint URL, फिर इसका परीक्षण करें। सफल वितरण विफलता काउंटर को रीसेट करता है। प्रमाणन यदि आप यहाँ शामिल नहीं मुद्दों में भाग लेते हैं, तो संपर्क फ़ॉर्म on HytaleCharts. हम समस्याओं का निदान करने में मदद करने के लिए अपने सर्वर के वेबहुक लॉग और हार्टबीट इतिहास की जांच कर सकते हैं। इन एकीकरण की स्थापना कुछ मिनट लगते हैं लेकिन यह काफी सुधार करता है कि आपका सर्वर हाइटेली चार्ट्स और आपके समुदाय के साथ कैसे बातचीत करता है। सक्रिय वोट नोटिफिकेशन के साथ सर्वर और इन-गेम रिवॉर्ड लगातार मतदाताओं से उच्च सगाई और वापसी यात्राओं को देखते हैं। अन्य सर्वर लिस्टिंग को ब्राउज़ करें यह देखने के लिए कि कैसे शीर्ष सर्वर अपनी एकीकरण विशेषताओं का वर्णन करते हैं और यह सुनिश्चित करते हैं कि आपकी खुद की लिस्टिंग ने उल्लेख किया है कि आपने क्या सेट किया है।