milestones
One-shot rewards at TOTAL / MONTHLY / WEEKLY / DAILY / STREAK thresholds.
Milestones are one-shot rewards that fire the first time a player crosses a threshold on a particular counter. They're the long-term chase that keeps players coming back well after the daily reward has lost its novelty.
The milestones GUI — players can browse every tier, see their progress, and preview the reward at each step.
Quick example
milestones:
enabled: true
tiers:
- id: first-vote
counter: TOTAL
threshold: 1
message: "<#4DA6E8>Welcome aboard! Your first vote unlocks the Voter tag.</>"
rewards:
- type: command
value: "lp user %player% parent add voter"
- id: ten-votes
counter: TOTAL
threshold: 10
message: "<#38D9F0>10 votes! Here's a small thank-you.</>"
rewards:
- type: money
amount: 1000
- id: streak-7
counter: STREAK
threshold: 7
message: "<#FF9D5E>7-day streak! You're committed.</>"
rewards:
- type: item
material: DIAMOND
amount: 5
name: "<#FFD700>Streak Diamonds</>"
- id: monthly-30
counter: MONTHLY
threshold: 30
message: "<#A8D8F0>30 votes this month — top voter material.</>"
rewards:
- type: command
value: "give %player% netherite_ingot 1"Counter kinds
Each milestone tier picks one counter to watch. The plugin checks that counter on every vote and fires the milestone once when the threshold is crossed.
| Counter | What it tracks | Resets? |
|---|---|---|
TOTAL | All-time vote count for this player | Never |
MONTHLY | Votes this calendar month | First of the month |
WEEKLY | Votes this week | Monday 00:00 server-local |
DAILY | Votes today | 00:00 server-local |
STREAK | Consecutive days the player has voted at least once | If the player misses a day |
TOTAL and STREAK milestones are the most common — they're
genuinely long-term goals. MONTHLY / WEEKLY / DAILY milestones
fire repeatedly across periods (once per period, not once ever),
which makes them more like "achievements within a period."
Reference
| Key | Type | Default | Notes |
|---|---|---|---|
enabled | boolean | true | Master switch for milestones. |
tiers | list | Ordered list of milestone definitions. | |
<tier>.id | string | Internal id, must be unique. Used in the database for dedup. | |
<tier>.counter | string | One of TOTAL, MONTHLY, WEEKLY, DAILY, STREAK. | |
<tier>.threshold | int | The counter value the player must reach (or exceed). | |
<tier>.message | string | MiniMessage line sent when the milestone fires. | |
<tier>.rewards | list | The reward pool to fire — same shape as vote-rewards.yml. |
Repeating milestones
Set repeat: true on a tier to make it re-trigger every threshold
votes instead of once at exactly N. Useful for "every 100 votes get
a goodie" patterns:
- id: every-100
counter: TOTAL
threshold: 100
repeat: true
message: "<#A8D8F0>Another 100 votes! Here's another bonus.</>"
rewards:
- type: money
amount: 5000STREAK milestones with repeat: true are particularly powerful —
"every 7 days of voting straight, get a chest of loot" gives players
a recurring weekly chase that doesn't reset their progress.
Resetting a player's milestone state
Milestone state is permanent by design — it's what makes a milestone a
milestone. If you genuinely need to clear it (e.g. after a wipe), use
/voteplus reset <player>, which clears every counter and milestone
mark for that player in one command.