New to VotingPlugin? Follow the dedicated Getting Started guides first: Standalone, Proxy Network, and First-vote Verification. This page remains a configuration reference.
Release baseline: This guide targets VotingPlugin 7.1.1, released July 23, 2026. The 7.1.1 plugin and proxy artifacts are compiled for Java 21.
Upgrading an existing server? Follow Upgrading and Rollback before replacing JARs or migrating data.
Use a compatible listener such as:
See Votifier Troubleshooting when votes are not reaching the server.
VotingPlugin must be installed on the proxy and each backend server when using VotingPlugin's proxy integration. The normal layout places VotifierPlus on the proxy, though custom routing layouts may differ.
Choose one BungeeMethod value and use it consistently across the connected servers:
PLUGINMESSAGINGREDISMQTTMYSQLSOCKETSThese names match the 7.1.1 BungeeSettings.yml defaults.
See Proxy Setups.
VotingPlugin can create vote sites automatically from received votes when AutoCreateVoteSites: true, or they can be added through /av gui, VotingPluginEditor, or VoteSites.yml. For sites with maintained presets, an operator can run /av VotePresets in game (or /av VotePresets https://your-listing.example/vote) for guided setup; see VotingPlugin Presets.
VoteSites:
MinecraftServers:
Enabled: true
ServiceSite: MinecraftServers.org
VoteURL: https://minecraftservers.org/vote/example
VoteDelay: 24h
DisplayItem:
Material: DIAMOND
Amount: 1
Rewards:
Messages:
Player: '&aThanks for voting on %ServiceSite%!'
Commands:
- 'give %player% diamond 1'
| Field | Description |
|---|---|
ServiceSite |
Must exactly match the service name sent by the vote listener |
VoteDelay |
Voting interval in hours; use VoteDelayMin for minute offsets |
VoteURL |
URL shown to players |
Rewards |
Reward section processed for the vote |
Use /av servicesites or the console output from a received vote to confirm the service name.
Once every intended site is configured and tested, set
AutoCreateVoteSites: false in Config.yml and reload VotingPlugin. This keeps
the configured sites while preventing unexpected service identifiers from
automatically creating additional entries. In release 7.1.1, temporarily
re-enable the setting and reload before creating another site through
/av gui; see Service Sites for the complete
workflow.
Rewards can be created with /av gui, directly in a vote-site or special-reward section, or in files under /plugins/VotingPlugin/Rewards/.
See Rewards and Reward Examples.
VotingPlugin.Player grants the main player commands by default. See Commands and Permissions for all nodes.
Restart the server and proxy after changing network settings.
/av vote <player> <site> or /votingpluginproxy vote <player> <site> tests VotingPlugin processing and proxy communication.Run both tests and verify service-site matching, storage, forwarding, and rewards in the logs. An administrative test alone does not prove the public vote listener is reachable.