Back to Blog

The Real Guide to Adding Votifier to Hytale (Using HyVotifier)

EChamps
6 min read

With Hytale's Early Access launch last week (January 13), server lists are filling up fast. If you want to climb the ranks on server lists like this one, you need a Votifier bridge.

Forget the old Minecraft nuvotifier.jar. Hytale servers use a different architecture. The industry standard is currently HyVotifier (often used alongside FancyCore or Hytale Global).

This guide is based on the actual HyVotifier mod architecture available on CurseForge as of January 2026.

Choose Your Mod: HyVotifier

While there are a few options popping up, HyVotifier is currently the most robust because it uses a hybrid RSA + AES-256 encryption protocol, which is more secure than the old standard.

Installation

  1. Stop your Hytale Server
  2. Download HyVotifier.jar from CurseForge
  3. Place it in your server's mods/ directory

If you are using a Docker container or Nodecraft, this might be mapped to /hytale/server/mods.

Configuration (It's JSON, not YAML)

Start your server to generate the files, then stop it. Navigate to mods/HSL_Votifier/.

Important: Hytale mods prefer JSON over YAML. This is a key difference from Minecraft.

Open config.json and you'll see something like this:

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "give %player% Food_Wildmeat_Cooked --quantity=25",
    "give %player% Food_Candy_Cane --quantity=25"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>. <green>Enjoy your rewards!</green>"
  ],
  "RewardBroadcasts": [
    "<gray>Player <gradient:red:yellow:green:blue:purple>%player%</gradient> has voted for our server!</gray>"
  ],
  "Tokens": {
    "HytaleServerLists.org": "exampleSecret"
  }
}

Important Defaults

  • Default Port: 8192 (same as NuVotifier for Minecraft)
  • BindHost: Leave at 0.0.0.0 to use your server's public IP
  • Variable Syntax: Use %player% and %from% (not ${player})

Encryption & Keys

HyVotifier supports both V1 (RSA) and V2 (Token/HMAC) vote protocols, giving you flexibility with different server list websites.

V1 Protocol (RSA Encryption)

Most server lists use V1 protocol, which is the simplest to set up:

  1. Navigate to mods/HSL_Votifier/rsa/
  2. Find the public.key file
  3. Copy the entire contents
  4. Paste this into server list websites when adding your server

No token required for V1 protocol. The RSA public key is all you need!

V2 Protocol (Token/HMAC)

Some websites use V2 protocol and will provide you with a service name and token:

"Tokens": {
  "ServiceName": "your-token-here",
  "HytaleServerLists.org": "exampleSecret"
}

Add these to your config.json in the Tokens section.

Security Note: The mod uses a "nonce" system to prevent replay attacks. If your server clock is out of sync, votes will fail. Ensure your VPS time is correct.

Setting Up Rewards

HyVotifier makes rewarding voters incredibly easy with three types of actions in config.json.

RewardCommands

Commands that execute when a player votes. You can give items, currency, or run any server command:

"RewardCommands": [
  "give %player% Food_Wildmeat_Cooked --quantity=25",
  "give %player% Potion_Health_Greater --quantity=10",
  "currency give %player% 100"
]

RewardMessages

Private messages sent directly to the voter with color support using MiniMessage format:

"RewardMessages": [
  "<gray>Thanks for your vote on <gold>%from%</gold>. <green>Enjoy your rewards!</green>",
  "<rainbow>You received 25 items and 100 coins!</rainbow>"
]

RewardBroadcasts

Server-wide announcements when someone votes:

"RewardBroadcasts": [
  "<gray>Player <gradient:red:yellow:green:blue:purple>%player%</gradient> has voted for our server!</gray>",
  "<gold>Thank you for your support!</gold>"
]

Color Support: HyVotifier uses TaleMessage for formatting. You can use tags like <gold>, <gradient>, and even <rainbow> for colorful messages!

Advanced Features

HyVotifier includes several powerful features beyond basic vote rewards.

Vote Notifications

Enable on-screen notifications that appear when players vote. Configure in notification.json:

{
  "Enabled": true,
  "TitleMessage": "<#e2b0ff>Vote Received!</#e2b0ff>",
  "DescriptionMessage": "<gray>Thanks for your vote on <#9f44d3>%from%</#9f44d3>!</gray>",
  "IconItem": "Ingredient_Voidheart"
}

The notification appears in the bottom right of the screen with a custom item icon!

Vote Reminders

Encourage daily voting with automatic reminders. Configure in voteReminder.json:

{
  "Enabled": true,
  "SendOnJoin": true,
  "ExpireAfterHours": 24,
  "DelayInMinutes": 1,
  "Message": "<red><b>Heads Up!</b></red> <gray>You have not voted today! Do so with <green>'/vote'</green> to receive free rewards!</gray>"
}

Players who haven't voted in 24 hours will receive reminders when they join and periodically while playing.

Custom Vote GUI

Enable the /vote command to open a custom GUI where players can easily access and copy vote links:

{
  "Enabled": true,
  "OpenCustomGui": true,
  "VoteLinks": {
    "HytaleServerLists.org": "https://HytaleServerLists.org/servers/<your-server>"
  }
}

Players can click links in the GUI to open them directly in their browser!

Vote Sounds

Play custom sounds when players vote. Configure in sound.json:

{
  "Enabled": true,
  "SoundName": "SFX_Portal_Neutral_Open",
  "SoundCategory": "UI"
}

Troubleshooting

Port 8192 Not Working?

Ensure port 8192 is TCP forwarded in your firewall. Hytale game traffic is UDP (5520), but HyVotifier uses TCP on port 8192.

Common firewall commands:

# UFW (Ubuntu/Debian)
sudo ufw allow 8192/tcp

# Firewalld (CentOS/RHEL)
sudo firewall-cmd --permanent --add-port=8192/tcp
sudo firewall-cmd --reload

# iptables
sudo iptables -A INPUT -p tcp --dport 8192 -j ACCEPT

Verify your port is open using https://ping.eu/port-chk/ - enter your server IP and port 8192.

Variable Names

Important: Use %player% not ${player}. HyVotifier uses percent signs for placeholders.

Common placeholders:

  • %player% - Player username
  • %from% - Name of the server list they voted on

Votes Not Coming Through?

  1. Check server time: Use date command to verify your server clock is accurate
  2. Verify port forwarding: Use ping.eu/port-chk to check port 8192
  3. Check logs: Look in mods/HSL_Votifier/ for error messages
  4. Firewall rules: Ensure both your hosting provider and VPS firewall allow port 8192

Testing Your Setup

Use the /testvote <player> command to send a test vote and verify everything is working:

/testvote YourUsername

This will trigger all rewards, messages, and notifications as if you received a real vote.

Next Steps

Now that you have Votifier set up, make sure to:

  1. List your server on popular server lists
  2. Add voting rewards that encourage daily voting
  3. Promote voting with in-game reminders
  4. Track vote statistics to see which server lists drive the most traffic

See how other servers are implementing voting systems:

Top Voting Servers