Skip to content

Where to Set Rewards

All VotingPlugin reward locations use the same AdvancedCore reward syntax, but the location determines when the reward runs. This page targets VotingPlugin 7.1.1.

VoteSites.yml

Reward Section Trigger
Per-site reward VoteSites.<site>.Rewards A player votes on that site
Site cooldown-end reward VoteSites.<site>.CoolDownEndRewards That site's cooldown becomes available
Reward for every site vote EverySiteReward Any configured vote site is processed

Rewards can be defined inline or reference reward files.

SpecialRewards.yml

Reward Current section Trigger
First vote VoteMilestones with Total: AllTime and At: 1 Player's first recorded vote
Vote totals and repeating rewards VoteMilestones with At or Every Configured total matches
All sites today VoteMilestones with Total: ALLSITES_TODAY Player reaches the configured number of sites
Vote streak VoteStreaks Configured period/progress requirement completes
Vote party VoteParty.Rewards Shared vote-party target is reached
NameMC server like NameMCLikeReward.Rewards NameMC like is confirmed
Top voter MonthlyAwards, WeeklyAwards, or DailyAwards Matching top voter period completes

VoteMilestonesOptions.Groups controls how multiple matching milestones in one group are selected.

The old FirstVote, FirstVoteToday, AllSites, AlmostAllSites, Cumulative, MileStones, and VoteStreak sections are legacy. VotingPlugin compiles AlmostAllSites at load time as an ALLSITES_TODAY milestone that triggers at one fewer than the number of enabled vote sites (minimum 1) and is limited once per day. This compatibility mapping is in memory and does not rewrite SpecialRewards.yml.

Use VoteMilestones and VoteStreaks for new configurations; after manually converting and testing a legacy reward, remove or empty the old section to avoid running both versions.

Reward files

Reusable reward files are stored in /plugins/VotingPlugin/Rewards/ and are referenced by file name without .yml.

The copies generated by the installed plugin are the release-exact examples. AdvancedCore's master examples can change with development:

See Reward File and AdvancedPriority Rewards before copying nested examples.