HytaleONE Query
Permite que jugadores y listas de servidores verifiquen el estado de tu servidor al instante
Piensa en él como el protocolo query de Minecraft, pero diseñado específicamente para Hytale.
¿Qué es?
Un sistema de consulta de servidores para Hytale. Permite que jugadores, listas de servidores y herramientas verifiquen el estado de tu servidor - cantidad de jugadores, nombre del servidor, MOTD y más.
Cómo funciona
Enviar Solicitud
El cliente envía un pequeño paquete de consulta
El Servidor Responde
Tu servidor responde con la información actual
Listo
Respuesta instantánea en milisegundos
Todo el intercambio toma milisegundos.
Plugin del Servidor
El plugin se ejecuta en tu servidor Hytale. Una vez instalado, tu servidor responde a las consultas automáticamente.
- Sin puertos adicionales - usa el puerto del juego
- Sin configuración requerida - funciona inmediatamente
- Opcionalmente se registra en la lista de servidores HytaleONE
Cliente Node.js
Una librería TypeScript para consultar servidores desde tus aplicaciones.
import { query } from '@hytaleone/query';
// Get server info
const server = await query('play.example.com', 5520);
console.log(server.serverName); // "My Server"
console.log(server.currentPlayers); // 42
console.log(server.maxPlayers); // 100
// Get full info including player list
const full = await query('play.example.com', 5520, { full: true });
console.log(full.players); // [{ name: "Steve", uuid: "..." }]
console.log(full.plugins); // [{ id: "HytaleOne:Query", version: "1.0.0" }]Información Disponible
Consulta Básica
query(host, port)Consulta Completa
query(host, port, { full: true })Todo de la consulta básica, más:
¿Por qué usarlo?
Para Dueños de Servidores
- Aparece en navegadores de servidores
- Permite que los jugadores verifiquen si estás en línea
- Sin complicaciones - solo instala y listo
Para Desarrolladores
- Protocolo simple - fácil de implementar en cualquier lenguaje
- Respuestas rápidas - UDP, sin sobrecarga
- Tipos TypeScript completos incluidos
Comparado con HTTP
Detalles Técnicos
| Protocolo | UDP |
| Puerto | 5520 (igual que el juego) |
| Tiempo de respuesta | < 10ms típico |
| Tamaño de solicitud | 9 bytes |
| Tamaño de respuesta | ~100-500 bytes |
El protocolo usa bytes mágicos (HYQUERY / HYREPLY) para distinguir los paquetes de consulta del tráfico del juego. Esto permite que ambos coexistan en el mismo puerto sin interferencia.
Código Abierto
Todo tiene licencia MIT y es libre de usar.