Voting Rewards Setup Guide

Learn how to set up in-game rewards for players who vote for your server on Hylist.

What is Votifier2?

Votifier2 is a protocol that allows server listing sites like Hylist to send vote notifications directly to your game server. When a player votes for your server, Hylist sends a secure message to your server, which can then reward the player automatically.

Requirements

  • A Votifier2-compatible plugin installed on your server
  • An open port for the Votifier listener (default: 8192)
  • A rewards plugin to give items/perks to voters (optional but recommended)

Step 1: Install a Votifier2 Plugin

First, you need to install a Votifier2-compatible plugin on your Hytale server. We recommend:

Download Hytale Votifier

Follow the plugin's installation instructions to add it to your server.

Step 2: Enable In-Game Rewards in Hylist

Enable in-game rewards in your Hylist dashboard to get your Votifier token.

  1. Go to your server's edit page in the Hylist dashboard
  2. Toggle "Enable in-game rewards" to ON
  3. Set the Votifier port (default: 8192)
  4. Save your changes
  5. Copy your Votifier token for the next step

Step 3: Configure the Plugin

Paste the Votifier token from Hylist into your plugin's configuration file.

Example configuration (config.json):

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "gm adventure %player%"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>!"
  ],
  "Tokens": {
    "Hylist.io": "<YOUR_TOKEN_FROM_HYLIST>"
  }
}

Optional: Vote command configuration (voteCommand.json):

{
  "Enabled": true,
  "OpenCustomGui": true,
  "SendChatMessage": true,
  "ChatMessageHeader": [
    "<gold><b>Vote for our server!</b></gold>"
  ],
  "ChatMessageTemplate": "<yellow><click:%link%>%name% (Click)</click></yellow>",
  "VoteLinks": {
    "Hylist.io": "https://hylist.io/vote/<YOUR_SERVER_SLUG>"
  }
}

Replace <YOUR_SERVER_SLUG> with your server's slug (e.g., "my-awesome-server"). You can find this in your server's URL on Hylist.

Tip: Pre-fill username for better UX

You can add ?username=PlayerName to the vote URL to automatically fill in the player's username:

https://hylist.io/vote/your-server?username=PlayerName

Note: This requires custom plugin support as most plugins don't support this by default.

Step 4: Open the Port

Make sure the Votifier port is open and accessible from the internet.

Make sure the port is open in your server's firewall. If you're using a hosting provider, you may need to configure port forwarding.

Testing Your Setup

To verify everything is working:

  1. Make sure your server is online and the Votifier plugin is running
  2. Vote for your server on Hylist and enter your in-game username
  3. Check your server console for vote notifications
  4. Verify you receive any configured rewards in-game

Security Tips

Never share your Votifier token publicly! Anyone with access to your token can send fake vote notifications to your server.

  • Keep your Votifier token private and secure
  • Regenerate your token immediately if you suspect it has been compromised
  • Only open the Votifier port to trusted IP addresses if possible

Troubleshooting

Not receiving votes?

  • Verify the port is open and accessible from the internet
  • Check that your server's IP address is correct in Hylist
  • Ensure the Votifier plugin is running (check server logs)
  • Verify the token matches exactly (no extra spaces)

Votes received but no rewards?

  • Make sure the player is online when the vote is processed
  • Check that the username is spelled correctly (case-sensitive!)
  • Verify your rewards plugin is configured correctly

Important: Username is case-sensitive

Players must enter their username exactly as it appears in-game, including correct capitalization. For example, "Player123" and "player123" are treated as different users.

Best Practices for Voting Rewards

Setting up voting rewards is just the first step. To maximize the impact on your server's ranking and player retention, follow these proven strategies that top-ranked Hytale servers use.

Choose Meaningful Rewards

Give rewards that players actually want but can't easily get otherwise. Exclusive cosmetics, bonus currency, or temporary boosters work better than common items. The goal is to make voting feel rewarding without making it mandatory for progression.

Create Vote Streaks

Consider implementing escalating rewards for consecutive daily votes. For example, voting 7 days in a row could unlock a special reward. This encourages habitual voting and dramatically increases your monthly vote count.

Announce Rewards In-Game

When a player receives a vote reward, broadcast it to the server. A message like "[Player] voted and received 500 coins!" reminds other players that voting rewards exist and encourages them to vote too.

Use Discord Reminders

Set up the Hylist Discord bot to post your server's vote link in a dedicated channel. Players who see a daily reminder are significantly more likely to vote consistently. You can also pin your vote link for easy access.

Frequently Asked Questions

What happens if my server is offline when a player votes?
The vote is still counted toward your server's ranking. However, the Votifier2 notification cannot be delivered while your server is offline, so the player won't receive their in-game reward immediately. Most Votifier2 plugins queue missed notifications and deliver them when the server comes back online, but this depends on your plugin's configuration.
Can I give different rewards to different players?
Yes, through your rewards plugin configuration. Most plugins support permission-based rewards, where players with certain ranks or groups receive different rewards. You can configure your voteCommand.json to run different commands based on player permissions or implement rank-based reward tiers.
Is Votifier2 compatible with proxy networks (BungeeCord/Velocity)?
Yes. Install the Votifier2 plugin on your proxy server (BungeeCord or Velocity) and configure it to forward vote notifications to backend servers. The vote port should be opened on the proxy machine. Most reward plugins support receiving forwarded votes from the proxy.
How do I test if voting rewards are working?
After setting up Votifier2 and enabling rewards in your Hylist dashboard, simply vote for your own server. Join your game server and check if you receive the configured reward. If the reward doesn't arrive, check your server console for Votifier2 connection logs and ensure the port is open and the token matches.
Back to My Servers