SimpleVotifier (modern voting & rewards plugin with leaderboard)

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, the [Hytale servers list](https://top-games.net/hytale)
• 🇫🇷 Plugin officiellement supporté par Top-Serveurs, [liste de serveurs Hytale](https://top-serveurs.net/hytale)
• 🔗 GitHub repository

https://github.com/Top-Serveurs/simple-votifier-hytale

• Full documentation available on Top-Games: https://top-games.net/integrations/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

1. Download the latest SimpleVotifier.jar from the GitHub releases.
2. Place the JAR file into your server’s mods/ directory.
3. Install the official WebServer plugin if it’s not already installed.
4. Start your server once to generate the default configuration files.
5. Stop the server and edit the configuration.
6. 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": "CHANGE_THIS_TO_A_SECURE_RANDOM_STRING",
  "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": false,
    "format": "html",
    "showVoteSites": true,
    "limit": 10
  },
  "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

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

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
• 📍 Top-Serveurs support (french): https://top-serveurs.net/hytale
• 📕 Top-Games documentation: https://top-games.net/integrations/simple-votifier-hytale
• 🐛 GitHub issues: https://github.com/Top-Serveurs/simple-votifier-hytale/issues