🥭 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.ymlfile 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 reloadand/mangovote resetfor easy configuration management during runtime. - Vote Cooldown: Prevents players from spamming the
/votecommand.
🛠️ Installation
- Download: Obtain the latest
MangoVotes.jarfile from the build output (target/folder). - Deploy: Place the
MangoVotes.jarfile into your server'splugins/directory. - Start/Restart: Start or restart your Spigot/Paper server. The plugin will generate the
config.ymlanddata.ymlfiles in a newMangoVotesfolder.
📝 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 omhackz@outlook.com.
