DaisyVotes — Rewards

rewards.yml defines everything DaisyVotes can give a player. The defaults are vanilla-safe (diamonds, emeralds, XP, messages), so they work on any server with no extra plugins. Add Command rewards to hook your economy, crates, or ranks.

Tip

After editing rewards, run /daisyvotes reload, then /daisyvotes doctor — the doctor validates every reward action and warns about command rewards that reference plugins you may not have installed.

Anatomy of a reward

Most reward lists are made of reward actions. A single action looks like this:

- type: Item                 # Command | Item | Message | StreakFreeze
  value: "diamond"           # what runs: a command line, material, message, or "streak_freeze"
  chance: 1.0                # 0.0–1.0 probability (default 1.0 = guaranteed)
  broadcast: null            # optional server announcement when this action fires
  display-name: "1x Diamond" # label in GUIs
  summary:                   # extra lore lines in GUIs
    - "A guaranteed vanilla item reward."
  item:                      # for Item rewards: the actual item given
    material: "diamond"
    amount: 1
  preview-item:              # how the reward looks in a preview GUI
    material: "diamond"
    name: "<#BDE0FE>1x Diamond"

Field	Default	Description
type	Command	The action type — see below.
value	""	The command line, material id, message text, or streak_freeze.
chance	1.0	Probability the action fires, 0.0–1.0. Use for rare drops.
broadcast	(none)	Optional message broadcast to the whole server when the action fires.
item	(none)	For Item actions, the item given to the player.
display-name	(none)	Friendly name in GUIs.
summary	(empty)	Extra description lines in GUIs.
preview-item	(none)	The icon shown in reward-preview GUIs.

Reward types

Item

Gives an item to the player’s inventory.

- type: Item
  value: "diamond"
  item:
    material: "diamond"
    amount: 1
  display-name: "1x Diamond"

Command

Runs a console command. Use this to grant economy money, crate keys, ranks, or anything your other plugins provide.

- type: Command
  value: "eco give %player% 500"
  display-name: "500 Coins"

Caution

Match the command to your plugins. The doctor warns about un-namespaced commands like xp that other plugins can override.

Message

Sends a MiniMessage chat message to the player.

- type: Message
  value: "<prefix> <#CDEAC0>Thanks for voting!</#CDEAC0>"
  display-name: "Vote Thanks"

StreakFreeze

Grants one streak freeze, which protects a single missed vote day.

- type: StreakFreeze
  value: "streak_freeze"
  display-name: "Streak Freeze"

Reward placeholders

In Command and Message values, these %…% placeholders are replaced at grant time:

Placeholder	Replaced with
%player%	Player name
%uuid%	Player UUID
%site%	Vote site id
%votes_total%	Lifetime vote count
%votes_daily%	Votes today
%votes_weekly%	Votes this week
%votes_monthly%	Votes this month
%streak%	Current streak
%party_current%	Current vote-party progress

Note

These are not the same as PlaceholderAPI’s %daisyvotes_*% placeholders (which are for HUDs/scoreboards), nor the {…} placeholders used in messages. Reward values use %…%.

Categories

rewards.yml (top level)

per-site-bonuses: false
vote-rewards: [ … ]
first-vote-rewards: [ … ]
site-rewards: { … }
vote-party-rewards: [ … ]
streak-rewards: [ … ]
wheel-rewards: [ … ]
milestone-rewards: [ … ]
cumulative-rewards: { … }

vote-rewards

Granted on every accepted vote, on every site. Defaults: 1x Diamond, 3x Experience Bottles, and a thank-you message.

first-vote-rewards

Granted once, the very first time a player ever votes. Default: a welcome message.

site-rewards

Per-site bonus rewards, keyed by site id. Only used when per-site-bonuses: true. Each site maps to its own list of reward actions.

per-site-bonuses: true
site-rewards:
  minecraftservers:
    - type: Item
      value: "emerald"
      item: { material: "emerald", amount: 1 }
      display-name: "Minecraft Servers Emerald"

vote-party-rewards

Granted to eligible players when a vote party unlocks. Defaults: 3x Diamonds, 4x Emeralds, 1 Golden Apple, and a celebration message.

streak-rewards

Granted when a player reaches a streak length. Each entry is a streak number with a list of actions.

streak-rewards:
  - streak: 3
    actions:
      - type: Item
        value: "emerald"
        item: { material: "emerald", amount: 2 }
        display-name: "2x Emeralds"

Streak	Default reward
3	2× Emeralds
7	1 Golden Apple
14	1 Streak Freeze
30	5× Diamonds
60	1 Beacon
100	2 Netherite Ingots

wheel-rewards

Prizes on the daily wheel. Each prize has a weight (relative chance — higher is more common), an icon, a list of actions, and an optional broadcast for rare wins.

wheel-rewards:
  - id: "emeralds"
    display-name: "3 Emeralds"
    weight: 40
    icon: { material: "emerald", name: "<#CDEAC0>3 Emeralds" }
    actions:
      - type: Item
        value: "emerald"
        item: { material: "emerald", amount: 3 }
  - id: "rare-star"
    display-name: "Rare Star"
    weight: 5
    broadcast: "<prefix> <#FFC8DD>%player%</#FFC8DD> <#B8C0CC>won a rare wheel reward."
    icon: { material: "nether_star", name: "<gradient:#FFC8DD:#FFF1C1>Rare Star</gradient>" }
    actions:
      - type: Item
        value: "rare_star"
        item: { material: "nether_star", amount: 1 }

Prize	Default weight
3 Emeralds	40
4 Experience Bottles	25
3 Diamonds	20
Golden Apple	10
Rare Star (broadcasts)	5

Note

Weights are relative, not percentages. With the defaults above (total 100), rare-star lands roughly 5% of spins. Add or change weights freely.

milestone-rewards

One-time rewards when a player’s lifetime vote count reaches a number. Empty by default. Each entry is a votes threshold with actions.

milestone-rewards:
  - votes: 100
    actions:
      - type: Item
        value: "netherite_ingot"
        item: { material: "netherite_ingot", amount: 1 }
        display-name: "100 Votes!"

Tip

Milestones can’t be skipped: if an admin adds votes that jump past a threshold (/daisyvotes addvotes), the crossed milestone reward still fires.

cumulative-rewards

Recurring rewards every Nth lifetime vote, keyed by the interval. Each interval fires whenever the lifetime total is a positive multiple of it. Defaults: every 25 votes → 3 Diamonds; every 100 votes → 1 Emerald Block.

cumulative-rewards:
  "25":
    - type: Item
      value: "diamond"
      item: { material: "diamond", amount: 3 }
      display-name: "Every 25 Votes: 3 Diamonds"
  "100":
    - type: Item
      value: "emerald_block"
      item: { material: "emerald_block", amount: 1 }
      display-name: "Every 100 Votes: Emerald Block"

Where rewards go when offline

If a player earns a reward while offline, it’s queued and claimed later with /vote claim. See Reminders & Offline Rewards.

Vote Points & Shop Spendable points and the in-game shop use the same action format.