Cómo configurar Webhooks y notificaciones para su servidor de Hytale

√p]HytaleCharts ofrece varias opciones de integración que le permiten conectar su Listado del servidor Hytale a Discord, su servidor de juegos y herramientas externas. Cuando un jugador vota por su servidor, puede recibir una notificación de discordia, activar recompensas en el juego a través de Votifier, disparar un Webhook personalizado a su propio backend, y mantener su estado de servidor actualizado con el plugin de latidos cardíacos. Identificado Esta guía cubre cómo configurar cada integración desde cero. Todas estas características son accesibles desde la página de edición de su servidor en HytaleCharts después de iniciar sesión como propietario del servidor o miembro del equipo. No. ■p]Discord webhooks le permite recibir una notificación en un canal de disco cada vez que alguien vota por, favoritos, o deja una revisión en el listado de su servidor. *Setting Up Discord Webhooks Identificado Crear un Webhook en su servidor Discord. Vaya a Configuración de Servidor, luego Integraciones, luego Webhooks. Haga clic en "New Webhook", darle un nombre (por ejemplo, "HytaleCharts Votos"), elegir el canal, y copiar la URL webhook. Agrega la URL del Webhook en HytaleCharts. Vaya a la página de edición de su servidor, encuentre la sección Discord Webhook y pega la URL. "Seguido" Hytale Los Gráficos enviarán ahora un embed formateado a su canal de discordia cuando ocurra un evento de votación, favorito o revisión. Identificado/oltimo < > > > > Cada notificación de Webhook se envía como una embajada de disco que contiene: Identificado ■li El tipo de evento (voto, favorito, revisión) ■li El nombre de usuario del jugador que realizó la acción "Seguido" ■li Su nombre de servidor y un enlace de vuelta a su lista de HytaleCharts ■/ul contacto La entrega de los paquetes webhook utiliza un sistema de reingreso con 3 intentos y un retroceso de 5 segundos entre las entradas. Si todos los intentos fallan, el fallo está registrado y HytaleCharts registra fallos consecutivos por servidor. Si una URL de Webhook falla constantemente (retorna errores HTTP o veces fuera), eventualmente será insignia para que pueda actualizar o corregirlo. ■img src="https://cdn.hytale.com/5e7ba23b50cbcd001176c66b_66___farm.jpg" alt="A Hytale farm showing the kind of server builds that benefit from community engagement tools" loading="lazy" style="width: 100%; height: auto; border-radius: 8px; margin: 1.5rem 0;" / ■h2 título: Recompensas de voto en el juego יp]Votifier es un protocolo que envía notificaciones de voto directamente a su servidor de juegos, lo que le permite recompensar a los jugadores en el juego cuando voten en HytaleCharts. Hytale Los gráficos soportan tres variantes de Votifier. (RSA Encrypted) El protocolo Votifier original utiliza la encriptación RSA. Cuando se emite un voto, HytaleCharts encripta un mensaje de voto con la clave pública de su servidor y lo envía a través de TCP. > > > Identificado *Install a Votifier-compatible plugin en su Servidor de narración realizado/li (el plugin generalmente hace esto automáticamente en primera ejecución) ###Copy your ## ######################################################################################################################################################################################################################################################## de la configuración del plugin ■li En Hytale Gráficos, vaya a la página de edición de su servidor y establezca el tipo Votifier a "v1" ■li Ingrese el servidor "(Dirección IP o dominio), "Seguido]" (el puerto de escucha de Votifier, no el puerto de juego) y pegar la tecla "Seguridad" (seguido/fuerte") > > < > > > > > > Identificado/oltimo Identificado El mensaje de voto sigue el formato Votificador estándar: ■code instrucciones convenienteVOTE\nHytaleCharts\n{username}\n{ip_address}\n{timestamp}\n{timestamp}\nSeleccionado/código de confianza, encriptado con PKCS#1 v1.5 padding. (HMAC-SHA256) El protocolo más moderno. En lugar de encriptación RSA, utiliza la firma HMAC-SHA256 con un token compartido. El apretón de manos incluye una cadena de desafío del servidor para evitar ataques de repetición. ■p Confeccionar Votifier v2: Identificado " Install a v2-compatible plugin de votificador realizado/li יli]Encuentra el archivo de configuración del plugin seleccionado/li título ■li En Hytale Gráficos, establece el tipo de Votificador a "v2" ■li Ingrese el servidor de su servidor. > > > > > Identificado/oltimo Identificado El protocolo v2 se conecta a través de TCP, lee un saludo de apretón de manos con un token de desafío, luego envía un paquete binario que contiene una carga de pago JSON firmada con HMAC-SHA256. La carga útil incluye el nombre de servicio ("HytaleCharts"), nombre de usuario, dirección IP, timetamp en milisegundos, y la cadena de desafío. ■h3 título de voto de HTTP Para plugins específicos de Hytale que usan HTTP en lugar de TCP crudo, HytaleCharts admite un modo de punto final HTTP. Este es el protocolo más simple para implementar para desarrolladores de plugins. ■p Confeccionar Votifier HTTP: Identificado ■li Instale un plugin que exponga un punto final HTTP para recibir votos realizados/liejo ■li En Hytale Gráficos, establece el tipo de Votificador a "HTTP" > ■li Si el plugin requiere un token, ingrese en el campo token. HytaleCharts firmará la solicitud con una firma HMAC-SHA256 en la firma de la firma de la firma de código especificadoX-Votifier-Signature seleccionada/código principal. < > > > > > Identificado/oltimo La solicitud HTTP envía un cuerpo JSON con el código dador Nome seleccionado/code estrechamente, некициенииенногиениенногие / codificador de confianza, неcodificar el título de usuario, y campos. > > Notas importantes para todos los tipos de votificadores Identificado Los nombres de usuario son truncados a 16 caracteres seleccionados/fuertengilo para ajustarse al límite de nombre de usuario de Hytale. HytaleCharts utiliza el nombre de usuario Hytale del jugador si se establece, de lo contrario su nombre de usuario Discord. El tiempo de conexión es de 5 segundos. Si su servidor no responde dentro de 5 segundos, el intento se considera fracasado. Los intentos fallidos se reintentan hasta 3 veces mediante retroceso exponencial (10s, 30s, 60s entre intentos). ■li Usted puede utilizar el botón "Conexión" de "HitaleCharts" para verificar su configuración sin necesidad de un voto real. Esto comprueba que el servidor es accesible y responde con el apretón de manos votificador esperado. ■/ul contacto ▪h2 caracteres Webhooks Si desea enviar notificaciones de voto a su propio servicio de backend, bot o aplicación, webhooks genéricos le permiten definir una URL personalizada y plantilla de carga útil. ################################################################################################################################################################################################################################################################ Identificado ■li En la página de edición de su servidor, vaya a la sección de configuración de webhook ■li Introdúzcase el título de su punto de referencia: *Configurar la plantilla de la plantilla de instrucciones/fuertegmento con los datos que desea recibir ■li inteligenteGuardar sus ajustes Identificado/oltimo Cuando se produce un evento de votación, HytaleCharts envía una solicitud HTTP POST a tu URL con la carga útil configurada. El sistema admite variables de plantilla que se reemplazan con valores reales en el tiempo de envío (nombre de usuario, nombre del servidor, timetamp, etc.). ■p Confeccionado webGeneric utiliza la misma lógica de retry que Discord webhooks: 3 intentos con retroceso progresivo (10s, luego 30s entre retries). Si todos los registros fallan, el fallo se rastrea contra su servidor, y los fallos persistentes serán marcados en su panel de control. יimg src="https://cdn.hytale.com/5e7ba02d50cbcd001176c5ff_30____outlander_settlement.jpg" alt="Un asentamiento de Outlander en Hytale que muestra el tipo de servidores comunitarios que se benefician de integraciones de webhook"p loading="lazy"width fronterizo 0 100%; alto ■h2 títuloHeartbeat Plugin: Seguimiento de estado en línea Identificado El plugin HytaleCharts se ejecuta en su servidor de juegos y envía actualizaciones periódicas de estado para que su listado siempre muestre el estado exacto en línea/offline y cuenta de jugador. > > > > Identificado El plugin envía un latido de corazón a неcodificador https://hytalecharts.com/api/heartbeat seleccionado/code cada 5 minutos (o cada 20 segundos para servidores premium). Cada latido del corazón incluye: Identificado Tu servidor se ha convertido en el secreto de tu servidor: יli confíaCurrent יstrong criterioplayer count observado/strong confianza y יstrong confianzamax players obtenidos/strong contactos لелинилина нтеринитенититититениритениминиениениениениенимитениениениение, UUID, mundo, ping) Metadatos como "Nombre del servidor de confianza": "Nombre del servidor": ■li títuloUna lista de los plugins incorporados de нертринанильны y нерентеритенихиминихититите / нелилининиханининининининих. ■/ul contacto > > > > > Identificado יli consistía en escribir un secreto de latido de corazón. En la página de edición de su servidor, vaya a la sección Heartbeat y haga clic en "Generate Secret". Esto crea un token de 64 caracteres único. لенннилинанититинихинини plugin. Coloque el plugin de HytaleCharts en el servidor directorio. Configure el plugin. Editar el archivo de plugins y establecer el secreto: Identificar el código {} "secreto": "YOUR_64_CHAR_HEARTBEAT_SECRET", "debug": falso } buscado/código asignado ■/li لеленнитентринентельните servidor. El plugin comenzará a enviar los latidos cardíacos inmediatamente. нелинилинанитинириниеники. Compruebe la página de edición de su servidor; debe mostrar el último ritmo cardíaco y indicar que la conexión está activa. Identificado/oltimo ■h3 títuloMulti-Server Aggregation won/h3 Si ejecuta múltiples instancias de servidor (lobby, supervivencia, creativo) compartiendo el mismo secreto de latido cardíaco, HytaleCharts los agrega automáticamente. Identifica distintas instancias por su dirección IP y nombre del servidor, toma el último latido cardíaco de cada uno, y fusiona a los jugadores por UUID para evitar la doble contabilidad. El recuento total del jugador y los jugadores máximos mostrados en su listado reflejan los valores combinados en todas las instancias. < > > > > Identificado Los gráficos determinan el estado en línea de su servidor usando un sistema prioritario: Identificado (si está configurado, por ejemplo, API de consulta de Nitrado) "Seguido" (El servidor muestra como en línea si se recibió un latido del corazón en los últimos 5 minutos) יli indicando: Identificado/oltimo Si el plugin de latidos cardíacos se calla durante más de 5 minutos y no se configura ninguna consulta externa, el servidor vuelve al estado de ping UDP. < > > > > > √p]HytaleCharts proporciona una API pública que le permite consultar datos de votantes, estadísticas de servidor y otra información programáticamente. Para usarlo, necesita un token de API. > Obtención de su API Token Identificado ■li Vaya a la página de edición de su servidor en HytaleCharts ■li inteligenteNavigate a la sección API seleccionada/li > - ¿Qué? El token autentica todas las solicitudes al servidor público API endpoints. Identificado/oltimo > > Incluye el token en el codificador especificado Authorization seleccionado/code confiar header de sus solicitudes de API: " pre " especificado " GET /api/public/servers/{server_id}/voters Autorización: Bearer YOU_API_TOKEN Buscado/código titulado Identificado La API pública le permite buscar votantes recientes, estadísticas del servidor y otros datos que puede utilizar para construir integraciones personalizadas, tableros de contactos o sistemas de recompensa en su servidor. Para la documentación completa de la API y los detalles de endpoint, compruebe la página « href=»/server-api»ConsejoServer API nombrada/un usuario en HytaleCharts. ■h2 Confeccionamiento de trazos ■table - No. - No. Posible Causa efectuada/no especificado indicamos que ■/thead título Identificado > > > > > > > > > > > }Invalid webhook URL buscado/td tituladatd tituladoDelete and recreate the webhook in Discord, then update the URL on HytaleCharts made/td titulado La prueba de certificador no falla con "Ninguna respuesta" (no respuesta) se indica / no se indica en el puerto de votación bloqueando el puerto de Votifier (no en el puerto de juego) se abre en el firewall (no en el puerto de juego) "Invalid V2 handshake" (invalid V2 handshake) seleccionado/td instrucciones especificado]Server sólo admite v1 pero seleccionó v2 seleccionado/td instrucciones indicadatd.Cambia el tipo de votificador a v1 y proporciona la clave pública RSA en lugar de un token seleccionado/td icono seleccionado/tr contactos No se registra el secreto del secreto en el plugin config: Heartbeat no registrando el secreto del secreto en el plugin config. json coincide con el que se muestra en HytaleCharts exactamente Contador de usuario muestra 0 especificado/td fieltrado indicadotd confianzaPlugin versión más antiguo de 1.5.0 Seguido/td tituladotd instrucciones Actualizar el Hytale Complemento de gráficos a la última versión, que envía datos de jugador individuales seleccionados/td fieltro/tr título Señalamos que falló la URL del punto final y luego la prueba. La entrega exitosa reajusta el contador de fallos. Identificado/tbody ■/table Si te encuentras con problemas que no están cubiertos aquí, contacta a través de la forma "Href="/about"(contact form) / un título en HytaleCharts. Podemos comprobar los registros webhook de su servidor y la historia de latidos cardíacos para ayudar a diagnosticar problemas. ■p Confeccionar estas integraciones lleva unos minutos pero mejora significativamente cómo su servidor interactúa con HytaleCharts y su comunidad. Los servidores con notificaciones de voto activas y recompensas en el juego siempre ven un mayor compromiso y visitas de retorno de los votantes. "Href="/servidores" Busque otros listados del servidor realizados / un usuario para ver cómo los servidores principales describen sus características de integración, y asegúrese de que su propio listado menciona lo que ha establecido