Como mostrar el conteo de jugadores en linea en la lista de servidores de Hytale

Cuando un jugador navega por la lista de servidores de Hytale, un numero decide si hace clic en "Unirse" o sigue desplazandose: el conteo de jugadores. Un servidor que muestra 47/100 jugadores se siente vivo. Un servidor que no muestra nada — o solo "Desconectado" — se siente como un pueblo fantasma aunque este funcionando bien. HytaleCharts ofrece tres formas de mostrar el conteo de jugadores en tiempo real y el estado en linea de tu servidor de Hytale. Cada metodo tiene diferentes compromisos en precision, esfuerzo de configuracion y funcionalidades. Esta guia explica los tres para que puedas elegir el adecuado para tu configuracion. Los tres metodos de un vistazo MetodoConteo de jugadoresVelocidad de actualizacionEsfuerzo de configuracionMejor para Plugin HeartbeatConteo exacto + lista de jugadoresCada 60 segundosInstalar pluginServidores auto-alojados Consulta externaConteo exactoCada 5 minutosConfigurar una URLNitrado / hosts gestionados Ping UDPSolo en linea/desconectadoPeriodicoNinguno (automatico)Estado basico de respaldo Metodo 1: Plugin Heartbeat de HytaleCharts (Recomendado) El plugin de heartbeat es la mejor forma de mostrar tu conteo de jugadores en la lista de servidores de Hytale. Se ejecuta en tu servidor de Hytale y envia una senal de heartbeat a HytaleCharts cada 60 segundos, incluyendo el numero exacto de jugadores en linea y sus nombres de usuario. Que reporta Conteo de jugadores — el numero actual de jugadores conectados Jugadores maximos — el limite de jugadores de tu servidor Lista de jugadores — nombres de usuario individuales y UUIDs de los jugadores conectados Version del plugin — para que HytaleCharts pueda avisarte sobre actualizaciones Como funciona internamente El plugin envia una solicitud POST a /api/heartbeat cada 60 segundos La solicitud incluye la clave secreta de tu servidor (una cadena hexadecimal de 64 caracteres) HytaleCharts valida el secreto, actualiza el conteo de jugadores y el estado de tu servidor Si no se recibe un heartbeat durante 5 minutos, el servidor se marca como desconectado Los datos historicos se almacenan para analisis y graficos de conteo de jugadores Pasos de configuracion Genera un secreto de heartbeat — en HytaleCharts, ve a Editar Servidor y haz clic en "Generar Secreto de Heartbeat" en la seccion del Plugin Heartbeat Copia el secreto — solo lo veras una vez (puedes regenerarlo si lo pierdes) Instala el plugin de HytaleCharts en tu servidor de Hytale colocandolo en el directorio mods/ de tu servidor Configura el plugin — crea o edita config.json en el directorio de datos del plugin: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Reinicia tu servidor — el plugin comenzara a enviar heartbeats inmediatamente Verifica en HytaleCharts — tu servidor deberia mostrarse en linea con un conteo de jugadores en 60 segundos Soporte multi-instancia Si ejecutas multiples instancias de servidor (por ejemplo, un servidor lobby y un servidor de supervivencia), el sistema de heartbeat agrega los conteos de jugadores automaticamente. Todas las instancias que comparten la misma clave secreta tendran sus jugadores unicos fusionados y los totales sumados. Esto significa que tu entrada en la lista de servidores de Hytale muestra el total correcto en toda tu red. El sistema identifica instancias unicas por direccion IP y nombre del mundo, toma el ultimo heartbeat de cada fuente y fusiona jugadores por UUID para evitar contar dos veces a alguien conectado a multiples instancias. Actualizaciones del plugin HytaleCharts rastrea la version de tu plugin. Si hay una version mas nueva disponible, tu pagina de Editar Servidor mostrara una advertencia de "Actualizacion disponible". Mantener el plugin actualizado asegura compatibilidad con cualquier cambio en la API y te da las ultimas correcciones de errores. Metodo 2: Endpoint de consulta externa (Nitrado y hosts gestionados) No todos los operadores de servidores de Hytale tienen acceso para instalar plugins personalizados. Si usas Nitrado, un host basado en contenedores o cualquier proveedor que exponga un endpoint de consulta, el sistema de consulta externa es tu solucion. Como funciona Proporcionas a HytaleCharts una URL que devuelve el conteo de jugadores de tu servidor como JSON HytaleCharts consulta esa URL cada 5 minutos La respuesta se analiza y tu conteo de jugadores se actualiza en la lista de servidores Si el endpoint se vuelve inaccesible, el estado de tu servidor refleja el cambio en 10 minutos Formatos de respuesta soportados HytaleCharts detecta automaticamente multiples formatos JSON, por lo que funciona con la mayoria de los endpoints de consulta sin configuracion adicional: Formato Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Formato estandar { "player_count": 15, "max_players": 100 } Tambien soporta variantes camelCase (playerCount, maxPlayers) y abreviadas (online, max). Pasos de configuracion Encuentra o configura un endpoint de consulta en tu proveedor de hosting (Nitrado proporciona uno por defecto) En HytaleCharts, ve a Editar Servidor → Consulta externa Ingresa la URL completa de tu endpoint de consulta Haz clic en "Probar endpoint" para verificar que la respuesta es analizable Guarda — HytaleCharts comienza a consultar inmediatamente El metodo de consulta externa se actualiza con menos frecuencia que el plugin de heartbeat (cada 5 minutos vs. cada 60 segundos), pero no requiere modificaciones en el servidor. Metodo 3: Ping UDP (Respaldo automatico) Si no has configurado ni el plugin de heartbeat ni un endpoint de consulta externa, HytaleCharts intentara verificar el estado de tu servidor mediante ping UDP. Este es un sistema pasivo que no requiere configuracion de tu parte. Como funciona HytaleCharts envia una sonda de protocolo QUIC minima al puerto publico de tu servidor (por defecto: 5520) Si se recibe alguna respuesta, el servidor se marca como en linea Si no hay respuesta despues de varios reintentos, el servidor se marca como desconectado Limitaciones Sin conteo de jugadores — el ping UDP solo puede determinar en linea vs. desconectado, no cuantos jugadores estan conectados Sin lista de jugadores — no hay datos individuales de jugadores disponibles Temporización menos precisa — las actualizaciones de estado dependen del programa de sondeo en lugar de heartbeats en tiempo real El ping UDP es util como linea base, pero los servidores que buscan escalar en los rankings de la lista de servidores de Hytale deberian instalar el plugin de heartbeat o configurar una consulta externa para conteos precisos de jugadores. Como HytaleCharts determina el estado de tu servidor Cuando hay multiples metodos disponibles, HytaleCharts usa un sistema de prioridad para decidir en que fuente de datos confiar: Consulta externa (mayor prioridad, si esta habilitada) — en linea si la ultima consulta exitosa fue hace menos de 10 minutos Plugin Heartbeat (si esta configurado) — en linea si el ultimo heartbeat fue hace menos de 5 minutos Ping UDP (respaldo) — usa el resultado en linea/desconectado almacenado de la ultima verificacion Esto significa que si tienes tanto el plugin de heartbeat como una consulta externa configurados, la consulta externa tiene precedencia. La mayoria de los operadores usaran uno u otro, no ambos. Lo que ven los jugadores En la lista de servidores de Hytale, el estado de tu servidor aparece como una insignia de color: Insignia verde con conteo de jugadores (ej., "En linea — 47 jugadores") — cuando esta en linea y se detectan jugadores Insignia verde ("En linea") — cuando esta en linea pero sin jugadores o conteo no disponible Insignia roja ("Desconectado") — cuando no hay heartbeat, consulta o respuesta de ping reciente Los servidores con conteos de jugadores visibles atraen consistentemente mas clics. Un servidor que muestra "En linea — 23 jugadores" es mucho mas atractivo que uno que solo dice "En linea" sin conteo. Por eso el plugin de heartbeat o la consulta externa es importante para los mejores servidores de Hytale. Solucion de problemas ProblemaCausa probableSolucion El servidor muestra "Desconectado" a pesar de estar funcionandoFirewall bloqueando heartbeat o pingAsegurate de que tu servidor pueda hacer solicitudes HTTPS salientes a hytalecharts.com Conteo de jugadores atascado en 0Plugin no rastrea eventos de jugadoresVerifica que el plugin se cargo (revisa los logs del servidor) y reinicia El heartbeat se detiene despues de un tiempoEl plugin se bloqueo o fue descargadoRevisa los logs del servidor en busca de errores, reinstala el plugin si es necesario La consulta externa muestra un conteo incorrectoEl endpoint devuelve datos obsoletosVerifica la respuesta JSON directamente en un navegador El conteo multi-instancia es muy bajoLas instancias usan diferentes secretosTodas las instancias deben compartir el mismo secreto de heartbeat Advertencia "Actualizacion disponible"El plugin esta desactualizadoDescarga la ultima version del plugin desde HytaleCharts Mejores practicas Los operadores de los mejores servidores de Hytale siguen estos patrones: Usa el plugin de heartbeat siempre que sea posible — es la opcion mas precisa y receptiva Establece un conteo maximo de jugadores realista — limites inflados (ej., 999) se ven deshonestos y reducen la confianza Monitorea el estado de tu heartbeat — revisa periodicamente la pagina de Editar Servidor en busca de errores Manten el plugin actualizado — los plugins desactualizados pueden dejar de funcionar despues de cambios en la API Usa la consulta externa como respaldo — si tu plugin falla, un endpoint externo funcional mantiene tu estado preciso Asegurate de que tu dominio sea correcto — el respaldo de ping UDP usa tu dominio configurado, asi que mantenlo preciso aunque uses principalmente el heartbeat Comenzar Mostrar tu conteo de jugadores toma menos de cinco minutos con el plugin de heartbeat. Genera un secreto, instala el plugin, agrega tu secreto a la configuracion y reinicia. Tu servidor de Hytale aparecera en la lista de servidores de Hytale con un conteo de jugadores en vivo en un minuto. Para proveedores de hosting gestionado como Nitrado, la consulta externa es aun mas simple — solo pega una URL y HytaleCharts se encarga del resto. De cualquier manera, mostrar un conteo real de jugadores es una de las cosas mas faciles que puedes hacer para aumentar la visibilidad de tu servidor y atraer nuevos jugadores. Los servidores que muestran conteos activos de jugadores en la lista de servidores de Hytale superan consistentemente a los que no lo hacen.