Votifier Plugin for Hytale

Modern voting plugin for Hytale servers developed by Top-Games. Automatically reward your players when they vote with a configurable tier system.

Download SimpleVotifier Source code

Hytale Compatible

HMAC-SHA256 Auth

10 languages

Built-in rewards

Requirements

Important: This setup requires a Hytale server with the WebServer plugin installed.

Working Hytale server
Java 25 or higher
WebServer plugin installed (plugin recommended by Hytale)
Access to server configuration files

SimpleVotifier Installation

Download SimpleVotifier

Download the latest version of the plugin from Modtale.

Download on Modtale

Install the plugin

Copy the SimpleVotifier.jar file into the mods/ folder of your Hytale server.

mods/SimpleVotifier.jar

Verify WebServer

Make sure the WebServer (plugin recommended by Hytale) plugin is installed and working.

Start the server

Start your Hytale server so SimpleVotifier can automatically generate its configuration.

Configure the plugin

Edit the generated configuration file according to your needs (see Configuration section).

Configuration

After the first startup, SimpleVotifier automatically creates the configuration file mods/SimpleVotifier/config.json.

Default configuration

mods/SimpleVotifier/config.json

{
  "language": "en",
  "token": "AbCdEfGh123456789XyZ0123",
  "allowedIps": [],
  "logVotes": true,
  "broadcastVotes": true,
  "rewards": {
    "enabled": false,
    "monthlyReset": true,
    "everyVoteCommands": [
      "give {player} Plant_Crop_Carrot_Item"
    ],
    "tiers": [
      {
        "votesRequired": 10,
        "commands": ["give {player} Container_Bucket"]
      },
      {
        "votesRequired": 50,
        "commands": ["give {player} Armor_Iron_Head"]
      },
      {
        "votesRequired": 100,
        "commands": ["give {player} Rock_Gem_Diamond"]
      }
    ]
  },
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true
  },
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale/my-server"
    }
  ]
}

Configuration options

Option	Type	Description
`language`	string	Language code (en, fr, es, de, it, pt, ru, uk, zh, ja)
`token`	string	Secure token for HMAC authentication (auto-generated)
`allowedIps`	array	IP whitelist (empty = allow all)
`logVotes`	boolean	Log votes to console
`broadcastVotes`	boolean	Announce votes to all players

Secure token: The token is generated automatically. Copy it to your Top-Games panel to enable the connection.

Top-Games Configuration

Get your token

SimpleVotifier automatically generates a token that you need to retrieve from the configuration file.

                                        File location:
                                        mods/SimpleVotifier/config.json
                                    

Configure in Top-Games

Go to your Top-Games panel, "Votifier" section of your Hytale server.

Enable "SimpleVotifier"
Enter your server IP
Port: by default, your server port + 3 (example: 5523)
Enter your token from config.json

Test the connection

Use the "Test" button in your Top-Games panel to verify that the communication works correctly.

Reward System (optional)

SimpleVotifier includes a built-in reward system with commands for every vote and tier rewards.

Rewards configuration

config.json (rewards section)

{
  "rewards": {
    "enabled": true,
    "monthlyReset": true,
    "everyVoteCommands": ["give {player} Plant_Crop_Carrot_Item"],
    "tiers": [
      {
        "votesRequired": 10,
        "commands": ["give {player} Container_Bucket"]
      },
      {
        "votesRequired": 50,
        "commands": ["give {player} Armor_Iron_Head"]
      },
      {
        "votesRequired": 100,
        "commands": ["give {player} Rock_Gem_Diamond"]
      }
    ]
  }
}

Available placeholder: Use {player} in your commands - it will be replaced with the player's username.

Player commands

Command	Description
`/rewards`	Claim pending vote rewards
`/vote`	List configured vote sites
`/voteinfo`	View your vote statistics and tier progress

Developer API

Third-party plugins can listen to vote events via the Hytale EventBus.

MyPlugin.java

import com.hypixel.hytale.server.core.HytaleServer;
import net.top_games.hytale.plugins.simplevotifier.VoteEvent;

public class MyPlugin extends JavaPlugin {

    @Override
    protected void setup() {
        HytaleServer.get().getEventBus()
            .listenFor(VoteEvent.class, null)
            .listen(this::onVote);
    }

    private void onVote(VoteEvent event) {
        String username = event.getUsername();
        String service = event.getServiceName();

        getLogger().atInfo().log(username + " voted on " + service);
        // Add your custom logic here
    }
}

Note: When the VoteRewards module is enabled, it automatically handles rewards. Disable it (rewards.enabled: false) if you want full control via your own rewards plugin.

Leaderboard (optional)

SimpleVotifier includes a leaderboard endpoint to display the top voters on your server.

Leaderboard configuration

config.json (leaderboard section)

{
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true
  }
}

Leaderboard options

Option	Type	Description
`enabled`	boolean	Enable/disable the leaderboard endpoint (disabled by default)
`format`	string	Default output format: "html" or "json" (html by default)
`showVoteSites`	boolean	Show/hide the vote sites section on the leaderboard

Leaderboard endpoint

GET https://your-server:port/Top-Games/SimpleVotifier/leaderboard

Troubleshooting

Verify the WebServer plugin is installed
Check server logs for error messages

Verify HMAC signature is correctly generated
Check allowedIps configuration
Review server logs for error messages

Ensure rewards.enabled is true
Check command syntax in configuration
Verify player is online or use /rewards to claim

Confirm monthlyReset is enabled
Check last_reset.txt file for last reset date
Reset triggers at first vote of new month

Information

Type: Hytale Plugin

Compatibility: Hytale Server

Java: Java 25+

Protocol: HMAC-SHA256 + HTTP

Languages: 10 languages supported

Features

Secure HMAC-SHA256 authentication
Built-in reward system
10 languages support
Vote broadcasts to all players
Monthly vote resets
Event-based API for third-party plugins
Leaderboard endpoint (HTML/JSON)

Configuration summary

Install WebServer plugin
Install SimpleVotifier
Configure config.json
Configure in Top-Games
Test the connection
Configure rewards
Configure leaderboard

Support

Need help configuring SimpleVotifier? Our team is here to assist you.

Discover Hytale servers

Explore our ranking of the best Hytale servers and join the community!

View Hytale servers