Cara Mengatur Pengatur Web dan Pemberitahuan Untuk Server Hytale Anda

< p > HytaleCharts menyediakan beberapa opsi integrasi yang memungkinkan Anda menyambung Anda Daftar server hitale ke Discord, server permainan Anda, dan alat-alat eksternal. Ketika pemain memilih server Anda, Anda dapat menerima pemberitahuan Discord, memicu imbalan masuk game melalui Vofiser, tembakkan webhook suai ke backend Anda sendiri, dan menjaga status server Anda up- date dengan plugin detak jantung. < / p > < p > Panduan ini mencakup bagaimana mengatur setiap integrasi dari awal. Semua fitur ini dapat diakses dari halaman penyuntingan server Anda di HytaleCharts setelah log masuk sebagai pemilik server atau anggota tim. < / p > < h2 > Discord Vote Webhooks < / h2 > < p > Discord webhooks membiarkan Anda menerima pemberitahuan dalam saluran Discord setiap kali suara seseorang untuk, favorit, atau meninggalkan ulasan pada daftar server Anda. < / p > < h3 > Menata Cakram Discord < / h3 > < ol > < li > < strong > Buat sebuah webhook dalam server Discord anda. < / strong > Pergi ke Pengaturan Server, kemudian Integrasi, kemudian Pengait Web. Klik "Webhook Baru", beri nama (misalnya, "HytaleCharts Votes"), pilih saluran, dan salin URL webhook. < / li > < li > < strong > Tambahkan URL webhook di HytaleCharts. < / strong > Pergi ke halaman edit server Anda, temukan bagian Discord Webhook, dan tempelkan URL. < / li > < li > < strong > Simpan pengaturan anda. < / strong > Hytale Charts kini akan mengirim sebuah format embed ke saluran Discord anda ketika suatu pilihan, favorit, atau ulasan terjadi. < / li > < / ol > < h3 > Apa Gets Dikirim < / h3 > < p > Setiap pemberitahuan webhook dikirim sebagai Discord embed berisi: < / p > < ul > < li > Jenis acara (suara, favorit, ulasan) < / li > < li > Nama pengguna pemutar yang melakukan aksi < / li > < li > Sebuah timestamp < / li > < li > Nama server Anda dan link kembali ke HytaleCharts Anda mendaftar < / li > < / ul > < p > Pengiriman Webhook menggunakan sistem coba ulang dengan 3 percobaan dan 5 detik latar belakang antara percobaan. Jika semua upaya gagal, kegagalan dicatat, dan HytaleCharts melacak kegagalan berturut-turut setiap server. Jika sebuah URL webhook secara konsisten gagal (mengembalikan kesalahan HTTP atau waktu habis), maka akan ditandai sehingga Anda dapat memperbarui atau memperbaikinya. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba23b50c0011176c66b _ 66 _ farman.jpg" alt = "A Peternakan hitale menunjukkan jenis server yang membangun manfaat dari alat-alat keterlibatan masyarakat" loading = "malas" gaya = "width: 100%; tinggi: auto; border-radius: 8px; margin: 1.5rem 0;" / > < h2 > Vofierer: In- Game Vote Rewards < / h2 > < p > Votifier adalah protokol yang mengirimkan pemberitahuan suara langsung ke server permainan Anda, memungkinkan Anda untuk menghadiahi pemain dalam game ketika mereka memilih pada HytaleCharts. Hytale Karakter mendukung tiga varian Voficer. < / p > < h3 > Voficer v1 (RSA Terenkripsi) < / h3 > < p > Protokol Voficer asli menggunakan enkripsi RSA. Ketika sebuah suara diputar, HytaleCharts mengenkripsi pesan suara dengan kunci publik server Anda dan mengirimkannya melalui TCP < / p > < p > Untuk mengatur V1 Voficer: < / p > < ol > < li > Pasang sebuah Plugin Votifier-kompatibel pada Anda Server Hytale < / li > < li > Hasilkan sebuah pasangan kunci RSA (plugin biasanya melakukan ini secara otomatis pada jalankan pertama) < / li > < li > Salin kunci publik < kuat > Anda < / strong > dari konfigurasi plugin < / li > < li > On Hytale Charts, pergi ke halaman penyuntingan server Anda dan atur tipe pengisi suara ke "v1" < / li > < li > Masukkan host < / strong > server Anda < / strong > (alamat IP atau domain), < strong > port < / strong > (port mendengarkan Vofiser, bukan port permainan), dan tempelkan < strong > kunci publik < / strong > < / li > < li > Simpan dan gunakan tombol "Uji Koneksi" untuk memverifikasi bekerja < / li > < / ol > < p > Pesan suara mengikuti format Voficer standar: < kode > VOTE\ nHytaleCharts\ n {username}\ n {ip _ address}\ n {timestamp}\ n < / code >, dienkripsi dengan PKCS # 1 v1,5 padding. < / p > < h3 > Voficer v2 (HMAC-SHA256) < / h3 > < p > Voficer v2 adalah protokol yang lebih modern. Alih-alih enkripsi RSA, ia menggunakan penandatanganan HMAC-SHA256 dengan token bersama. Jabat tangan termasuk string tantangan dari server untuk mencegah serangan ulang. < / p > < p > Untuk mengatur V2 Voficer: < / p > < ol > < li > Pasang sebuah v2-kompatibel Plugin pengisi suara < / li > < li > Temukan token < strong > < / strong > (berbagi rahasia) dalam berkas konfigurasi plugin < / li > < li > On Hytale Isi, atur tipe pengisi suara ke "v2" < / li > < li > Masukkan host < kuat > server Anda < / strong >, < kuat > port < / strong >, dan < strong > token < / strong > < / li > < / li > < li > Simpan dan uji koneksi < / li > < / ol > < p > Protokol v2 menghubungkan via TCP, membaca salam jabat tangan dengan token tantangan, lalu mengirim paket biner berisi muatan JSON yang ditandatangani dengan HMAC- SHA256. Muatan termasuk nama layanan ("HytaleCharts"), username, alamat IP, timestamp dalam milidetik, dan string tantangan. < / p > < h3 > HTTP Vofifier < / h3 > < p > Untuk plugin Hytale- spesifik yang menggunakan HTTP mentah bukan TCP, HytaleCharts mendukung sebuah mode titik akhir HTTP. Ini adalah protokol paling sederhana untuk mengimplementasikan bagi pengembang plugin. < / p > < p > Untuk mengatur pengisi suara HTTP: < / p > < ol > < li > Pasang plugin yang mengekspos titik akhir HTTP untuk menerima suara < / li > < li > On Hytale Charts, atur tipe pengisi suara ke "HTTP" < / li > < li > Masukkan seluruh URL titik akhir < kuat > < / kuat > (misalnya, < kode > https: / / your-server.com: 8080 / suara < / kode >) < / li > < li > Bila plugin memerlukan token, masukkan ke dalam ruas token. HytaleCharts akan menandatangani permintaan dengan tanda tangan HMAC-SHA256 dalam < kode > X-Votifier-Signature < / code > header. < / li > < li > Simpan dan uji < / li > < / ol > < p > Permintaan HTTP mengirim tubuh JSON dengan < kode > Nama ServiceName < / kode >, < kode > username < / code >, < kode > alamat < / code >, dan < kode > timestamp < / code > field. < / p > < h3 > Catatan Penting untuk Semua Jenis Voficer < / h3 > < ul > < li > < strong > Nama pengguna dipotong ke 16 karakter < / strong > untuk mencocokkan batas nama pengguna Hytale. HytaleCharts memakai nama pengguna Hytale pemutar bila ditata, jika tidak nama pengguna Discord mereka. < / li > < li > < strong > Tenggat sambungan adalah 5 detik. < / strong > Jika server Anda tidak menjawab dalam waktu 5 detik, percobaan dianggap gagal. < / li > < li > < strong > Gagal mencoba sampai 3 kali < / strong > dengan backoff eksponensial (10s, 30-an, 60-an antara percobaan). < / li > < li > Anda dapat menggunakan tombol < strong > Test Connection < / strong > pada HytaleCharts untuk memverifikasi setup Anda tanpa membutuhkan suara yang nyata. Cek ini bahwa server dapat diakses dan merespon dengan jabat tangan Votifier yang diharapkan. < / li > < / ul > < h2 > Webhook Generik < / h2 > < p > Jika Anda ingin mengirim pemberitahuan suara ke layanan backend Anda sendiri, bot, atau aplikasi, webdocks generik biarkan Anda mendefinisikan sebuah URL dan templat muatan suai. < / p > < h3 > Seberapa Generik Webhook Work < / h3 > < ol > < li > Pada halaman penyuntingan server Anda, menavigasi ke bagian konfigurasi webhook < / li > < li > Masukkan URL < strong > < / strong > dari titik akhir Anda < / li > < li > Mengkonfigurasi < strong > payload template < / strong > dengan data yang Anda ingin menerima < / li > < li > Simpan pengaturan Anda < / li > < / ol > < p > Ketika sebuah acara suara terjadi, HytaleCharts mengirimkan permintaan POST HTTP ke URL Anda dengan muatan yang dikonfigurasi. Sistem mendukung variabel template yang digantikan dengan nilai aktual saat mengirim waktu (nama pengguna, nama server, timestamp, dsb.). < / p > < p > kait web generik menggunakan logika ulang yang sama seperti Pengait Web Discord: 3 percobaan dengan backoff progresif (10, 30, lalu 30-an diantara percobaan). Jika semua percobaan gagal, kegagalan dilacak terhadap server Anda, dan kegagalan gigih akan ditandai dalam dasbor Anda. < / p > < img src = "https: / / cdn.hytale.com / 5e7ba02d50c0011176c5ff _ 30 _ outlander _ setplement.jpg" alt = "Sebuah Outlander penyelesaian dalam Hytale menunjukkan jenis server komunitas yang bermanfaat dari integrations webhook" loading = "malas" gaya = "wid.100%; tinggi: borderder: -8.5xs >; 5m; -5m > < h2 > Plugin Heartbeat: Status Daring Pelacakan < / h2 > < p > Plugin detak jantung HytaleCharts berjalan pada server permainan Anda dan mengirim status pemutakhiran periodik sehingga daftar Anda selalu menunjukkan status online / offline yang akurat dan jumlah pemain. < / p > < h3 > Bagaimana It Works < / h3 > < p > Plugin mengirim detak jantung ke < kode > https: / / hytalecharts.com / api / heartbeat < / code > setiap 5 menit (atau setiap 20 detik untuk server premium). Setiap detak jantung termasuk: < / p > < ul > < li > Server Anda < kuat > rahasia detak jantung < / strong > (token hex 64-karakter) < / li > < li > Saat ini < strong > pemain menghitung < / strong > dan < strong > max player < / strong > < / li > < li > A < strong > pemain array < / strong > dengan rincian pemain individu (uUID, world, ping) < / li > < li > Metadata Server seperti < kuat > nama server < / strong >, < strong > MOTD < / strong >, < strong > uptime < / strong >, dan < strong > penggunaan memori < / strong > < / li > < / li > < li > Daftar plugin < strong > terpasang < / strong > dan < strong > nama dunia < / strong > < / li > < / ul > < h3 > Setup Langkah < / h3 > < ol > < li > < strong > Buat sebuah rahasia detak jantung. < / strong > Pada halaman penyuntingan server Anda, pergi ke bagian Heartbeat dan klik "Hasilkan Secret". Ini membuat token karakter 64-unik. < / li > < li > < strong > Pasang plugin. < / strong > Tempatkan plugin HytaleCharts di server Anda < kode > mods / < / code > direktori. < / li > < li > < strong > Mengkonfigurasi plugin. < / strong > Sunting berkas < kode > plugin konfigurasi < / code > dan atur rahasia: < pre > < kode > { "rahasia": "ANDA 64 _ CHAR _ HEARTBEAT _ SECRET", "debug": salah } < / code > < / pre > < / li > < li > < strong > Restart server Anda. < / strong > Plugin akan mulai mengirim detak jantung segera. < / li > < li > < strong > Verifikasi pada HytaleCharts. < / strong > Periksa halaman penyuntingan server Anda; ini harus menunjukkan tanda waktu detak jantung terakhir dan mengindikasikan bahwa koneksi aktif. < / li > < / ol > < h3 > Agregasi Multi- Server < / h3 > < p > Jika Anda menjalankan beberapa instansi server (lobi, kelangsungan hidup, kreatif) berbagi rahasia detak jantung yang sama, HytaleCharts secara otomatis mengumpulkan mereka. Ini mengidentifikasi contoh yang berbeda dengan alamat IP mereka dan nama server, mengambil detak jantung terbaru dari masing-masing, dan penggabungan pemain dengan UUID untuk menghindari duble- menghitung. Jumlah pemain dan pemain maksimal yang ditampilkan pada daftar Anda mencerminkan nilai gabungan pada semua kejadian. < / p > < h3 > Prioritas Status Daring < / h3 > < p > Hytale Isi menentukan status daring server Anda memakai sistem prioritas: < / p > < ol > < li > < strong > Permintaan akhir eksternal < / strong > (jika dikonfigurasi, mis, kuiri Nitrado API) < / li > < li > < strong > Plugin Heartbeat < / strong > (Server menunjukkan sebagai daring jika detak jantung diterima dalam 5 menit terakhir) < / li > < li > < strong > UDP ping < / strong > (fallback permintaan server) < / li > < / ol > < p > Jika plugin detak jantung pergi diam selama lebih dari 5 menit dan tidak ada query eksternal dikonfigurasi, server jatuh kembali ke status ping UDP. < / p > < h2 > Kunci API Publik < / h2 > < p > HytaleCharts menyediakan API publik yang memungkinkan Anda kueri data pemilih, statistik server, dan informasi lainnya secara pemrograman. Untuk menggunakannya, Anda memerlukan token API. < / p > < h3 > Mendapatkan API Token < / h3 > < ol > < li > Pergi ke halaman edit server Anda pada HytaleCharts < / li > < li > Navigasi ke daerah API < / li > < li > Hasilkan sebuah API token < / li > < li > Salin dan simpan secara aman. Token ini membuktikan semua permintaan ke server publik API titik akhir. < / li > < / ol > < h3 > Menggunakan API < / h3 > < p > Sertakan token dalam < kode > Otorisasi < / kode > header dari permintaan API Anda: < / p > < pre > < kode > GET / api / public / server / {server _ id} / pemilih Otorisasi: Pembawa ANDA _ API _ TOKEN < / code > < / pre > < p > API publik memungkinkan Anda untuk mengambil pemilih, statistik server, dan data lain yang dapat Anda gunakan untuk membangun integrasi kustom, leaderboard, atau sistem penghargaan di server Anda. < / p > < p > Untuk dokumentasi API lengkap dan rincian titik akhir, periksa < a href = "/ server-api" > Server API halaman < / a > pada HytaleCharts. < / p > < h2 > Troublesshooting < / h2 > < tabel > < head > < tr > < th > Issue < / th > < th > Kemungkinan Penyebab < / th > < th > Solusi < / th > < / tr > < / tr > < / thead > < tbody > < tr > < td > Discord webhook tidak mengirim < / td > < td > URL webhook tidak valid < / td > < td > Hapus dan buat ulang webhook dalam Discord, kemudian perbarui URL pada HytaleCharts < / td > < / tr > < / tr > < tr > < td > Voficer tes gagal dengan "Tidak ada balasan" < / td > < td > Firewall memblokir port Voticer < / td > < td > Pastikan port Vofierer (bukan port game) terbuka dalam firewall Anda < / td > < / tr > < / tr > < tr > < td > Voficer tes mengatakan "Jippa V2 tidak valid" < / td > < td > Server hanya mendukung v1 tetapi anda memilih v2 < / td > < td > Ubah tipe penghasil suara ke v1 dan memberikan kunci publik RSA daripada token < / td > < / tr > < / tr > < tr > < td > Heartbeat tidak mendaftar < / td > < td > rahasia di plugin config < / td > < td > < td > Double-check bahwa rahasia dalam config. json cocok dengan yang ditampilkan pada HytaleCharts persis < / td > < / tr > < tr > < td > jumlah pemain menunjukkan 0 < / td > < td > versi plugin lebih tua dari 1.5.0 < / td > < td > Update the Hytale Plugin karakter ke versi terakhir, yang mengirimkan data pemutar individu < / td > < / tr > < tr > < td > Webhook ditandai sebagai kegagalan < / td > < td > 100 + kegagalan berurutan < / td > < td > Perbaiki titik akhir URL, kemudian uji itu. Pengiriman sukses mengatur ulang penghitung kegagalan. < / td > < / tr > < / tbody > < / tabel > < p > Jika Anda menjalankan ke masalah tidak tercakup di sini, menjangkau melalui < a href = "/ about" > kontak formulir < / a > pada HytaleCharts. Kita dapat memeriksa log webhook server Anda dan riwayat detak jantung untuk membantu mendiagnosa masalah. < / p > < p > Mengatur integrasinya butuh beberapa menit tapi secara signifikan meningkatkan bagaimana server Anda berinteraksi dengan HytaleCharts dan komunitas Anda. Server dengan pemberitahuan suara aktif dan imbalan in- game konsisten melihat keterlibatan yang lebih tinggi dan kunjungan kembali dari pemilih. < a href = "/ server" > Ramban daftar server lain < / a > untuk melihat bagaimana server atas menggambarkan fitur integrasi mereka, dan pastikan daftar Anda menyebutkan apa yang telah Anda siapkan. < / p >