One Query Plugin Setup Guide
Learn how to set up the One Query plugin to display real-time player counts, online players, and server info on your Hylist listing.
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.
What is 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:
- Current player count and max players
- List of online players with their names and UUIDs
- Server version and MOTD
- Installed plugins list
Step 1: Install the Plugin
Download and install either One Query or Hyvote on your Hytale server:
- Download the latest JAR from the GitHub releases page
- Place the JAR file in your server's plugins directory
- Restart your server
No additional configuration is required! The plugin works out of the box using your game server's port (5520).
Step 2: Add Query Port in Hylist
Configure your query port in the Hylist dashboard:
- Go to your server's edit page in the Hylist dashboard
- Scroll down to the "Query Ports" section
- Click "Add Query Port"
- Enter port 5520 (or your game server's port if different)
- Optionally select a tag to associate this port with a game mode
- Save your changes
Multiple Game Modes (Proxy Networks)
If you run multiple backend servers, you can add multiple query ports - one for each game mode:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Each backend server needs its own One Query plugin instance. The tag helps visitors understand which game mode each player list belongs to.
Verifying Your Setup
After configuring everything, verify your setup:
- Make sure your server is online with the One Query plugin running
- Wait a few minutes for Hylist to query your server
- Visit your server's page on Hylist
- You should see player count, online players, version, and plugin information
If everything is working, you'll see a green "Online" badge and real-time player information on your server page!
Troubleshooting
No data showing on Hylist?
- Verify the One Query plugin JAR is in your plugins folder
- Check your server logs for any plugin errors
- Ensure the port number in Hylist matches your server port (default: 5520)
- Wait 5-10 minutes for Hylist to refresh server data
Wrong player count or info?
- Make sure the query port is pointing to the correct server
- If using multiple servers, ensure each has its own port configured
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.