HyServers Plugin: Automatic Status Updates, Vote Rewards, and One Less Thing to Configure
Key Points
- Automatic status pings every 5 minutes keep your server listing current without manual updates.
- Players pick their own vote rewards from a visual menu, and the plugin delivers them immediately (or queues them if they're offline).
- HyQuery protocol support is built in, so you can ditch your separate query plugin.
- Setup takes about two minutes: drop the file in your mods folder, paste a config snippet, restart.
We built a plugin that does what every Hytale server owner needs: keeps your listing updated, handles vote rewards instantly, and responds to player queries. All from one .jar file.
Why Another Plugin?
Most server listing sites make you run three separate things: a status updater, a query responder, and a vote listener. That's three configs to maintain, three potential points of failure, and three plugins fighting for the same ports.
The HyServers Plugin rolls everything into one package. Install it once and forget about it. Your server's player count stays accurate, votes trigger rewards instantly, and queries get answered. Simple.
Status Pings That Actually Work
Every 5 minutes, the plugin sends your current status to HyServers.gg: online players, MOTD, version info, the works. No cron jobs, no external scripts, no wondering why your listing shows 0 players when you've got a dozen people online.
The plugin authenticates every ping with HMAC-SHA256. Timestamps prevent replay attacks. It's boring security stuff that just works.
HyQuery Built In
The plugin includes a UDP responder for the HyQuery protocol. This is what players' server browsers use to fetch detailed info about your server.
If you're already running OneQuery or a similar plugin, you can remove it. The HyServers Plugin handles this automatically. One less dependency to update.
Vote Rewards Players Actually Want
Here's where it gets interesting. Instead of giving everyone the same generic reward pack, you set up multiple options on your server's edit page. Diamonds, iron gear, custom items, permission commands, whatever fits your economy.
When someone votes, they see all available rewards as colorful cards. They pick one. That choice gets sent to your server along with the vote notification, and the plugin runs the exact command you configured for that reward.
The plugin supports item gives (with quantities) and custom commands. You can reward ranks, permissions, currency, or trigger complex command chains. Format them with placeholders like {player} and the plugin substitutes the correct values.
Best part: rewards deliver instantly via TCP notification. No polling, no delay. Vote completed, command executed, player gets a styled chat message with gold-to-yellow gradient text. It feels responsive because it is.
Offline? No Problem
If someone votes while offline, the reward sits in a queue for up to 7 days. They join your server, boom, instant delivery with a notification. The queue persists across restarts.
Same system works for review rewards. Leave a rating, pick a reward, get it next time you're online.
Security Details
Every vote and review notification includes an HMAC signature generated with your server's secret key. The plugin verifies this before executing any commands. Timestamps ensure each notification can only be used once within a 5-minute window.
Nobody's spoofing vote rewards on your server. The crypto checks out or the packet gets dropped.
Setup Takes Two Minutes
Download HyServersPlugin.jar and drop it in your mods folder. Start your server. The plugin generates a config file at config/hyservers.json.
Go to your server's edit page on HyServers.gg, enable the HyServers Plugin feature, and copy the config snippet it generates. Paste that into your config file. Restart. Done.
The config includes your server's unique secret key and sets default reward commands. Tweak them if you want, or leave them as-is. Either way, you're live in under five minutes.
Messages Look Good
All plugin messages use Hytale's Message API with styled gradients. Vote broadcasts show a clickable link to your vote page in chat. Reward deliveries use colored text that matches your reward configuration.
It's not groundbreaking, but it looks polished. Players notice.
What It Doesn't Do
Fair warning: this plugin focuses on HyServers.gg integration. It doesn't handle vote streaks, vote parties, or complex reward scheduling. If you need those features, you'll want a dedicated voting plugin alongside this one.
The reward system works great for straightforward "vote once, get a thing" setups. Servers with elaborate voting economies might need custom solutions.
Try It Now
The HyServers Plugin is available for download now at hyservers.gg/hyservers-plugin. Drop it in your mods folder and see how much easier server management gets when everything talks to the same system.
Got questions? Find us on Discord or submit a support ticket. We're around.