DaisyVotes — Top Voters & Leaderboards

DaisyVotes ranks your voters across four windows and can automatically reward the Top 3 each period.

Leaderboards

Players open the leaderboard with /vote top (or /votetop). Rankings are by vote count, and four scopes are available: daily, weekly, monthly, and all-time.

config.yml

stats:
  leaderboard-limit: 10
  leaderboard-cache-seconds: 60

Key	Default	Description
leaderboard-limit	10	Entries shown on /vote top and via placeholders. Range 1–100.
leaderboard-cache-seconds	60	How long results are cached before refreshing. Minimum 5.

Top Voter awards

At the end of each period, DaisyVotes can award the Top 3 voters with per-rank rewards. Daily is off by default; weekly and monthly are on.

config.yml

top-voters:
  daily:
    enabled: false
  weekly:
    enabled: true
  monthly:
    enabled: true
  sweep-minutes: 15

Key	Default	Description
daily.enabled	false	Award the daily Top 3.
weekly.enabled	true	Award the weekly Top 3.
monthly.enabled	true	Award the monthly Top 3.
sweep-minutes	15	Catch-up sweep only. Awards run at 00:05 in wheel.reset-zone; this exists so a server that was offline across that moment still pays out. Minimum 1.

Each period has rank1, rank2, and rank3 reward lists (reward-action format). The defaults:

Rank	Default reward
1st	Emerald Block trophy
2nd	8× Emeralds
3rd	4× Diamonds

Winners who are offline have their rewards queued for /vote claim.

Tip

Period windows are computed from an immutable vote history, so rollovers are accurate even across restarts. The default daily period is off to avoid over-rewarding; weekly and monthly strike a good balance.

Season votes

New in 2.8.0

Alongside the lifetime total, DaisyVotes keeps a season counter: <season_votes> in menus.yml, %daisyvotes_season_votes% (or %votes_season% in a reward’s value), and on the /vote stats menu. It behaves nothing like the daily/weekly/monthly counters above — those roll over on a schedule, but the season never rolls on its own. It only clears when an admin runs:

/daisyvotes season status
/daisyvotes season reset confirm

both gated behind daisyvotes.admin.season. status counts how many votes and players a reset would clear without touching anything; reset with no confirm argument shows the same preview instead of acting, because this is destructive and irreversible. A reset zeroes season_votes for every player who has any — lifetime totals, points, and streaks are not touched, and votes granted with /daisyvotes addvotes count toward the season the same as a real vote does.

This is for servers that run their own season, ladder, or rank-reset schedule and want a vote counter that resets with it rather than one DaisyVotes decides the timing of.

Placeholders

Build leaderboard displays with the ranked placeholders:

%daisyvotes_top_<scope>_<n>_name%
%daisyvotes_top_<scope>_<n>_votes%

• <scope> = daily · weekly · monthly · alltime
• <n> = rank number, 1–leaderboard-limit

For example, %daisyvotes_top_weekly_1_name% is this week’s top voter.

All placeholders The full PlaceholderAPI expansion.

Developer event

When a Top Voter award is paid out, DaisyVotes fires a TopVoterAwardEvent your plugin can listen for — useful for custom announcements, trophies, or analytics.

Developer API TopVoterAwardEvent with Java and Kotlin examples.