Guía de configuración del plugin One Query
Aprende a configurar el plugin One Query para mostrar el recuento de jugadores en tiempo real, jugadores en línea e información del servidor en tu listado de Hylist.
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
¿Qué es One Query?
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- Recuento actual de jugadores y máximo de jugadores
- Lista de jugadores en línea con sus nombres y UUIDs
- Versión del servidor y MOTD
- Lista de plugins instalados
Paso 1: Instalar el plugin
Download and install either One Query or Hyvote on your Hytale server:
- Descarga el último JAR desde la página de releases de GitHub
- Coloca el archivo JAR en el directorio de plugins de tu servidor
- Reinicia tu servidor
¡No se requiere configuración adicional! El plugin funciona directamente usando el puerto de tu servidor de juego (5520).
Paso 2: Agregar puerto de consulta en Hylist
Configura tu puerto de consulta en el panel de Hylist:
- Ve a la página de edición de tu servidor en el panel de Hylist
- Desplázate hasta la sección "Puertos de consulta"
- Haz clic en "Agregar puerto de consulta"
- Ingresa el puerto 5520 (o el puerto de tu servidor si es diferente)
- Opcionalmente selecciona una etiqueta para asociar este puerto con un modo de juego
- Guarda tus cambios
Múltiples modos de juego (redes proxy)
Si ejecutas múltiples servidores backend, puedes agregar múltiples puertos de consulta - uno para cada modo de juego:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Cada servidor backend necesita su propia instancia del plugin One Query. La etiqueta ayuda a los visitantes a entender a qué modo de juego pertenece cada lista de jugadores.
Verificando tu configuración
Después de configurar todo, verifica tu instalación:
- Asegúrate de que tu servidor esté en línea con el plugin One Query ejecutándose
- Espera unos minutos para que Hylist consulte tu servidor
- Visita la página de tu servidor en Hylist
- Deberías ver el recuento de jugadores, jugadores en línea, versión e información de plugins
¡Si todo funciona, verás una insignia verde "En línea" e información de jugadores en tiempo real en la página de tu servidor!
Solución de Problemas
¿No aparecen datos en Hylist?
- Verifica que el JAR del plugin One Query esté en tu carpeta de plugins
- Revisa los logs de tu servidor por errores del plugin
- Asegúrate de que el número de puerto en Hylist coincida con el de tu servidor (predeterminado: 5520)
- Espera 5-10 minutos para que Hylist actualice los datos del servidor
¿Conteo de jugadores o información incorrecta?
- Asegúrate de que el puerto de consulta apunte al servidor correcto
- Si usas múltiples servidores, asegúrate de que cada uno tenga su propio puerto configurado
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.