Votifier Setup for Hytale Servers

Automatically reward players who vote for your server on Hytale server lists. Easy setup, secure protocol, and real-time vote notifications.

Download from CurseForge

Plugin Compatibility

Hytale-Servers.com accepts any Votifier v1 or v2 compatible plugin. However, HyVotifier (Hytale Votifier) is our preferred and recommended plugin. It has been thoroughly verified and tested to work seamlessly with our platform.

What is Votifier?

Votifier is a protocol for sending vote information from server listing websites to game servers in real-time. When a player votes for your server on sites like Hytale-Servers.com, the Votifier protocol securely transmits that vote data to your server.

Server plugins like HyVotifier implement the Votifier protocol, allowing your Hytale server to receive these vote notifications and automatically reward players in-game with items, currency, or other perks. This encourages players to vote regularly and helps your server climb the rankings.

The Votifier protocol supports both v2 (token-based) and v1 (RSA key-based) authentication methods, ensuring compatibility with modern server lists and legacy systems.

Real-Time Notifications

Instantly receive vote notifications as players vote, with no delay or polling required.

Secure Protocol

Uses encrypted tokens or RSA keys to ensure votes are legitimate and cannot be spoofed.

Easy Integration

Simple configuration and automatic compatibility with popular Hytale server lists.

Installation Guide

Download the Plugin

Download the latest version of Hytale Votifier from CurseForge. Make sure you're downloading the correct version compatible with your Hytale server.

Get from CurseForge →

Install on Your Server

Place the downloaded hytale-votifier.jar file into your server's /data/mods/ folder.

your-server/
  data/
    mods/
      hytale-votifier.jar ← place here

Restart Your Server

Restart your Hytale server to load the Votifier plugin. On first startup, Votifier will create an HSL_Votifier folder with a config.json file containing default settings and a unique token.

Configure HyVotifier

Open the generated configuration file located at /data/mods/HSL_Votifier/config.json

Key settings to configure:

BindHost: The address Votifier listens on (default: 0.0.0.0 - binds to your server's IP/URL)
BindPort: The port Votifier listens on (default: 8192) - customizable in config.json
Tokens (V2): The key must be "Hytale-Servers.com" and the token is "exampleSecret" by default

{
  "BindPort": 8192,
  "BindHost": "0.0.0.0",
  "Tokens": {
    "Hytale-Servers.com": "exampleSecret"
  }
}

Important for V2

Change "exampleSecret" to a unique token before adding it to Hytale-Servers.com. The key name "Hytale-Servers.com" must remain exactly as shown.

Configure Vote Links

After setting up your token, you'll also need to update your server's vote link in /data/mods/HSL_Votifier/voteCommand.json

{
  "Enabled": true,
  "VoteLinks": {
    "Hytale-Servers.com": "https://hytale-servers.com/server/yourServerSlug"
  }
}

Replace yourServerSlug with your actual server's URL slug from Hytale-Servers.com (e.g., https://hytale-servers.com/server/my-awesome-server)

Open Firewall Port

Ensure that the Votifier port (default 8192) is open in your server's firewall and router. This allows server lists to send vote notifications to your server.

Alternatively: If you already have another port open and unused, you can configure Votifier to use that port instead by changing the "BindPort" value in config.json. This avoids the need to open an additional port.

Important

If you're using a hosting provider, you may need to contact them to open this port or configure it in their control panel. If you change the port in config.json, make sure to update it in your server listing settings as well.

Add Credentials to Your Server Listing

Log in to Hytale-Servers.com and either create a new server listing or edit your existing server to add your Votifier credentials:

Your server's public URL or IP address and Votifier port
Select the protocol version (v2 recommended)
Paste your token (v2) or public key (v1)

Test Your Connection

After adding your credentials on your server configuration page, click the "Test Vote" button to send a test vote. This verifies that Votifier is configured correctly and can receive votes. You should see the test vote appear in your server logs if everything is working properly.

Manage Your Server

Set Up Vote Rewards

HyVotifier includes built-in reward configuration in config.json, allowing you to easily set up what players receive when they vote for your server.

For more intricate voting rewards, HyVotifier can be integrated with other plugins. When a vote is received, HyVotifier broadcasts an event that custom plugins can listen for to grant advanced rewards, items, currency, or permissions to the voting player.

Configure your basic rewards directly in the HyVotifier config.json file, or develop/install additional plugins for complex reward systems tailored to your server's needs.

Configuration Reference

Votifier v2 (Recommended)

Modern token-based authentication. More secure and easier to configure than v1. Uses a customizable token in the config.json file.

Example config.json:

{
  "BindPort": 8192,
  "BindHost": "0.0.0.0",
  "Tokens": {
    "Hytale-Servers.com": "exampleSecret"
  }
}

⚠️ Change the default token!

Replace "exampleSecret" with your own unique token before using it on Hytale-Servers.com. The key "Hytale-Servers.com" must stay exactly as shown.

✓ Token-based authentication
✓ Simpler setup
✓ Better security
✓ Host 0.0.0.0 uses your server's IP/URL

Votifier v1 (Legacy)

RSA key-based authentication. Compatible with older server lists. A public key is automatically generated on first run.

📁 Public Key Location

The public key is auto-generated at /data/mods/HSL_Votifier/rsa/public.key

This file contains just the key value without BEGIN/END markers. Copy the entire contents of this file to your server listing configuration.

✓ RSA key pair authentication
✓ Legacy compatibility
✓ Auto-generated keys
✓ No manual config.json changes needed

Troubleshooting

Votes not being received

• Verify that port 8192 (or your custom port) is open in your firewall
• Check that your server's public IP or URL is correct in the configuration
• Ensure the token/key in your server listing on the site matches your Votifier config exactly
• For V2: Verify the property name in your config.json Tokens section is exactly "Hytale-Servers.com" (case-sensitive)
• Check server logs for any Votifier error messages

Authentication failures

• Double-check that you copied the complete token/key without extra spaces
• Verify you're using the correct protocol version (v1 vs v2)
• If using v1, ensure the entire public key block is included
• Regenerate credentials if you suspect they were compromised

Connection timeout

• Confirm your server is running and Votifier is loaded
• Check if you're behind a NAT/router and configure port forwarding
• Contact your hosting provider if you can't access firewall settings
• Test locally first if possible before configuring external access

Frequently Asked Questions

Do I need Votifier to be listed on Hytale-Servers.com?

No, Votifier is completely optional. Your server can be listed and receive votes without it. However, without Votifier, you won't be able to automatically reward players who vote for your server.

Which protocol should I use - v1 or v2?

We recommend using Votifier v2 as it's more secure, easier to configure, and uses simple token-based authentication. v1 is available for compatibility with older systems.

What Votifier plugins are compatible with Hytale-Servers.com?

Hytale-Servers.com is compatible with any plugin that implements the Votifier v1 or v2 protocol. However, we specifically recommend and have verified HyVotifier (Hytale Votifier) as it's been thoroughly tested with our platform and works seamlessly with Hytale servers.

Is my token/key safe to share with server lists?

Your public key (v1) or token (v2) should only be shared with trusted server listing websites. Never post these credentials publicly. The token/key allows server lists to send vote notifications to your server, so treat it like a password.

Can I use a custom port instead of 8192?

Yes, you can configure Votifier to use any port you prefer. Just make sure to update the port number both in your Votifier config and on your server listing profile.

How do I test if Votifier is working?

After configuring Votifier on your server and adding the credentials to Hytale-Servers.com, you can use the "Test Vote" feature in your server configuration. This will send a test vote to your server to verify the connection is working properly. You should also see a Votifier message appear in your server logs confirming the vote was received.

Where can I get support for Votifier issues?

For plugin-specific issues, check the CurseForge page for documentation and support. For issues related to vote delivery on our site, please contact us.

Ready to Get Started?

Download Votifier now and start rewarding your players for voting. It takes just a few minutes to set up.

Download Votifier Manage Your Server