Atrás
Hytale Query Plugin: Monitoriza el Estado de tu Servidor
PluginsPluginServidor

Hytale Query Plugin: Monitoriza el Estado de tu Servidor

2026-01-19
4 min de lectura

Para cualquier administrador de servidores Hytale, tener información fiable y en tiempo real sobre el estado de su servidor es fundamental. Ya sea para alimentar un panel de control, monitorizar la actividad o integrar servicios externos, el acceso a los datos del servidor es una necesidad. Este es exactamente el papel del plugin Hytale Query.

Este plugin expone información estructurada sobre tu servidor —desde el número de jugadores conectados hasta la lista de plugins instalados— a través de un sencillo endpoint HTTP. Es una herramienta potente, segura e indispensable para la gestión profesional de servidores.

Requisito Previo: El Plugin WebServer

Antes de nada, es crucial entender que este plugin tiene una dependencia importante: el Plugin Hytale WebServer.

El plugin Query confía en el plugin WebServer para crear y gestionar el endpoint HTTP. Por lo tanto, asegúrate de haber instalado y configurado correctamente el plugin WebServer antes de proceder con la instalación del plugin Query.

Instalación del Plugin

Instalar el plugin Query es un proceso sencillo que solo lleva unos momentos:

  1. Descarga la última versión del archivo JAR del proyecto oficial de desarrollo.
  2. Copia este archivo .jar directamente en la carpeta mods/ de tu servidor Hytale.
  3. Reinicia tu servidor.

El plugin se cargará y activará automáticamente, listo para responder peticiones.

Uso y Endpoint

Una vez instalado, el plugin es inmediatamente funcional. Registra un único endpoint para recuperar toda la información.

El Endpoint

Para consultar tu servidor, simplemente envía una petición GET a la siguiente URL:

/Nitrado/Query

Esta petición, realizada a la dirección IP y puerto de tu servidor web (configurado a través del plugin WebServer), devolverá una respuesta en formato JSON conteniendo la información del servidor.

Ejemplo de Respuesta JSON

A continuación se muestra un ejemplo de la estructura de datos que podrías recibir. Ten en cuenta que el contenido real dependerá de los permisos otorgados al usuario que realiza la petición.

{
  "Server": {
    "Name": "My Super Hytale Server",
    "Version": "2026.01.10-ab2cd69ff",
    "MaxPlayers": 100
  },
  "Universe": {
    "CurrentPlayers": 15,
    "DefaultWorld": "main_world"
  },
  "Players": [
    {
      "Name": "ExamplePlayer",
      "UUID": "e5c4ef9a-6281-406e-8a71-21028279f547",
      "World": "main_world"
    }
  ],
  "Plugins": {
    "Nitrado:WebServer": {
      "Version": "1.0.0",
      "Enabled": true,
      "State": "ENABLED"
    },
    "Nitrado:Query": {
      "Version": "1.0.0",
      "Enabled": true,
      "State": "ENABLED"
    }
  }
}

Gestión de Permisos

El verdadero poder de este plugin reside en su integración detallada con el sistema de permisos de Hytale.

Por defecto, no se expone ninguna información. Debes otorgar permisos explícitamente para que los datos sean visibles. Esto asegura que solo las personas autorizadas puedan acceder a información sensible.

La respuesta JSON se filtra dinámicamente basándose en los permisos del usuario (o grupo) que realiza la petición. Por ejemplo, si un usuario solo tiene permiso para ver la información del universo, solo aparecerá la sección "Universe" en la respuesta.

Permisos Clave

El plugin define cuatro permisos distintos, cada uno controlando el acceso a una sección específica de los datos:

PermisoSección de Datos Correspondiente
nitrado.query.web.read.serverInformación del servidor (Server)
nitrado.query.web.read.universeInformación del universo (Universe)
nitrado.query.web.read.playersLista de jugadores conectados (Players)
nitrado.query.web.read.pluginsLista de plugins instalados (Plugins)

¿Cómo Hacer Pública Cierta Información?

Un caso de uso muy común es mostrar públicamente el nombre del servidor y el número de jugadores conectados (por ejemplo, para un widget en un sitio web). Para hacer esto, simplemente asigna los permisos correspondientes al grupo ANONYMOUS en tu archivo permissions.json.

Este grupo especial se utiliza para todas las peticiones realizadas sin autenticación.

Ejemplo de configuración en permissions.json:

{
  "Groups": {
    "ANONYMOUS": [
      "nitrado.query.web.read.server",
      "nitrado.query.web.read.universe"
    ]
  }
}

Con esta configuración, cualquiera que consulte el endpoint /Nitrado/Query recibirá solo las secciones Server y Universe sin necesidad de autenticarse.

Fuente: Hytale.game