Sponsored slot auction is now open! Get exposure to 1,000+ unique daily visitors (growing every day!). Bid now →

Voting cooldown reduced! You can now vote every 12 hours instead of 24. Vote more, earn more rewards!

Status Plugin Setup Guide

Display real-time player counts, server version, and MOTD on your HytaleTop100 listing by installing a status query plugin.

What is a Status Plugin?

A status plugin allows HytaleTop100 to query your server over UDP and retrieve detailed information beyond simple online/offline status. With a status plugin installed and enabled, your server listing will show:

  • Player Counts - Display current and maximum players in real-time
  • Server Version - Show which version of Hytale your server is running
  • MOTD - Your server's message of the day, displayed on your listing

Without a status plugin, HytaleTop100 can only detect whether your server is online or offline using a basic UDP check. Installing a status plugin unlocks the full server info display.

Recommended: OneQuery Plugin

We recommend the OneQuery plugin, which implements the OneQuery V2 binary protocol over UDP. It's lightweight, secure (uses a challenge/response handshake to prevent spoofing), and purpose-built for server listing sites.

Download on CurseForge View on GitHub

Setup Guide

1

Install the Plugin

Download the OneQuery plugin from CurseForge or GitHub and install it on your server.

  1. Download the plugin JAR file from CurseForge
  2. Place it in your server's mods/ folder
  3. Restart your server to load the plugin and generate the default config
2

Configure the Plugin

The default configuration should work for most setups. The plugin listens on UDP port 5520 by default.

Default Port

The OneQuery protocol uses port 5520 by default. If your server uses a different port, you can change it in the plugin config.

Firewall

Make sure UDP port 5520 (or your custom port) is open and accessible from the internet so HytaleTop100 can query your server.

Note: If you're using a hosting provider like Nitrado, you may need to check if additional UDP ports can be opened, or if the plugin needs to be configured to use an already-open port.

3

Enable on HytaleTop100

Once the plugin is running on your server, enable it on your HytaleTop100 listing:

  1. Go to your server's Edit page on HytaleTop100
  2. In the Server Details section, check the "OneQuery V2" toggle
  3. Make sure your IP Address field includes the correct port (e.g., play.myserver.com:5520)
  4. Save your changes

Important: The IP address port on your listing must match the port your OneQuery plugin is listening on. The default is 5520.

4

Verify It's Working

After enabling OneQuery, HytaleTop100 will begin querying your server on the next ping cycle. Once working, you'll see:

  • Player counts displayed on your server card (e.g., "42/100 players")
  • Server version shown on your server page
  • Your server's MOTD displayed in the listing

Success! If your server card shows player counts, the status plugin is working correctly. If it only shows "Online" without player counts, double-check the port and firewall settings.

How It Works

Here's what happens behind the scenes when your status plugin is enabled:

Without a Status Plugin

HytaleTop100 sends a basic UDP packet to your server's port. If the port is open and responds, your server shows as Online. If not, it shows as Offline. No player counts or server info are available.

With a Status Plugin (OneQuery V2)

HytaleTop100 performs a secure challenge/response handshake with your server, then queries for detailed server info. This returns player counts, server version, MOTD, and more — all displayed on your listing in real time.

Troubleshooting

Player counts not showing

  • Verify the OneQuery plugin is loaded (check server logs for "OneQuery" on startup)
  • Make sure UDP port 5520 is open and accessible from the internet
  • Confirm the IP address and port on your HytaleTop100 listing match the plugin's listen address
  • Wait for the next ping cycle to complete

Server shows offline despite being online

  • Check that your firewall allows incoming UDP traffic on the plugin port
  • If using a hosting provider, verify the UDP port is forwarded correctly
  • Try temporarily disabling OneQuery on HytaleTop100 to see if basic UDP detection works

Incorrect player counts

  • Player counts are updated on each ping cycle
  • Make sure you're running the latest version of the OneQuery plugin
  • Check the plugin's config for any player count overrides

Need Help?

If you're having trouble setting up the status plugin, we're here to help!

Contact us with your server name and a description of the issue, and we'll assist you with the setup.

You can also report issues directly on the OneQuery GitHub repository.

← Back to Home