Setting Up Votifier: Reward Players Who Vote for Your Server

Vote rewards create a win-win: players get incentives for supporting your server, and you get increased visibility on server lists. Votifier is the standard system connecting server lists to your reward system. Here's how to set it up.

How Voting Works

Understanding the flow helps troubleshoot issues:

Player visits server list - They find your server on sites like ours
Player clicks vote - Completes any verification (CAPTCHA, etc.)
Server list sends notification - Votifier message to your server
Server receives vote - Your Votifier plugin processes it
Rewards distributed - Player gets their incentive

Each step must work for the chain to complete.

Votifier Versions

Votifier v1 (Legacy)

The original protocol:

Uses RSA public key encryption
Longer key exchange process
Still supported by many sites
Gradually being replaced

Votifier v2 (Recommended)

Modern protocol:

Token-based HMAC authentication
Simpler configuration
Better security
Preferred by most server lists

Most installations should use v2 when possible.

Installation

Step 1: Install the Plugin

Download Votifier or NuVotifier:

Get the plugin from official sources
Place in your plugins folder
Restart the server
Check for successful initialization

Step 2: Locate Configuration

After first run, find the config file:

plugins/Votifier/config.yml

Step 3: Configure Settings

Basic Configuration:

host: 0.0.0.0
port: 8192
debug: false

Port Selection:

Default is 8192
Must be unique and not used by other services
Must be accessible from the internet

Token Configuration (v2):

tokens:
  default: "your-secure-token-here"

Generate a secure token—this authenticates vote notifications.

Step 4: Port Forwarding

Votifier needs its own port forwarded:

Access your router or hosting panel
Forward the Votifier port (default 8192)
Ensure both TCP and UDP if unsure
Test accessibility from outside

Testing Your Configuration

Local Testing

Before going public, test locally:

Use Votifier test tools
Send test votes to localhost
Verify votes register correctly
Check console for errors

External Testing

Confirm external accessibility:

Find your public IP
Use online port checking tools
Verify port 8192 (or your chosen port) is open
Test from different networks if possible

Vote Site Testing

Most server lists offer test vote features:

Add your server to the list
Use the test vote button
Verify vote received on server
Check player received rewards

Setting Up Vote Rewards

Votifier only receives votes—you need a reward plugin.

Reward Plugin Options

Various plugins handle rewards:

VoteParty - Rewards for community vote milestones
GAListener - Flexible reward configurations
Custom plugins - Server-specific implementations

Reward Types

Direct Rewards:

Currency bonuses
Items given immediately
Experience points
Temporary buffs

Vote Points:

Accumulate points per vote
Spend in vote point shop
Encourages continued voting

Random Rewards:

Chance-based rewards
Vote crates or keys
Excitement through randomness

Streak Rewards:

Bonus for consecutive days
Encourages daily engagement
Progressively better rewards

Balancing Rewards

Rewards should be:

Meaningful - Worth the effort of voting
Not game-breaking - Don't trivialize progression
Consistent - Similar across vote sites
Scalable - Consider daily vote limits

Example Balance:

Per vote: Small currency amount, 1 vote point
7-day streak: Bonus item or larger currency
Monthly milestones: Exclusive cosmetics

Server List Integration

Adding to Server Lists

For each voting site:

Create an account
Add your server
Enter Votifier configuration
Test the connection

Common Configuration Fields

Most sites ask for:

Server IP/Address - Where to send votes
Votifier Port - Usually 8192
Token/Key - Your authentication credential
Protocol version - v1 or v2

Multiple Vote Sites

Players can vote on multiple sites:

Register with several lists
Reward for each vote
Track total votes across sites
Consider site-specific bonuses

Troubleshooting

Votes Not Received

Check Votifier is Running:

Review startup logs
Look for initialization messages
Verify plugin loaded correctly

Check Port Accessibility:

Test port externally
Verify firewall rules
Confirm port forwarding

Check Configuration:

Correct IP/address on vote sites
Matching port numbers
Valid token/key

Rewards Not Given

Check Reward Plugin:

Verify reward plugin is running
Check reward plugin configuration
Test reward commands manually

Check Player Recognition:

Player must be online (usually)
Username must match exactly
Check for case sensitivity issues

Intermittent Issues

Network Problems:

Hosting provider blocking ports
DDoS protection interfering
Temporary network issues

Configuration Drift:

Token changed but not updated everywhere
Port conflicts after changes
Firewall rule changes

Security Considerations

Token Security

Use strong, unique tokens
Don't share tokens publicly
Rotate tokens periodically
Use different tokens for different services if needed

Port Security

Only expose the Votifier port
Consider firewall rules limiting sources
Monitor for unusual traffic

Validation

Verify vote sources when possible
Rate limit vote processing
Log votes for analysis

Advanced Configurations

Multiple Servers

For server networks:

Proxy vote forwarding
Central vote database
Cross-server rewards

Custom Vote Handling

For unique implementations:

Vote event listeners
Custom reward logic
Integration with existing systems

Analytics Integration

Track voting patterns:

Votes per site over time
Player voting frequency
Reward distribution data

Maximizing Vote Engagement

Make Voting Easy

Clear instructions on how to vote
List all voting sites
Reminders for players
Vote links in welcome messages

Reward Visibility

Announce when players vote
Display top voters
Celebrate voting milestones
Show reward possibilities

Community Goals

Server-wide vote targets
Community rewards for milestones
Voting competitions

Common Questions

Do players need to be online? Depends on configuration. Some systems queue rewards; others require presence.

How often can players vote? Usually every 12-24 hours per site. Check each site's rules.

Can votes be faked? With proper Votifier setup and authentication, no. The token system prevents unauthorized votes.

What if a player doesn't receive rewards? Check logs, verify username matching, and ensure reward plugin is functioning.

Integration with Our Site

To set up Votifier with Hytale Top Servers:

Install and configure Votifier on your server
Go to your server's dashboard settings
Enable Votifier integration
Enter your server's address and Votifier port
Enter your v2 token
Use the test button to verify connection
Save your settings

Our system will then send vote notifications when players vote for your server.

Summary

Votifier integration:

Install Votifier plugin
Configure port and token
Forward the Votifier port
Set up reward distribution
Register with server lists
Test everything
Monitor and maintain

A working vote system rewards loyal players while boosting your server's visibility. Take time to set it up correctly—it pays dividends through increased engagement and exposure.