New to VotingPlugin? Start here. These guides take you from a new installation to a verified vote and reward. They are for server owners and administrators, not a guide for players using /vote.
Release baseline: These guides are checked against the latest published stable release, VotingPlugin 7.1.1 (July 23, 2026). It requires Java 21. Some features in development builds are not available in 7.1.1.
| Your server | Start here | What you will configure |
|---|---|---|
| One Paper or Spigot server, without BungeeCord or Velocity | Standalone Server Quick Start | VotingPlugin, a Votifier listener, one voting website, and a simple reward |
| Velocity or BungeeCord network with two or more backend servers | Proxy Network Quick Start | Vote listener on the proxy, VotingPlugin on proxy and backends, shared SQL storage, and vote routing |
| Already installed, but votes or rewards are not working | Verify Your First Vote | Separate internal command tests from real end-to-end vote delivery |
Follow the standalone path unless you actually run a Velocity/BungeeCord network. A single Paper server does not need MySQL or proxy settings to get started.
VotingPlugin is not the public Votifier listener. Installing VotingPlugin alone does not open a Votifier port.
Download VotingPlugin from SpigotMC or the published release. Download VotifierPlus from its project page; NuVotifier is another compatible listener. Use compatible server and proxy artifacts for your topology.
/av VotePresets (in-game), automatic site detection, or VoteSites.yml.Rewards block. Leave advanced features for later./vote, check logs, and disable AutoCreateVoteSites after all expected sites are configured.For the exact steps and copyable examples, choose Standalone or Proxy above.
Next, customize Rewards, VoteShop, Vote Reminders, and Vote Streaks. For the full option-by-option reference, use Setup, File Layout, and Commands & Permissions.
Have a problem? Start with the first-vote troubleshooting table, then Votifier Troubleshooting. Never post private keys, tokens, or database passwords.