Server Owners

Get Online + Players working (required)

To show Online and Players automatically, your server must install the HytaleOne Query Plugin. Hytale Universe will query your server directly using the UDP query protocol — no separate Node.js “status reporter” process needed.

One Query Plugin (CurseForge) Setup Steps

Do this

This is intentionally short. If you follow these steps exactly, it works.

1) Install the One Query Plugin
2) Confirm your listing details
  • Verify your listing IP:PORT is correct (example: play.example.com:5520).
  • Your Server ID is in your server page URL (useful for support).
  • Player counts come from the query response; you don’t need to run a separate status process.
3) Verify it’s queryable

Once the plugin is installed, your listing will automatically start showing Online and Players when the backend can query it.

  • Double-check the IP:PORT on your listing matches your real server address.
  • If your host blocks UDP, Online/Players will stay Offline until UDP is allowed.
  • Allow up to ~1 minute for the next refresh.
Optional: UDP / firewall gotchas
  • UDP blocked is the #1 issue: some hosts only open TCP by default.
  • Make sure your game port is reachable externally (commonly 5520/UDP).
  • If you run DDoS protection, ensure it supports UDP for your server port.

Votifier Integration (in-game rewards)

Set up Votifier so players receive in-game rewards when they vote for your server on Hytale Universe.

What is Votifier?

Votifier is a protocol that allows voting sites (like Hytale Universe) to send votes to your server securely. When players vote, your server receives a notification and can trigger rewards (items, money, commands, etc.).

Setup Steps

1) Open Votifier Ports (Firewall)

Your server needs to expose ports for vote reception:

  • • Port 8192/TCP - V1 Protocol (RSA)
  • • Port 8193/TCP - V2 Protocol (HMAC)

These ports must be reachable from the internet. Ask your host to open them if needed.

2) Install Votifier Plugin
3) Get Your Public Key (V1)
  • After plugin install, look for plugins/Votifier/
  • Find the file public.key
  • Copy the entire content of this file
  • You'll need this to set up voting on Hytale Universe
4) Generate V2 Token
  • Open plugins/Votifier/config.yml
  • Look for the tokens: section
  • Generate a strong random token (32+ characters)
  • Keep this token secret — never share it
5) Configure Vote Rewards
  • Edit plugins/Votifier/config.yml
  • Add reward commands under on-vote:
  • Example: - give %player% diamond 1
  • Restart the server to apply changes
6) Verify It Works
  • Check your firewall: ports 8192-8193 should be reachable
  • Test with: netstat -an | grep 8192 (Linux/Mac) or use a port checker
  • Plugin should log vote events to console
  • Ready to register with Hytale Universe!

Register Your Server with Hytale Universe

  1. Go to your server page on Hytale Universe
  2. Click the "Configure Votifier" button (or click here)
  3. Choose a protocol:
    • V1 (RSA) — Paste your public.key here
    • V2 (HMAC-SHA256) — Paste your secret token here
  4. Set your Server IP:PORT (example: your-server.com:8192)
  5. Click "Save Configuration" — Hytale Universe will now send votes to your Votifier ports

Testing Your Setup

How to test if Votifier is working

1) Check ports are open:

  • Linux/Mac: sudo lsof -i :8192
  • Windows: netstat -an | findstr 8192
  • Or use an online port checker tool

2) Check plugin is running:

  • Look at your server console for Votifier startup messages
  • Type /votifier reload in-game (if permission)

3) Simulate a vote:

  • Contact Hytale Universe support with your server ID
  • Request a test vote to verify the connection
Troubleshooting Votifier issues
Ports not opening
  • • Ask your host: "Can you open TCP ports 8192 and 8193?"
  • • Check if your firewall is blocking them locally
  • • Some hosts require port opening via control panel
Plugin not loading
  • • Check Java version (need Java 11+)
  • • Look for errors in server console/logs
  • • Try downloading latest Votifier version
Votes not received
  • • Verify public key or token is correct on Hytale Universe
  • • Check server IP:PORT is correct and reachable
  • • Ensure ports 8192-8193 are accepting connections
  • • Check server console for connection attempts
Need help?

Contact Hytale Universe support on Discord with your Server ID, and we'll help you set up Votifier. Join Discord

Troubleshooting (fast)

Offline / players missing
  • Confirm the One Query Plugin is installed and enabled.
  • Make sure your listing IP:PORT matches the real server address.
  • Ask your host to open the server port for UDP traffic.
  • Wait up to ~60 seconds for the next refresh.
Common mistakes
  • Wrong port: if your server isn’t on 5520, include the correct port in your listing.
  • DNS pointing wrong: verify your domain resolves to the right IP.
  • Private IP: listings must use a public IP or public hostname.
Online works, but Players is wrong

If your server is Online but the player count looks wrong, it usually means the server is reachable but the query data is limited.

1) Check plugin + version

Make sure the One Query Plugin is installed on the server and compatible with your server version.

2) Host filtering / UDP shaping

Some hosts rate-limit UDP or block certain packet sizes. If players stay at 0, ask your host about UDP filtering on your game port.