Come configurare Webhooks e notifiche per il tuo server Hytale

HytaleCharts fornisce diverse opzioni di integrazione che consentono di collegare il Elenco di server Hytale a Discord, il server di gioco e strumenti esterni. Quando un giocatore vota per il server, è possibile ricevere una notifica Discord, attivare i premi in-game tramite Votifier, accendere un webhook personalizzato per il proprio backend, e mantenere lo stato del server aggiornato con il plugin heartbeat. > Questa guida copre come impostare ogni integrazione da zero. Tutte queste funzionalità sono accessibili dalla pagina di modifica del server su HytaleCharts dopo l'accesso come proprietario del server o membro del team. Discord Vota Webhooks Discord webhooks ti permette di ricevere una notifica in un canale Discord ogni volta che qualcuno vota per, preferiti o lascia una recensione sulla tua lista server. Impostare su Webhooks discoteca > ̧strong>Crea un webhook nel tuo server Discord. Vai a Impostazioni server, quindi Integrazioni, quindi Webhooks. Fare clic su "New Webhook," dare un nome (ad esempio, "HytaleCharts Votes"), scegliere il canale e copiare l'URL di webhook. Add the webhook URL on HytaleCharts. Vai alla pagina di modifica del server, trova la sezione Discord Webhook e incolla l'URL. > Salvare le impostazioni. Hytale I grafici ora invieranno un embed formattato al tuo canale Discord ogni volta che si verifica un evento di voto, favorito o recensione. < > Che cosa ottiene Sent Ogni notifica webhook viene inviata come un Discord incorporato contenente: > * Il tipo di evento (vota, preferita, recensione) * Il nome utente del giocatore che ha eseguito l'azione Un timestamp * Il tuo nome del server e un link alla tua lista HytaleCharts < > Webhook delivery utilizza un sistema di riprovazione con 3 tentativi e uno svantaggio di 5 secondi tra i retries. Se tutti i tentativi falliscono, il fallimento viene registrato e HytaleCharts traccia fallimenti consecutivi per server. Se un URL webhook fallisce costantemente (ritorna errori HTTP o volte fuori), alla fine sarà contrassegnato in modo da poter aggiornare o correggere. Votifier: In-Game Vote Rewards Votifier è un protocollo che invia notifiche di voto direttamente al tuo server di gioco, permettendoti di premiare i giocatori in gioco quando votano su HytaleCharts. Hytale I grafici supportano tre varianti Votifier. Votifier v1 (RSA Encrypted) Il protocollo Votifier originale utilizza la crittografia RSA. Quando un voto viene lanciato, HytaleCharts crittografa un messaggio di voto con la chiave pubblica del server e lo invia tramite TCP. Per impostare Votifier v1: > Installare un plugin compatibile con Votifier sul tuo Server Hytale Generare una coppia di chiavi RSA (il plugin di solito lo fa automaticamente in prima corsa) Copia la chiave pubblica dalla configurazione del plugin * Su Hytale I grafici, vai alla pagina di modifica del server e imposta il tipo Votifier su "v1" * Immettere il server host (indirizzo IP o dominio), port (la porta di ascolto Votifier, non la porta di gioco), e incollare la chiave public Risparmiare e utilizzare il pulsante "Connessione del cliente" per verificarlo funziona < > > Il messaggio di voto segue il formato di Votifier standard: VOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n±/code>, crittografato con imbottitura PKCS#1 v1.5. Votifier v2 (HMAC-SHA256) Votifier v2 è il protocollo più moderno. Invece di crittografia RSA, utilizza la firma HMAC-SHA256 con un token condiviso. La stretta di mano include una stringa di sfida dal server per evitare attacchi di ripetizione. Per impostare Votifier v2: > Installare un v2 compatibile Votifier plugin Find the token (segreto condiviso) nel file di configurazione del plugin * Su Hytale Grafico, impostare il tipo di Votifier in "v2" * Inserisci il server host , port e token Salvare e testare la connessione < > > Il protocollo v2 si collega tramite TCP, legge un saluto handshake con un token di sfida, quindi invia un pacchetto binario contenente un payload JSON firmato con HMAC-SHA256. Il payload include il nome del servizio ("HytaleCharts"), nome utente, indirizzo IP, timestamp in millisecondi, e la stringa di sfida. < h3> Votificatore Per i plugin specifici di Hytale che utilizzano HTTP invece di TCP grezzo, HytaleCharts supporta una modalità HTTP endpoint. Questo è il protocollo più semplice da implementare per gli sviluppatori di plugin. Per impostare Votifier HTTP: > * Installare un plugin che espone un endpoint HTTP per ricevere voti * Su Hytale Grafico, impostare il tipo di Votifier su "HTTP" Inserire l'URL completo endpoint * Se il plugin richiede un token, inseriscilo nel campo token. HytaleCharts firmerà la richiesta con una firma HMAC-SHA256 nell'intestazione X-Votifier-Signature±/code>. Risparmiare e testare < > La richiesta HTTP invia un corpo JSON con serviceName , username campi. Note importanti per tutti i tipi di vocaboli > I nomi utente sono troncati a 16 caratteri per corrispondere al limite del nome utente di Hytale. HytaleCharts utilizza il nome utente Hytale del giocatore se impostato, altrimenti il loro nome utente Discord. Connessione timeout è di 5 secondi. Se il server non risponde entro 5 secondi, il tentativo è considerato fallito. < I tentativi falliti riprendono fino a 3 volte con backoff esponenziale (10s, 30s, 60s tra tentativi). * È possibile utilizzare il pulsante Test Connection su HytaleCharts per verificare la configurazione senza bisogno di un voto reale. Questo verifica che il server è raggiungibile e risponde con la stretta di mano Votifier prevista. < > Webhooks generici Se si desidera inviare notifiche di voto al proprio servizio backend, bot o applicazione, webhooks generici consentono di definire un URL personalizzato e modello di payload. Come Webhooks generici funzionano > * Nella pagina di modifica del server, passare alla sezione configurazione webhook * Inserisci il URL del tuo endpoint Configurare il modello payload Salvare le impostazioni < > Quando si verifica un evento di voto, HytaleCharts invia una richiesta HTTP POST al tuo URL con il carico di pagamento configurato. Il sistema supporta le variabili dei modelli che vengono sostituite con valori effettivi al momento dell'invio (nome utente, nome del server, timestamp, ecc.). I webhooks generici usano la stessa logica di riprovazione di Discord webhooks: 3 tentativi con backoff progressivo (10s, poi 30s tra retries). Se tutte le retries falliscono, il guasto viene tracciato contro il server e i guasti persistenti saranno contrassegnati nella dashboard.