VotingPlugin includes a powerful and flexible reward system for Minecraft servers.
Rewards can be defined directly inside configuration files or referenced from standalone YAML reward files for reuse and better organization.
Inline rewards are written directly in your configuration files — such as VoteSites.yml or SpecialRewards.yml.
This is ideal for quick setups or single-use rewards.
VoteSites:
ExampleSite:
Enabled: true
Name: 'Example Voting Site'
ServiceSite: 'example.com'
VoteURL: 'https://example.com/vote'
VoteDelay: 24
Rewards:
Items:
Diamond:
Material: 'DIAMOND'
Amount: 1
Money: 5
EXP: 100
Commands:
- 'say %player% was lucky'
💎 This configuration gives:
/say %player% was lucky⚠️ Do not mix inline reward definitions with reward file references under the same
Rewards:block.
Reward files allow you to organize rewards in separate, reusable .yml files.
Each reward file is stored in:
/plugins/VotingPlugin/Rewards/
.yml extension needed when referenced). VoteSites:
ExampleSite:
Rewards: 'MyCustomReward'
You can also combine multiple reward files:
Rewards:
- 'FirstVote'
- 'VotePartyBonus'
⚠️ Important: Example reward files provided by the plugin are for reference only.
Always create your own.ymlreward files tailored to your setup.
/plugins/VotingPlugin/Rewards/MyCustomReward.yml Items:
Diamond:
Material: 'DIAMOND'
Amount: 1
Money: 5
EXP: 100
Commands:
- 'say %player% was lucky'
Then reference it in your VoteSites.yml:
VoteSites:
ExampleSite:
Rewards:
- 'MyCustomReward'
✅ Using reward files keeps your configurations modular and reusable.
# plugins/VotingPlugin/Rewards/MyCustomReward.yml
Items:
Diamond:
Material: 'DIAMOND'
Amount: 1
Money: 5
EXP: 100
Commands:
- 'say %player% was lucky'
Rewards can be executed by a variety of events.
All reward definitions (inline or file-based) use the same syntax.
Using a reward file:
FirstVote:
Rewards: 'FirstVoteRewardFile'
Using inline rewards:
FirstVote:
Rewards:
Items:
Diamond:
Material: 'DIAMOND'
Amount: 1
VoteSites.yml)| Situation | Recommended Approach |
|---|---|
| Simple one-time reward | Inline definition |
| Reused across multiple events | Separate reward file |
| Large or complex reward logic | Reward file with Priority or SpecialChance |
| Testing or temporary reward | Inline |
| Production setup | Dedicated reward files in /Rewards/ |
🧠 Keep reward file names descriptive (e.g.,
DailyVote.yml,VotePartyBonus.yml).
Inline Rewards:
Reward Files:
/Rewards/.Triggers:
🏁 Always create your own
.ymlfiles — example files are templates only.