Πώς να ρυθμίσετε webhooks και ειδοποιήσεις για τον Hytale Server σας

Το HytaleCharts παρέχει αρκετές επιλογές ενσωμάτωσης που σας επιτρέπουν να συνδέσετε το Hytale server listing to Discord, το διακομιστή παιχνιδιών σας, και τα εξωτερικά εργαλεία. Όταν ένας παίκτης ψηφίζει για το διακομιστή σας, μπορείτε να λάβετε μια ειδοποίηση Discord, ενεργοποιήστε ανταμοιβές στο παιχνίδι μέσω του Votifier, απολύστε ένα προσαρμοσμένο webhook στο δικό σας σύστημα υποστήριξης, και κρατήστε την κατάσταση διακομιστή σας ενημερωμένη με το πρόσθετο καρδιακών παλμών. < p> Αυτός ο οδηγός καλύπτει τον τρόπο με τον οποίο θα δημιουργηθεί κάθε ολοκλήρωση από το μηδέν. Όλα αυτά τα χαρακτηριστικά είναι προσβάσιμα από τη σελίδα επεξεργασίας του διακομιστή σας στο HytaleCharts μετά την σύνδεση ως ιδιοκτήτης του διακομιστή ή μέλος της ομάδας. Ψηφοφορία ψηφοφορίας Webhooks Discord webhooks σας επιτρέπουν να λαμβάνετε μια ειδοποίηση σε ένα κανάλι Discord κάθε φορά που κάποιος ψηφίζει για, τα αγαπημένα, ή αφήνει μια κριτική για την λίστα server σας. S up discord webhooks < ol> Δημιουργήστε ένα webhook στο διακομιστή Discord σας. Πηγαίνετε στις Settings διακομιστή, στη συνέχεια, ενσωμάτωση, στη συνέχεια, Webhooks. Κάντε κλικ στο "New Webhook," δώστε του ένα όνομα (π.χ., "HytaleCharts Votes"), επιλέξτε το κανάλι, και αντιγράψτε το URL webhook. Προσθέστε το URL webhook στο HytaleCharts. Πηγαίνετε στη σελίδα επεξεργασίας του διακομιστή σας, βρείτε την ενότητα Discord Webhook και επικολλήστε το URL. Αποθήκευση ρυθμίσεων. Υαλώδης Τα διαγράμματα θα στείλουν τώρα μια μορφοποιημένη ενσωμάτωση στο κανάλι Discord σας κάθε φορά που μια ψηφοφορία, το αγαπημένο, ή γεγονός αναθεώρησης εμφανίζεται. Τι παίρνει η αποστολή Κάθε ειδοποίηση webhook αποστέλλεται ως ένθετο Έριδα που περιέχει: < ul> < li> Ο τύπος της εκδήλωσης (ψηφοφορία, φαβορί, κριτική) < li> Το όνομα χρήστη του παίκτη που πραγματοποίησε την ενέργεια Μια χρονοσφραγίδα < li> Το όνομα του εξυπηρετητή σας και ένας σύνδεσμος πίσω στην λίστα HytaleCharts σας Η παράδοση του Webhook χρησιμοποιεί ένα σύστημα επανέναρξης με 3 προσπάθειες και ένα 5 δευτερολέπτων πίσω μεταξύ retries. Αν όλες οι προσπάθειες αποτύχουν, η αποτυχία καταγράφεται, και HytaleCharts παρακολουθεί διαδοχικές αποτυχίες ανά εξυπηρετητή. Εάν ένα URL webhook αποτυγχάνει σταθερά (επιστρέφει λάθη HTTP ή φορές έξω), θα πρέπει τελικά να επισημανθεί έτσι ώστε να μπορείτε να το ενημερώσετε ή να το διορθώσετε. Εγκατέστησε ένα Votifier-συμβατό plugin για σας Εξυπηρετητής Hytale Δημιουργία ενός ζεύγους κλειδιών RSA (το plugin συνήθως το κάνει αυτόματα κατά την πρώτη εκτέλεση) < li>Αντιγραφή σας < strong>δημόσιο κλειδί< / strong> από τις ρυθμίσεις του plugin < li> Σε Hytale Διάγραμμα, μεταβείτε στη σελίδα επεξεργασίας του διακομιστή σας και ρυθμίστε τον τύπο Votifier στο "v1" < li> Εισάγετε το host (διεύθυνση IP ή domain), port (η θύρα ακρόασης Votifier, όχι η θύρα παιχνιδιού), και επικολλήστε το δημόσιο κλειδί Αποθήκευση και χρήση του κουμπιού "Δοκιμή σύνδεσης" για την επαλήθευση της λειτουργίας του < p> Το μήνυμα ψήφου ακολουθεί την τυπική μορφή Votifier: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestab}\n, κρυπτογραφημένο με PKCS#1 v1.5 padding. (HMAC-SHA256) Το V2 είναι το πιο σύγχρονο πρωτόκολλο. Αντί της κρυπτογράφησης RSA, χρησιμοποιεί την υπογραφή HMAC-SHA256 με μια κοινή ένδειξη. Η χειραψία περιλαμβάνει μια συμβολοσειρά πρόκλησης από τον εξυπηρετητή για να αποτρέψει τις επιθέσεις επανάληψης. Για να ρυθμίσετε Votifier v2: < ol> < li>Εγκατέστησε ένα v2 συμβατό Πρόσθετο εντοπιστή Βρείτε το δείκτη (μερισμένο μυστικό) στο αρχείο ρυθμίσεων του plugin < li> Σε Hytale Διάγραμμα, που ο τύπος του Φωνητή σε "v2" < li> Εισάγετε το host του server σας, port, και token Αποθήκευση και δοκιμή της σύνδεσης < p> Το πρωτόκολλο v2 συνδέεται μέσω του TCP, διαβάζει χαιρετισμό χειραψίας με ένδειξη πρόκλησης, στη συνέχεια στέλνει ένα δυαδικό πακέτο που περιέχει ένα ωφέλιμο φορτίο JSON υπογεγραμμένο με HMAC-SHA256. Το ωφέλιμο φορτίο περιλαμβάνει το όνομα υπηρεσίας ("HytaleCharts"), όνομα χρήστη, διεύθυνση IP, timestamp σε χιλιοστά του δευτερολέπτου, και τη συμβολοσειρά πρόκληση. Φωτιστήρας HTTP Για τα ειδικά για Hytale πρόσθετα που χρησιμοποιούν HTTP αντί για ακατέργαστο TCP, τα HytaleCharts υποστηρίζουν μια λειτουργία HTTP καταληκτικού σημείου. Αυτό είναι το απλούστερο πρωτόκολλο για την εφαρμογή για προγραμματιστές plugin. Για να ρυθμίσετε τονφωνητή HTTP: < ol> < li> Εγκαταστήστε ένα πρόσθετο που εκθέτει ένα τελικό σημείο HTTP για τη λήψη ψήφων < li> Σε Hytale Διάγραμμα, ορίστε τον τύπο του Φωνητή στο "HTTP" < li>Εισαγάγετε το πλήρες < strong> τελικό URL (π.χ., < code>https://your-server.com:8080 ψήφος ) < li> Αν το plugin απαιτεί ένα ενδεικτικό, εισάγετε το στο πεδίο token. HytaleCharts θα υπογράψει το αίτημα με μια υπογραφή HMAC-SHA256 στο X-Votifier-Υπογραφή κεφαλίδα. Αποθήκευση και δοκιμή Η αίτηση HTTP στέλνει ένα σώμα JSON με < code>serviceName, < code> username, < code>address, και < code>timestab πεδία. Σημαντικές σημειώσεις για όλους τους τύπους εντοπιστών < ul> Τα ονόματα χρηστών κατατέμνονται σε 16 χαρακτήρες για να ταιριάζουν με το όριο ονόματος χρήστη της Hytale. Το HytaleCharts χρησιμοποιεί το όνομα χρήστη Hytale του παίκτη αν οριστεί, διαφορετικά το όνομα χρήστη Discord τους. Συνεχίστε το χρονικό όριο είναι 5 δευτερόλεπτα. Αν ο διακομιστής σας δεν ανταποκριθεί μέσα σε 5 δευτερόλεπτα, η προσπάθεια θεωρείται αποτυχημένη. < li>< strong> Αποτυχημένες προσπάθειες να ξαναδοκιμάσουν έως και 3 φορές με εκθετική υποχώρηση (10, 30, 60 μεταξύ των προσπαθειών). < li> Μπορείτε να χρησιμοποιήσετε το πλήκτρο Test Connection στο HytaleCharts για να επαληθεύσετε τη ρύθμιση χωρίς να χρειάζεστε πραγματική ψηφοφορία. Αυτό ελέγχει ότι ο διακομιστής είναι προσβάσιμος και ανταποκρίνεται με την αναμενόμενη χειραψία Votifier. Γενικά webhooks Αν θέλετε να στείλετε ειδοποιήσεις ψήφου στη δική σας υπηρεσία υποστήριξης, bot, ή εφαρμογή, γενικά webhooks σας επιτρέπουν να ορίσετε ένα προσαρμοσμένο πρότυπο URL και payload. Πως λειτουργούν τα Generic Webhooks < ol> < li> Στη σελίδα επεξεργασίας του διακομιστή σας, πλοηγηθείτε στην ενότητα ρυθμίσεων webhook < li> Εισάγετε το URL του τελικού σας σημείου < li>Συμμορφώστε το πρότυπο < strong>payload με τα δεδομένα που θέλετε να λάβετε < li>Αποθήκευση ρυθμίσεων Όταν συμβαίνει ένα γεγονός ψηφοφορίας, το HytaleCharts στέλνει ένα αίτημα HTTP POST στο URL σας με το ρυθμισμένο ωφέλιμο φορτίο. Το σύστημα υποστηρίζει μεταβλητές προτύπου που αντικαθίστανται με πραγματικές τιμές κατά την αποστολή του χρόνου (όνομα χρήστη, όνομα εξυπηρετητή, timestamp, κ.λπ.). Τα Generic webhooks χρησιμοποιούν την ίδια λογική επανάληψης με τα discord webhooks: 3 προσπάθειες με προοδευτική backoff (10s, τότε 30s μεταξύ retries). Αν αποτύχουν όλες οι επαναλήψεις, η αποτυχία εντοπίζεται στον διακομιστή σας και οι επίμονες αποτυχίες θα επισημαίνονται στο ταμπλό σας. Το πρόσθετο HytaleCharts χτύπος της καρδιάς τρέχει στο διακομιστή παιχνιδιού σας και στέλνει περιοδικές ενημερώσεις κατάστασης έτσι ώστε η λίστα σας να δείχνει πάντα την ακριβή κατάσταση σε απευθείας σύνδεση/offline και ο παίκτης μετράει. Πώς λειτουργεί < p> Το πρόσθετο στέλνει έναν καρδιακό παλμό σε < code>https://hytalecharts.com/api/heartbeat κάθε 5 λεπτά (ή κάθε 20 δευτερόλεπτα για εξυπηρετητές premium). Κάθε καρδιακός παλμός περιλαμβάνει: < ul> < li>Το μυστικό του σέρβερ σας < strong>καρδιοπληξίας (ένα δείγμα hex 64 χαρακτήρων) < li>Τρέχων < strong>αριθμός παικτών < / strong> και < strong> μέγιστοι παίκτες < li>Μια σειρά παικτών < strong> με επιμέρους λεπτομέρειες παίκτη (όνομα χρήστη, UUID, κόσμος, ping) < li>Μεταδεδομένα σέρβις όπως < strong>όνομα σέρβις, < strong>MOTD, < up time, και < strong>χρήση μνήμης Μια λίστα με εγκατεστημένα plugins και παγκόσμια ονόματα Σταδιακά βήματα < ol> Δημιουργήστε ένα μυστικό της καρδιάς. Στη σελίδα επεξεργασίας του διακομιστή σας, πηγαίνετε στην ενότητα Heartbeat και κάντε κλικ στο "Generate Secret." Αυτό δημιουργεί ένα μοναδικό δείγμα 64 χαρακτήρων. Εγκατέστησε το πρόσθετο. Τοποθετήστε το πρόσθετο HytaleCharts στο < code>mods/ του server σας κατάλογος. Σύνδεσε το πρόσθετο. Επεξεργασία του αρχείου < code>config.json του plugin και ορισμός του μυστικού: < pre>< code> { "Αpiόρρητο: " αποσφαλμάτωση": ψευδής } Επανεκκινήστε το διακομιστή σας. Το πρόσθετο θα αρχίσει να στέλνει καρδιακούς παλμούς αμέσως. Βεβαιωθείτε για HytaleCharts. Ελέγξτε τη σελίδα επεξεργασίας του εξυπηρετητή σας: θα πρέπει να εμφανίζει την τελευταία timestamp καρδιακών παλμών και να υποδεικνύει ότι η σύνδεση είναι ενεργή. Συγκέντρωση πολλαπλών εξυπηρετητών Αν τρέχετε πολλαπλές περιπτώσεις server (λόμπι, επιβίωση, δημιουργικό) μοιράζοντας το ίδιο μυστικό του καρδιακού παλμού, το HytaleCharts αυτόματα τις συσσωρεύει. Προσδιορίζει διακριτές περιπτώσεις από τη διεύθυνση IP τους και το όνομα του διακομιστή, παίρνει το τελευταίο χτύπο της καρδιάς από κάθε, και συγχωνεύει τους παίκτες από το UUID για να αποφευχθεί η διπλή καταμέτρηση. Ο συνολικός αριθμός παικτών και οι μέγιστοι παίκτες που εμφανίζονται στην λίστα σας αντανακλούν τις συνδυασμένες τιμές σε όλες τις περιπτώσεις. Προτεραιότητα σε απευθείας σύνδεση Υτταλικό Τα διαγράμματα καθορίζουν την κατάσταση του διακομιστή σας σε απευθείας σύνδεση χρησιμοποιώντας ένα σύστημα προτεραιότητας: < ol> Εξωτερικό ερώτημα τελικό σημείο (αν ρυθμιστεί, π.χ., Nitrado ερώτημα API) Πρόσθετο Heartbeat (Ο υπηρέτης δείχνει ότι σε απευθείας σύνδεση αν ένας καρδιακός παλμός ελήφθη μέσα στα τελευταία 5 λεπτά) UDP ping (fallback server query) < p> Εάν το πρόσθετο χτύπος της καρδιάς σιωπά για περισσότερο από 5 λεπτά και δεν έχει ρυθμιστεί κανένα εξωτερικό ερώτημα, ο εξυπηρετητής επιστρέφει στην κατάσταση ping UDP. Δημόσιες μάρκες API Server Το HytaleCharts παρέχει ένα δημόσιο API που σας επιτρέπει να ανακρίνετε τα δεδομένα των ψηφοφόρων, τα στατιστικά του διακομιστή, και άλλες πληροφορίες προγραμματικά. Για να το χρησιμοποιήσετε, χρειάζεστε ένα κουπόνι API. Παίρνοντας το κουπόνι API σας < ol> < li> Πηγαίνετε στη σελίδα επεξεργασίας του εξυπηρετητή σας στο HytaleCharts Πλοηγηθείτε στην ενότητα API < li>Δημιουργήστε ένα κουπόνι API Κατάληψη και αποθηκεύστε το με ασφάλεια. Το token επικυρώνει όλα τα αιτήματα προς το δημόσιο διακομιστή API τελικά σημεία. Χρησιμοποιώντας το API < p>Συμπεριλάβετε το σημείο στην επικεφαλίδα < code>Εγγραφή των αιτημάτων API: GET /api/public/servers/{server_id}/voters Εξουσιοδότηση: Bearer Your_API_TOKEN < p> Το δημόσιο API σας επιτρέπει να πάρετε τους πρόσφατους ψηφοφόρους, τα στατιστικά του διακομιστή, και άλλα δεδομένα που μπορείτε να χρησιμοποιήσετε για να δημιουργήσετε προσαρμοσμένες ενσωματώσεις, πίνακες ηγετών, ή συστήματα ανταμοιβής στο διακομιστή σας. Για πλήρη τεκμηρίωση API και λεπτομέρειες τελικού σημείου, ελέγξτε το < a href="/server-api">Server API page στο HytaleCharts. Αντιμετώπιση προβλημάτων < πίνακα> < thead> < tr>Αύξηση Πιθανή αιτία Λύση < tbody> < tr>Discord webhook not sendInvalid webhook URL Διαγραφή και αναδημιουργία του webhook στην Discoord, κατόπιν ενημέρωση του URL στο HytaleCharts < tr>Το τεστ του εντοπιστή αποτυγχάνει με "Καμία απάντηση"Το τείχος προστασίας που εμποδίζει τη θύρα του εντοπιστή Ασφαλίστε τη θύρα του εντοπιστή (όχι τη θύρα του παιχνιδιού) είναι ανοικτό στο τείχος προστασίας σας < tr> Το τεστ του Votifier λέει "Άκυρη V2 χειραψία" Ο Server υποστηρίζει μόνο v1 αλλά επιλέξατε v2 Αλλαγή του τύπου του Votifier σε v1 και παροχή του δημόσιου κλειδιού RSA αντί για ένα σημείο < tr>Heartbeat δεν καταγράφει Λάθος μυστικό σε plugin configΔιπλός έλεγχος ότι το μυστικό σε config. Json ταιριάζει με αυτό που εμφανίζεται στο HytaleCharts ακριβώς < tr>Ο αριθμός παικτών εμφανίζει 0Η έκδοση του Plugin μεγαλύτερη από 1.5.0 Ενημέρωση του Hytale Πρόσθετο γραφημάτων στην τελευταία έκδοση, η οποία στέλνει μεμονωμένα δεδομένα παίκτη < tr>Webhook σημειώνονται ως αποτυχία 100+ διαδοχικές αποτυχίεςFix το URL του τελικού σημείου, στη συνέχεια να το δοκιμάσετε. Η επιτυχής παράδοση επαναφέρει τον μετρητή αποτυχίας. Αν βρεθείτε σε θέματα που δεν καλύπτονται εδώ, επικοινωνήστε μέσω της φόρμας επικοινωνίας στο HytaleCharts. Μπορούμε να ελέγξουμε τα αρχεία καταγραφής webhook του διακομιστή σας και το ιστορικό καρδιακών παλμών για να βοηθήσουμε στη διάγνωση προβλημάτων. Η ρύθμιση αυτών των ενοποιήσεων διαρκεί λίγα λεπτά αλλά βελτιώνει σημαντικά το πώς ο διακομιστής σας αλληλεπιδρά με τους HytaleCharts και την κοινότητά σας. Διακομιστές με ενεργές ειδοποιήσεις ψήφου και ανταμοιβές στο παιχνίδι βλέπουν με συνέπεια υψηλότερη δέσμευση και επανεπισκέψεις από τους ψηφοφόρους. < a href="/servers"> Περιήγηση σε άλλες λίστες διακομιστών για να δείτε πώς οι κορυφαίοι διακομιστές περιγράφουν τα χαρακτηριστικά ενσωμάτωσής τους, και βεβαιωθείτε ότι η δική σας λίστα αναφέρει τι έχετε δημιουργήσει.