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 * **Temporary Data Storage:** All vote codes and claimed player data are stored in a temporary `data.yml` file and **automatically cleared on every server restart**, ensuring a fresh slate for each play session. * **Secure Claiming:** Uses player UUIDs to prevent players from claiming codes generated for others. * **Customizable Rewards:** Rewards are delivered via console commands, allowing for the execution of custom items, money (`/eco`), effects, titles, and sounds. * **Admin Tools:** Includes `/mangovote reload` and `/mangovote reset` for easy configuration management during runtime. * **Vote Cooldown:** Prevents players from spamming the `/vote` command. ## 🛠️ Installation 1. **Download:** Obtain the latest `MangoVotes.jar` file from the build output (`target/` folder). 2. **Deploy:** 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 &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 | | :--- | :--- | :--- | :--- | | **`/vote`** | `/vote` | `mangovotes.vote` | Generates a unique vote code for the player. | | **`/claim`** | `/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.