DownloadVotifier
Grab our open-source Votifier plugin and start getting votes from server lists. It's super easy to set up, works with all the standard protocols, and gives you full control through the API.
You know how server listing sites bring players to your server? When people vote for you, you move up in the rankings and more players find you. But here's the thing - those votes don't do much good if you can't actually do anything with them. That's where Votifier comes in. It lets your server receive those votes directly, so you can give players rewards when they vote and keep track of your voting stats.
What you get:
- Move up in the rankings and get more players finding your server
- Give players cool stuff when they vote - items, perks, whatever you want
- See who's voting and how often
- Build voting rewards right into your server's economy
Installation
It's really simple - just drop the .jar file into your server's mods/ folder and restart. When it starts up, Votifier will create a config file for you. Open it up and tweak the settings however you want.
Networking Configuration
Here's something that trips people up: your Hytale game server runs on QUIC (that's UDP port 5520 by default), but Votifier is totally separate. It uses its own TCP port to listen for vote packets. Two different things, two different ports. Make sure you understand this or you'll be scratching your head when votes don't come through.
| Service | Protocol | Default Port |
|---|---|---|
| Hytale Game Server | UDP (QUIC) | 5520 |
| Votifier | TCP | 8192 |
Firewall Configuration
You'll need both of these ports open in your firewall:
- UDP 5520 - This is for players connecting to your game server
- TCP 8192 - This is for vote packets (you can change this port if you want)
Having trouble? If votes aren't showing up, it's usually because your firewall is blocking TCP traffic on the Votifier port. Most server hosts already have these ports open, but if yours doesn't, just shoot them a message and they'll sort it out.
Grab the latest version from our GitHub. It's completely free, open-source, and we're always updating it. Once you've got it downloaded, just follow the setup steps above and you'll be good to go.
Note: We're still putting the finishing touches on the repository, so the download will be up soon!
Installation
- Drop the
.jarfile into your server'smods/folder - Start your server
- Type
/plugin load HSL:Votifierin the server console
Configuration
After loading the plugin, it will automatically create a default config.json file. Here's what it looks like:
{
"BindHost": "0.0.0.0",
"BindPort": 8192,
"DisableV1Protocol": false,
"RewardCommands": [
"gm adventure %player%"
],
"RewardMessages": [
"Thanks for your vote on %from%. Enjoy your rewards!"
],
"RewardBroadcasts": [
"Player %player% has voted for our server!"
],
"Tokens": {
"ExampleService": "exampleSecret"
}
}Tip: After making changes to config.json, you can reload the configuration without restarting your server by running /plugin reload HSL:Votifier in the server console.
Testing Your Configuration
You can test your vote configuration without waiting for an actual vote from a server list. Use the /testvote command to simulate a vote and verify that your rewards, messages, and broadcasts are working correctly.
Usage:
/testvote <player>Description:
Creates a simulated test vote for a user of your choice and sends all messages and gives rewards.
Permission:
votifier.testPlaceholders
You can use placeholders in your configuration to personalize messages and commands:
%player% - Player name
Available in: RewardCommands, RewardMessages, RewardBroadcasts
%from% - Voting service name
Available in: RewardMessages, RewardBroadcasts
Votifier V2 Protocol Tokens
The Tokens section allows you to configure secrets for the Votifier V2 Protocol. Each voting service can have its own secret token for secure authentication.
Example: If your server list uses the service name "MyServerList" with secret "mySecret123", add it like this:
"Tokens": {
"MyServerList": "mySecret123"
}RSA Keypair
The plugin automatically generates a public and private RSA keypair in the rsa/ directory. These keys are used for secure communication with voting services and prevent tampering with vote data.
Note: Share your public key (found in rsa/public.key) with server listing sites that require it for Votifier V1 protocol integration.
