SimpleVotifier (modern voting & rewards plugin with leaderboard)

Bymetrakit
Mods

SimpleVotifier is a modern and flexible voting plugin compatible with any vote site. Fully configurable and extensible, it makes rewarding players and managing leaderboards simple, fast, and effortless.

Description

SimpleVotifier – Modern Voting Plugin (Votifier) for Hytale

SimpleVotifier is a modern, lightweight, and powerful voting plugin designed specifically for Hytale servers. It allows any voting website to securely notify your server when a player votes, instantly rewarding players and driving engagement through configurable rewards and real-time leaderboards.

Built with simplicity and flexibility in mind, SimpleVotifier is fully configurable, highly extensible, and extremely easy to set up — even for beginners. Whether you want a simple vote notification system or a complete reward and leaderboard solution, SimpleVotifier adapts perfectly to your server needs.

🌐 Official Top-Games Support

SimpleVotifier is officially supported by Top-Games, ensuring maximum compatibility and reliability with the platform.

🛠️ Support available on Top-Games
https://top-games.net/hytale
⭐ Officially supported plugin by Top-Games
🔗 GitHub repository
https://github.com/Top-Serveurs/simple-votifier-hytale
Full documentation available on Top-Games: https://top-games.net/integrations/simple-votifier-hytale or github: https://github.com/Top-Serveurs/simple-votifier-hytale

✨ Key Features

✅ Compatible with any voting website
🔐 Secure vote handling via HTTP with HMAC authentication
🎁 Built-in and fully configurable reward system
📊 Real-time leaderboards (HTML or JSON)
🌍 Multi-language support
🔌 Event-based API for custom extensions
⚡ Lightweight, fast, and production-ready

🔧 Dependency & Network Design

SimpleVotifier relies on the official Hytale WebServer plugin:

🔗 https://github.com/nitrado/hytale-plugin-webserver

Why this matters

Uses the HTTP protocol
Runs on the same port as the WebServer plugin
🚫 No additional port required
Ideal for shared hosting and simple server setups

This design makes SimpleVotifier extremely easy to deploy and avoids complex firewall or network configuration.

📦 Installation

Download the latest SimpleVotifier.jar from the GitHub releases.
Place the JAR file into your server’s mods/ directory.
Install the official WebServer plugin if it’s not already installed.
Start your server once to generate the default configuration files.
Stop the server and edit the configuration.
Restart the server — your voting system is ready!

⚙️ Configuration

After the first launch, a configuration file will be created at:

mods/SimpleVotifier/config.json

Basic Configuration Example

{
  "language": "en",
  "token": "YOUR_SECURE_TOKEN",
  "broadcastVotes": true,
  "logVotes": true,
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale/my-server"
    },
    ... any other servers list
  ]
}

Advanced Configuration Example

{
  "language": "en",
  "token": "YOUR_SECURE_TOKEN",
  "allowedIps": [],
  "logVotes": true,
  "broadcastVotes": true,
  "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"
        ]
      }
    ]
  },
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true,
    "limit": 100
  },
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale"
    },
    {
      "service": "Top-Serveurs",
      "url": "https://top-serveurs.net/hytale"
    }
  ]
}

Main Configuration Options

🌍 Language: Select the plugin language
🔑 Token: Secure token used for HMAC vote authentication (auto-generated)
📢 Broadcast votes: Announce votes to all online players
🧾 Log votes: Log incoming votes in the console
🔗 Vote sites: Add unlimited voting platforms

Everything is designed to be simple, readable, and easy to customize.

Configuration Options

Main Settings

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
voteSites (array): List of vote sites with service (name) and url (link)

Reward System

rewards.enabled (boolean): Enable/disable reward system
rewards.monthlyReset (boolean): Reset vote counts on the 1st of each month
rewards.everyVoteCommands (array): Commands executed on every vote
rewards.tiers (array): Vote milestone rewards

Leaderboard

leaderboard.enabled (boolean): Enable/disable leaderboard endpoint (default: false)
leaderboard.format (string): Output format for leaderboard - html or json (default: html)
leaderboard.showVoteSites (boolean): Show/hide vote sites section on leaderboard (default: true)
leaderboard.limit (int): Maximum number of voters to display (default: 10, max: 10000)

Placeholders:

{player} - Replaced with the voter's username

🎮 Player Commands

`/rewards`

Claim pending vote rewards.

Usage: /rewards

Output:

Displays number of rewards claimed
Executes all pending reward commands

`/vote`

List available vote sites configured in config.

Usage: /vote

Output:

Displays all configured vote sites with their URLs

`/voteinfo`

View your vote statistics and tier progress.

Usage: /voteinfo

Output:

Total vote count
Pending rewards count
Tier progress with status (reached/not reached)

🌍 Supported Languages

Code	Language	Code	Language
`en`	English	`pt`	Portuguese
`fr`	French	`ru`	Russian
`es`	Spanish	`uk`	Ukrainian
`de`	German	`zh`	Chinese
`it`	Italian	`ja`	Japanese

Change the language setting in config.json to switch languages.

🎁 Reward System (Optional)

Enable the built-in reward system to automatically reward players for voting:

Execute commands on every vote
Create vote tiers (10 votes, 50 votes, 100 votes, etc.)
Supports offline players with pending rewards
Optional monthly reset for competitive servers

The reward system can be fully disabled if you prefer handling rewards through your own plugin using the event API.

🏆 Leaderboards

This Votifier plugin includes an HTTP leaderboard endpoint:

📄 HTML or JSON output
🎨 Customizable HTML template
📈 Supports large leaderboards
🌐 Perfect for website integration

demo

Leaderboards help motivate players and increase recurring votes.

💡 Why Choose SimpleVotifier?

⚡ Extremely easy to install and configure
🔧 Fully configurable and extensible
🌐 Works with any vote site
🔒 Secure by design
🧩 Officially supported by Top-Games, a 10+ years experienced game servers list

SimpleVotifier is the perfect solution for server owners who want a simple, reliable, and modern voting system without unnecessary complexity.

💬 Support

Need help or have questions?

📍 Top-Games support: https://top-games.net/hytale
🐛 GitHub issues: https://github.com/Top-Serveurs/simple-votifier-hytale/issues