چگونگی تنظیم Webhooks و اعلان ها برای سرور Hytale

HytaleCharts چندین گزینه ادغام را فراهم می کند که به شما امکان اتصال شما را می دهد. لیست سرور Hytale برای Discord، سرور بازی شما و ابزارهای خارجی. هنگامی که بازیکن برای سرور شما رای می دهد، می توانید یک اعلان Discord دریافت کنید، باعث پاداش در بازی از طریق Votifier، یک وب سفارشی را به backend خود شلیک کنید و وضعیت سرور خود را به روز با پلاگین ضربان قلب نگه دارید. این راهنما چگونگی تنظیم هر ادغام از ابتدا را پوشش می دهد. تمام این ویژگی ها از صفحه ویرایش سرور شما در HytaleCharts پس از ورود به عنوان مالک سرور یا یک عضو تیم قابل دسترس هستند. Discord رای Webhooks Discord webhooks به شما اجازه می دهد یک اعلان در کانال Discord هر بار که کسی رای می دهد، مورد علاقه، و یا یک بررسی در لیست سرور خود را. تنظیمات up Discord Webhooks ایجاد یک وب را در سرور Discord خود. به تنظیمات سرور، سپس ادغام، سپس Webhooks بروید. روی “Webhook” کلیک کنید، یک نام به آن بدهید (به عنوان مثال، “HytaleCharts رای می دهد”)، کانال را انتخاب کنید و URL webhook را کپی کنید. اضافه کردن URL وب در HytaleCharts به صفحه ویرایش سرور خود بروید، بخش Discord Webhook را پیدا کنید و URL را جای دهید. تنظیمات خود را حفظ کنید. Hytale نمودارها در حال حاضر یک جاسازی فرمت شده را به کانال Discord شما ارسال می کنند هر زمان که یک رای، مورد علاقه یا رویداد بازبینی رخ می دهد. چه چیزی Sent را دریافت می کند هر اعلان وب را به عنوان یک آداپتور Discord ارسال می کند: نوع رویداد (vote، مورد علاقه، بررسی) نام کاربری بازیکنی که این عمل را انجام داد a timestamp نام سرور شما و پیوند به لیست HytaleCharts شما Webhook تحویل با 3 تلاش و 5 ثانیه عقب نشینی بین retries استفاده می کند. اگر همه تلاش ها شکست بخورد، شکست وارد می شود و HytaleCharts شکست های متوالی در هر سرور را دنبال می کند. اگر یک URL وب به طور مداوم شکست بخورد (اشتباهات HTTP یا زمان های دیگر را خاموش می کند)، در نهایت پرچم گذاری می شود تا بتوانید آن را به روز کنید یا اصلاح کنید. Votifier: In-Game رای می دهد Votifier یک پروتکل است که اعلان های رای را به طور مستقیم به سرور بازی شما ارسال می کند و به شما اجازه می دهد تا بازیکنان را در بازی زمانی که به HytaleCharts رای می دهند، پاداش دهید. Hytale نمودارها از سه نوع Votifier پشتیبانی می کنند. Votifier v1 (RSA Encrypted) پروتکل اصلی Votifier از رمزگذاری RSA استفاده می کند. هنگامی که یک رای اجرا می شود، HytaleCharts یک پیام رای با کلید عمومی سرور شما رمزگذاری می کند و آن را از طریق TCP ارسال می کند. تنظیم Votifier v1: یک پلاگین سازگار با Votifier را بر روی پلاگین شما نصب کنید Hytale server Generate a RSA key جفت (این پلاگین معمولا این کار را به طور خودکار در اجرا اول انجام می دهد) کلید عمومی خود را از پیکربندی پلاگین On Hytale نمودارها، به صفحه ویرایش سرور خود بروید و نوع Votifier را به “v1” تنظیم کنید. host سرور خود را وارد کنید (آدرس IP یا دامنه)، port ( پورت گوش دادن Votifier، نه پورت بازی)، و کلید عمومی را جای دهید. Save و استفاده از دکمه “Test Connection” برای تأیید عملکرد آن پیام رای گیری از فرمت استاندارد Votifier پیروی می کند: VOTE\nHytalearts\n{username}\n{ip_addressn، رمزگذاری شده با PKCS #1 v1.5.. Votifier v2 (HMAC-SHA256) Votifier v2 پروتکل مدرن تر است. به جای رمزگذاری RSA، از امضای HMAC-SHA256 با یک توکن مشترک استفاده می کند. دست دادن شامل یک رشته چالش از سرور برای جلوگیری از حملات مجدد است. تنظیم Votifier v2: Install a v2- سازگار پلاگین Votifier پیدا کردن بهken در فایل پیکربندی پلاگین On Hytale نمودارها، نوع Votifier را به تنظیم کنید. host را وارد کنید، port و token Save و تست اتصال پروتکل v2 از طریق TCP متصل می شود، یک سلام دست را با یک توکن چالش می خواند، سپس یک بسته باینری حاوی یک محموله JSON امضا شده با HMAC-SHA256 ارسال می کند. این محموله شامل نام سرویس ("HytaleCharts")، نام کاربری، آدرس IP، زمان بندی در میلی ثانیه و رشته چالش است. HTTP Votifier برای افزونه های خاص Hytale که به جای TCP خام از HTTP استفاده می کنند، HytaleCharts از حالت endpoint HTTP پشتیبانی می کند. این ساده ترین پروتکل برای پیاده سازی برای توسعه دهندگان پلاگین است. تنظیم HTTP Votifier: یک افزونه نصب کنید که یک نقطه پایانی HTTP را برای دریافت رای گیری افشا می کند. On Hytale نمودارها، نوع Votifier را به “HTTP” تنظیم کنید. Enter the full endpoint URL (به عنوان مثال، https://your-server.com:80/vote اگر افزونه به یک توکن نیاز دارد، آن را در زمینه توکن وارد کنید. HytaleCharts این درخواست را با امضای HMAC-SHA256 در X-Votifier-Signature header امضا خواهد کرد. Save و Test درخواست HTTP یک بدن JSON با serviceName، username، ، address و timeamp> را ارسال می کند. Important Notes for All Votifier type نام های کاربری به 16 کاراکتر تقسیم می شوند تا با محدودیت نام کاربری Hytale مطابقت داشته باشند. HytaleCharts از نام کاربری Hytale بازیکن استفاده می کند، در غیر این صورت نام کاربری Discord آنها. Connection timeout 5 ثانیه است. اگر سرور شما در عرض 5 ثانیه پاسخ ندهد، تلاش شکست خورده است. تلاش های شکست خورده تا 3 بار با backoff نمایی (10s، 30s، 60s بین تلاش) شما می توانید از دکمه Test Connection در HytaleCharts برای تأیید تنظیمات خود بدون نیاز به یک رای واقعی استفاده کنید. این بررسی می کند که سرور قابل دسترسی است و با دست دادن های مورد انتظار ویتکر پاسخ می دهد. Generic Webhooks اگر می خواهید اعلان های رای را به سرویس، ربات یا برنامه خود ارسال کنید، وب سایت عمومی به شما اجازه می دهد یک URL سفارشی و قالب بار را تعریف کنید. چگونه Generic Webhooks کار می کند بر روی صفحه ویرایش سرور خود، به بخش پیکربندی Webhook بروید. URL را از نقطه پایانی خود وارد کنید Configure the load Template با داده هایی که می خواهید دریافت کنید تنظیمات خود را ذخیره کنید هنگامی که یک رویداد رای رخ می دهد، HytaleCharts یک درخواست HTTP POST را به URL شما با محموله پیکربندی شده ارسال می کند. این سیستم از متغیرهای قالب پشتیبانی می کند که با مقادیر واقعی در زمان ارسال جایگزین می شوند (نام کاربری، نام سرور، timetamp و غیره). در HytaleCharts به دست آورید. ما می توانیم logs وب سرور و تاریخچه ضربان قلب را برای کمک به تشخیص مشکلات بررسی کنیم. تنظیم این ادغام ها چند دقیقه طول می کشد اما به طور قابل توجهی بهبود می بخشد که چگونه سرور شما با HytaleCharts و جامعه شما ارتباط برقرار می کند. سرورها با اعلان های رای گیری فعال و پاداش در بازی به طور مداوم شاهد تعامل بالاتر و بازگشت بازدید از رای دهندگان هستند.