How to Set Up Webhooks and Bildirims for Your Hytale Server

HytaleCharts, bağlantınıza bağlanmanıza izin veren birkaç entegrasyon seçeneği sunuyor Hytale server Discord, oyun sunucunuz ve dış araçlar için liste. Bir oyuncu sunucunuz için oy verdiğinde, bir Discord bildirim alabilir, Votifier aracılığıyla oyun ödüllerini tetikleyebilir, kendi arkanıza özel bir webhook ateş edebilirsiniz ve sunucu durumunuzu kalp atış ile güncel tutabilirsiniz. Bu kılavuz, her entegrasyonu sıfırdan nasıl kurulacağını kapsar. Tüm bu özellikler sunucunuzun düzenleme sayfasından sunucu sahibi veya bir takım üyesi olarak giriş yaptıktan sonra HytaleCharts sayfasında erişilebilir. Discord Oy Webhooks Discord webhooks her seferinde bir Discord kanalda bir bildirim almanızı veya sunucu listenizde bir incelemeyi bırakın. Bölüm Webhooks Discord sunucunuzda bir webhook oluşturun. Server Ayarlarına git, sonra Entegrasyonlar, sonra Webhooks. "Yeni Webhook", ona bir isim verin (örneğin, "HytaleCharts Oys") kanalı seçin ve webhook URL'sini kopyalayın. Webhook URL'yi HytaleCharts'te ekleyin. Sunucunuzun düzenleme sayfasına gidin, Discord Webhook bölümünü bulun ve URL'yi yapıştırın. Ayarlarınızı saklayın. Hytale Grafikler şimdi bir oylama, favori veya inceleme olayı meydana geldiğinde Discord kanalınıza bir formatlanmış bir yer gönderir. Sent Her webhook bildirim, içeren bir Discord gömülü olarak gönderilir: Olay türü ( favori, yorum) Eylemi gerçekleştiren oyuncunun adı A timestamp Sunucu adınız ve HytaleCharts listenize bir bağlantı Webhook teslimat, 3 deneme ve retries arasında 5 saniyelik bir geri dönüş sistemi kullanır. Eğer tüm girişimler başarısız olursa, başarısızlık giriştir ve HytaleCharts sunucu başına ardı ardı ardı ardı ardı ardı ardı ardı ardına başarısızlıkları izler. Eğer bir webhook URL sürekli başarısız olursa (dönüşüm HTTP hataları veya zamanlar), sonunda bayraklı olacak, böylece güncellemek veya düzeltebilirsiniz. Votifier: In-Game Oy Ödülleri Votifier doğrudan oyun sunucunuza oy veren bir protokoldür, HytaleCharts'e oy verdiklerinde oyuncuları ödüllendirmenize izin verir. Hytale Grafikler üç Votifier varyantını destekler. Votifier v1 (RSA Encrypted) Orijinal Votifier protokolü RSA şifreleme kullanır. Oy verildiğinde, HytaleCharts sunucunuzun kamusal anahtarıyla bir oylama mesajı şifreliyor ve bunu TCP üzerinden gönderiyor. Votifier v1: Install a Votifier-compatible plugin on your Hytale server Generate an RSA anahtar çifti (genellikle bunu ilk başta otomatik olarak yapar) Copy your public key Eklentinin konfigürasyonundan On Hytale Grafikler, sunucunuzun düzenleme sayfasına gidin ve "v1" Sunucunuzun host (IP adresi veya domain), port (The Votifier Hear port, not the game port), ve public key Kaydet ve işe yaradığını doğrulamak için "Test Connection" düğmesine kullanın Oy mesajı standart Votifier formatını takip eder: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n, PKCS#1 v1.5 padding. Votifier v2 (HMAC-SHA256) Votifier v2 daha modern protokoldür. RSA şifrelemesi yerine, HMAC-SHA256 paylaşılan bir token imzalanır. Elhake, replay saldırıları önlemek için sunucudan bir meydan okuma dizesini içerir. Votifier v2: Install a v2-compatible Votifier eklenti token (paylaşmış sır) eklenti yapılandırma dosyası On Hytale Grafikler, Votifier type to "v2" Sunucunuzun host, port ve token Kaydet ve bağlantıyı test edin v2 protokolü TCP aracılığıyla bağlanır, bir elhake selamı bir meydan okuma ile okur, sonra HMAC-SHA256 ile imzalanmış bir JSON ödeme yükü içeren bir ikili paketi gönderir. Ödeme yükü hizmet adı ("HytaleCharts") içerir, kullanıcı adı, IP adresi, milisans zamanında zamantamp ve meydan okuma dizesi. HTTP Votifier For Hytale-specific plugins that use HTTP instead of raw TCP, HytaleCharts bir HTTP endpoint modu destekler. Bu, eklenti geliştiricileri için uygulamak için en basit protokoldür. HTTP Votifier: Oy almak için bir HTTP uç noktası ortaya koyan bir eklenti yükleyin On Hytale Grafikler, Votifier type to "HTTP" Enter the full endpoint URL (e.g., https://your-server.com:8080/vote) Eğer eklenti bir token gerektirirse, token alanında girin. HytaleCharts, X-Votifier-Signature başlığında bir HMAC-SHA256 imzasını imzalayacaktır. Kaydet ve test HTTP isteği serviceName, username, address ve timestamp alanlar. Tüm Votifier Tipleri için Important Notlar Usernames, Hytale'nin kullanıcı limitini eşleştirmek için 16 karaktere kadar kodlanmıştır. HytaleCharts, oyuncunun Hytale kullanıcısını ayarlarsa, aksi takdirde Discord kullanıcı adı. Connection süresi 5 saniyedir. Sunucunuz 5 saniye içinde yanıt vermezse, deneme başarısız sayılır. Failed, 3 kata kadar tekrar denemeye çalışır(s, 30s, 60'lar arası girişimler). Kurulumunuzu gerçek bir oylamaya gerek kalmadan doğrulamak için Test Connection düğmesine kullanabilirsiniz. Bu, sunucunun ulaşılabilir olduğunu ve beklenen Votifier elhake ile yanıt verdiğini kontrol eder. Generic Webhooks If you want to send vote notifications to your own backend service, Bot, or application, general webhooks Özel bir URL tanımlamanıza ve ödeme yükleme şablonu tanımlamanıza izin verir. What Generic Webhooks Work Sunucunuzun düzenleme sayfasında, webhook yapılandırma bölümüne gidin The URL of your endpoint Configure the payload şablon with the data you want to receive Ayarlarınızı saklayın Oylama olayı gerçekleştiğinde, HytaleCharts, yapılandırılan ücret yükü ile URL'nize bir HTTP POST isteği gönderir. Sistem, gerçek değerler ile değiştirilen şablon değişkenlerini gönderir (kullanıcı adı, sunucu adı, zaman notamp vs.). Generic webhooks, Discord webhooks olarak aynı yeniden deneme mantığını kullanır: 3 İlerici geri çekilme ile çalışır (10s, sonra yeniden kurullar arasındaki 30s). Tüm retries başarısız olursa, başarısızlık sunucunuza karşı takip edilir ve kalıcı başarısızlıklar panoda bayraklanacaktır.