🥭 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[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
/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 [email protected].