How to Install Votifier for Hytale
Votifier is the standard protocol that connects your Hytale server to voting sites like JoinHytaleServers. When players vote for your server, Votifier delivers instant notifications so you can automatically reward them with items, currency, broadcast announcements, or trigger custom logic.
JHS-Votifier is the recommended plugin for Hytale servers, supporting both V1 (RSA) and V2 (token-based) protocols. This guide walks you through installation and configuration.
What Is Votifier?
Votifier is the standard protocol used by server listing sites to notify game servers when a player votes. Instead of votes only affecting your ranking on listing sites, Votifier delivers the vote directly to your server so you know exactly who voted and when.
With Votifier running on your Hytale server, you can execute commands when votes arrive - give items, add currency, broadcast messages, or trigger any custom logic you want. It's how server owners turn votes into meaningful player rewards and engagement.
Supported Protocols
- RecommendedVotifier V2 - Token-based authentication with HMAC-SHA256 signatures. Simpler to configure and highly secure.
- LegacyVotifier V1 - RSA-2048 encryption. Supported for existing setups but requires managing key pairs.
JoinHytaleServers supports both protocols. We recommend V2 for all new installations.
Step-by-Step Installation Guide
1Download JHS-Votifier
Download the JHS-Votifier plugin from CurseForge. The download is a single .jar file that you'll add to your server.
2Install on Your Hytale Server
- Drop the
.jarfile into your server'smods/folder - Start your server
- The plugin automatically generates configuration files
Generated config files:
config.json- Main config (vote command, links)v2_config.json- Votifier V2 settings and tokenv1_config.json- Votifier V1 RSA settingshttp_config.json- HTTP endpoint settings (optional)query_config.json- Server query settings
3Open Required Ports
Your firewall needs to allow traffic on both your game port and the Votifier port. These are separate services that require separate port rules.
| Service | Protocol | Default Port |
|---|---|---|
| Hytale Game Server | UDP / QUIC | 5520 |
| Votifier (V1 / V2) | TCP | 8192 |
Important: Opening the game port (UDP 5520) does NOT open the Votifier port. You must explicitly open TCP 8192 for vote delivery to work.
Common firewall commands:
# UFW (Ubuntu/Debian)
sudo ufw allow 8192/tcp
# iptables
sudo iptables -A INPUT -p tcp --dport 8192 -j ACCEPT
# firewalld (CentOS/RHEL)
sudo firewall-cmd --permanent --add-port=8192/tcp
sudo firewall-cmd --reloadIf you're using a game hosting provider (OVH, Nitrado, etc.), check their firewall/network settings panel to open TCP 8192.
4Configure Votifier V2 (Recommended)
Votifier V2 uses a secure token for authentication. When the plugin first starts, it generates a random token in v2_config.json.
v2_config.json
{
"enabled": true,
"port": 8192,
"token": "abc123def456ghi789jkl012mno345pqr678"
}To connect to JoinHytaleServers:
- Open
v2_config.jsonon your server - Copy the
tokenvalue (the long string) - Go to your server dashboard on JoinHytaleServers
- Select Votifier V2 and paste the token
- Save your settings
Keep your token secret. Anyone with your token can send fake votes to your server. Never share it publicly or commit it to version control.
5Configure Vote Command & Links
Edit config.json to customize the /vote command behavior and voting links shown to players.
config.json
{
"voteCommand": {
"openCustomGui": true,
"sendChatMessage": true,
"header": "&6=== Vote for Our Server ===",
"footer": "&7Thank you for supporting us!"
},
"voteLinks": [
{
"serviceName": "JoinHytaleServers",
"link": "https://joinhytaleservers.com/server/your-server-slug/vote"
}
]
}Available placeholders:
%player%- The player's username%service%- The voting service name%link%- The vote link URL
6Test Your Setup
Use the test command to verify your Votifier configuration is working correctly.
/testvote <player> [service]Example: /testvote Steve JoinHytaleServers
Test votes confirm:
- Votifier listener is running and receiving votes
- Configuration is valid and loaded correctly
- Vote events fire properly to listeners
Note: Test votes do NOT give rewards or trigger broadcasts. They only verify that the Votifier protocol is working. Real votes from JoinHytaleServers will trigger your full reward logic.
If the test fails, check: firewall settings, token match, and that Votifier is running. See the troubleshooting section below for detailed solutions.
Commands & Permissions
| Command | Permission | Description |
|---|---|---|
| /vote | None | Shows voting links to the player |
| /testvote <player> [service] | jhs.votifier.admin | Fires a test vote to verify configuration |
| /votifieradmin status | jhs.votifier.admin | Shows Votifier protocol status (V1/V2/HTTP) |
| /votifieradmin reload | jhs.votifier.admin | Reloads configuration files |
Common Problems
Votifier uses TCP port 8192 by default. This is separate from your Hytale game server port (UDP 5520). Both ports need to be open for votes to work.
The most common causes are: (1) Firewall blocking TCP port 8192, (2) Token mismatch between your server config and JoinHytaleServers dashboard, (3) The Votifier plugin not running or failing to start. Check your server console for error messages and verify your token is copied exactly.
No. The game port (UDP 5520) and Votifier port (TCP 8192) are completely separate. Opening one does not open the other. You need to explicitly open TCP 8192 for vote delivery.
Yes. Votifier V2 uses HMAC-SHA256 token-based authentication with challenge-response verification. V1 uses RSA-2048 encryption. Both protocols cryptographically prevent fake votes from being submitted to your server.
We recommend Votifier V2 for all new installations. V2 uses simpler token-based authentication that is easier to configure and just as secure. V1 (RSA) is supported for legacy setups but requires managing public/private key pairs.
The token in your v2_config.json must exactly match the token entered in your JoinHytaleServers server dashboard. Copy the token directly from the config file (generated on first startup) and paste it into the dashboard. Do not include any extra spaces or newlines.
Ready to Get Started?
Check out the full documentation for advanced configuration, add your server to JoinHytaleServers, or get help from the community.