VotingPlugin is a highly configurable Minecraft voting and rewards system for Spigot/Paper, with optional BungeeCord/Velocity proxy support.
The default resources are available in the VotingPlugin repository.
Path: /plugins/VotingPlugin/
| File / folder | Description |
|---|---|
Rewards/ |
Reward files and generated directly defined rewards |
TopVoter/ |
Previous top-voter data when enabled |
BungeeSettings.yml |
Backend proxy-network settings |
Config.yml |
Main plugin configuration |
GUI.yml |
GUI configuration |
Shop.yml |
VoteShop configuration |
ServerData.yml |
Internal vote-party and top-voter data; do not edit |
SpecialRewards.yml |
AllSites, VoteParty, milestone, cumulative, and other special rewards |
Users.db |
SQLite player data |
VoteSites.yml |
Vote-site definitions, delays, URLs, and rewards |
| File | Description |
|---|---|
bungeeconfig.yml |
Proxy-side VotingPlugin configuration |
nonvotedplayerscache.json |
Cache used with AllowUnJoined: false |
secretkey.key |
Encryption key used by SOCKETS and optional plugin-message encryption |
votecache.json |
Vote cache used by PLUGINMESSAGING |
New server administrators: Start with the dedicated Getting Started section rather than configuring everything at once.
For individual settings, the existing Setup reference and File Layout are still available. The current stable release is 7.1.1 (Java 21).
The exact path depends on whether the server is standalone or part of a proxy network, but this diagram shows a typical proxy-network lifecycle:
Standalone servers skip proxy forwarding and process the vote locally. Configuration can change where totals, vote parties, and rewards are processed.
| Command | Description |
|---|---|
/vote |
Shows vote sites and player totals |
/v |
Alias for /vote |
/adminvote |
Administration command root |
/av |
Alias for /adminvote |
VotingPlugin.Player is the main permission for player commands and is granted by default unless changed in Config.yml.
See Commands and Permissions for the full list.
VotingPlugin supports:
Users.dbRewards can include commands, messages, experience, points, items, titles, action bars, random ranges, and more. Offline rewards are normally delivered when the player next joins.
See Rewards and Reward Examples.
| Option / file | Description |
|---|---|
OnlineMode |
Controls online/offline UUID handling; see Online / Offline Mode |
VoteReminderOptions and VoteReminders |
Current configurable reminder system; see Vote Reminders |
| Top-voter settings | Monthly and weekly tracking and resets |
BungeeSettings.yml |
Backend proxy-network configuration |
SpecialRewards.yml |
AllSites, VoteParty, milestone, cumulative, and other special rewards |
VotingPlugin supports these BungeeMethod values, matching the current default configuration:
See Proxy Setups.
/adminvote test commands.Report issues on the VotingPlugin GitHub repository or ask in the support Discord.
Keep VotingPlugin and your vote-listener plugin updated for the best compatibility.