Everything You Need
One plugin replaces multiple tools and simplifies your server listing.
Automatic Status Pings
Your server status is reported to Minecraft Server Hub 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 Minecraft Server Hub.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 Minecraft 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 Minecraft Server HubPlugin.jar and drop it in your server's mods/ folder.
Restart Your Server
A config file will be created at mods/Minecraft Server Hub/Minecraft Server HubPlugin.json.
Configure on Minecraft Server Hub.gg
Go to your server's edit page, open the Voting section, and enable Minecraft Server Hub Plugin. Copy the config snippet.
Restart & Go Live
Paste the config, set query type to "Minecraft Server Hub Plugin", and restart. You're live!
Configuration
Full example config with all available options.
{
"ServerId": "your-server-uuid-from-minecraft-server-hub",
"ApiBaseUrl": "https://minecraftserverhub.com",
"StatusPingEnabled": true,
"HyQueryEnabled": true,
"HyQueryPort": 5520,
"ServerName": "My Server",
"ServerPort": 5520,
"MaxPlayers": 100,
"ServerMotd": "A Minecraft Server",
"ServerVersion": "1.0",
"ListenPort": 5520,
"SharedSecret": "your-shared-secret-from-minecraft-server-hub",
"VoteUrl": "https://minecraftserverhub.com/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 Minecraft Server Hub.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 Minecraft Server Hub.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.