Everything You Need
One plugin replaces multiple tools and simplifies your server listing.
Automatic Status Pings
Your server status is reported to HyServers every 5 minutes via HTTP. Plus, built-in HyQuery responder replaces standalone query plugins entirely.
- Replaces HyQuery & OneQuery plugins
- HTTP pings + HyQuery UDP responder
- HMAC-SHA256 authenticated
Vote & Review Rewards
Players vote on HyServers.gg and your server gets notified instantly via secure TCP. Execute reward commands automatically.
- Instant TCP notifications
- Offline reward queue (7 days)
- Server-wide vote broadcasts
- /vote command with clickable link
Choose Your Rewards
Let players pick their reward when voting. Configure reward options from the website or in the plugin config.
- Item rewards with quantity
- Custom commands (ranks, kits, currency)
- Colorful reward cards on vote page
- Two config modes: website or plugin
Multi-Server Networks
Works with Numdrassl, Lineage, and other Hytale proxy solutions. Install on your hub server and votes forward to all backends.
- Automatic vote forwarding
- Per-backend reward execution
- Shared secret authentication
Vote Leaderboards
Track monthly and all-time top voters. Server owners can see top voters from their dashboard.
- Monthly and all-time tracking
- Dashboard sidebar card
- Future: /vote top in-game command
Secure by Default
All communication is authenticated using HMAC-SHA256 with a shared secret. No API tokens to manage or rotate.
- HMAC-SHA256 signatures
- Timestamp replay protection
- No plaintext credentials
See It in Action
Configure rewards from your dashboard and players choose them when voting.
Configure reward items and custom commands from your server dashboard
Players choose their reward when casting a vote
Quick Start
Get up and running in under 5 minutes.
Download the Plugin
Download HyServersPlugin.jar and drop it in your server's mods/ folder.
Restart Your Server
A config file will be created at mods/HyServers/HyServersPlugin.json.
Configure on HyServers.gg
Go to your server's edit page, open the Voting section, and enable HyServers Plugin. Copy the config snippet.
Restart & Go Live
Paste the config, set query type to "HyServers Plugin", and restart. You're live!
Configuration
Full example config with all available options.
{
"ServerId": "your-server-uuid-from-hyservers-gg",
"ApiBaseUrl": "https://hyservers.gg",
"StatusPingEnabled": true,
"HyQueryEnabled": true,
"HyQueryPort": 5520,
"ServerName": "My Server",
"ServerPort": 5520,
"MaxPlayers": 100,
"ServerMotd": "A Hytale Server",
"ServerVersion": "1.0",
"ListenPort": 5520,
"SharedSecret": "your-shared-secret-from-hyservers-gg",
"VoteUrl": "https://hyservers.gg/servers/your-server/vote",
"VoteCommands": [
"give {player} Rock_Gem_Diamond 5",
"msg {player} Thanks for voting!"
],
"ReviewCommands": [
"give {player} Rock_Gem_Emerald 10"
],
"BroadcastVotes": true,
"BroadcastMessage": "{player} just voted! Use /vote to support the server!"
}ServerId — Your server's UUID from HyServers.gg (found on your edit page).
SharedSecret — Generated on your server's edit page. Must match both sides.
HyQueryEnabled — Enables the built-in HyQuery UDP responder (replaces standalone HyQuery plugin).
StatusPingEnabled — Sends server status to HyServers.gg every 5 minutes via HTTP.
VoteCommands — Commands executed when a player votes. {player} is replaced.
VoteBroadcast — Message broadcast to all players when someone votes.