setup

Setup VotingPlugin

1. Install a vote listener

Use a compatible listener such as:

• VotifierPlus
• NuVotifier

See Votifier Troubleshooting when votes are not reaching the server.

2. Configure a proxy network when applicable

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:

• PLUGINMESSAGING
• REDIS
• MQTT
• MYSQL
• SOCKETS

These names match the current BungeeSettings.yml defaults in the VotingPlugin source.

See Proxy Setups.

3. Configure vote sites

VotingPlugin can create vote sites automatically from received votes when AutoCreateVoteSites: true, or they can be added through /av gui, VotingPluginEditor, or VoteSites.yml.

VoteSites:
  MinecraftServers:
    Enabled: true
    ServiceSite: MinecraftServers.org
    VoteURL: https://minecraftservers.org/vote/example
    VoteDelay: 24
    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.

4. Configure rewards

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.

5. Permissions

VotingPlugin.Player grants the main player commands by default. See Commands and Permissions for all nodes.

6. Restart and test

Restart the server and proxy after changing network settings. Then send a real or administrative test vote and verify the service site, storage, forwarding, and rewards in the logs.

AI disclosure: This documentation update was written with assistance from ChatGPT.