Mango Vote

🥭 MangoVotes Plugin

Published by Modrnith Publication

MangoVotes is a streamlined, temporary-data-based Minecraft plugin designed to facilitate a local, server-side vote reward system. It securely handles vote code generation, unique player claiming, and reward execution via customizable console commands.

This plugin is ideal for servers that want to manage vote rewards internally without relying on external, complex voting services or databases.

---

✨ Key Features

* Vote Cooldown: All vote codes and claimed player data are stored in a temporary `data.yml` file and Vote Cooldown:, ensuring a fresh slate for each play session. * Vote Cooldown: Uses player UUIDs to prevent players from claiming codes generated for others. * Vote Cooldown: Rewards are delivered via console commands, allowing for the execution of custom items, money (`/eco`), effects, titles, and sounds. * Vote Cooldown: Includes `/mangovote reload` and `/mangovote reset` for easy configuration management during runtime. * Vote Cooldown: Prevents players from spamming the `/vote` command.

🛠️ Installation

1. Start/Restart: Obtain the latest `MangoVotes.jar` file from the build output (`target/` folder). 2. Start/Restart: Place the `MangoVotes.jar` file into your server's `plugins/` directory. 3. Start/Restart: Start or restart your Spigot/Paper server. The plugin will generate the `config.yml` and `data.yml` files in a new `MangoVotes` folder.

📝 Configuration (`config.yml`)

The primary configuration is handled in `plugins/MangoVotes/config.yml`.

| Setting | Description | Default Example | | :--- | :--- | :--- | | `vote-message` | The link/message displayed when a player runs `/vote`. | `&9&nhttps://YOUR-VOTING-SITE.com` | | `vote-cooldown-seconds` | Time (in seconds) a player must wait between using `/vote`. | `180` | | `messages.prefix` | The standard prefix for all plugin messages. | `&9[MangoVotes] &f` | | `rewards` | A list of console commands executed upon successful claim. | `give %player% diamond 3` |

*Note: Remember to change the dummy URL in `vote-message` to your actual voting website URL.*

🎮 Commands and Permissions

| Command | Usage | Permission | Description | | :--- | :--- | :--- | :--- | | `/mangovote` | `/vote` | `mangovotes.vote` | Generates a unique vote code for the player. | | `/mangovote` | `/claim <username> <code>` | `mangovotes.claim` | Claims the reward associated with the code. | | `/mangovote` | `/mangovote version` | `mangovotes.admin` | Shows the plugin version. | | `/mangovote` | `/mangovote stats` | `mangovotes.admin` | Shows count of online players, unclaimed codes, and players voted this session. | | `/mangovote` | `/mangovote reload` | `mangovotes.admin` | Reloads `config.yml` settings from disk without restarting the server. | | `/mangovote` | `/mangovote reset` | `mangovotes.admin` | Manually clears all active codes and player data in `data.yml`. |

💡 Developers and Contribution

This plugin was developed by OmHackz. For inquiries regarding custom development or licensing under Modrnith Publication, please contact omhackz@outlook.com.