DaisyVotes — config.yml Reference

config.yml is the main settings file. This page documents every option with its exact default.

YAML keys are kebab-case

DaisyVotes writes config keys in kebab-case — required-votes, per-vote, default-cooldown-hours, and so on. If you’re upgrading from an older build that used camelCase, the plugin migrates your files automatically and keeps a backup. See Migrating & Upgrading.

A fresh config.yml is ordered differently since 2.6.2

A newly generated config.yml now runs top-to-bottom in roughly the order you’d set it up — license, then how votes behave, then the features you switch on, then presentation, ending with the messages block. This page groups the same keys by topic rather than by file position, so nothing below moves. An existing config.yml keeps whatever order it already has — upgrades only ever append missing keys, they never reorder or rewrite a file you’ve edited. See Migrating & Upgrading.

The receiver, vote sites, rewards, shop, network, messages, and storage each have their own file and their own page:

Vote Receiver receiver.yml

Vote Sites & Menus menus.yml

Rewards rewards.yml

Vote Points & Shop shop.yml

Cross-Server (Redis) network.yml

Messages & MiniMessage The messages: section

Top level

config.yml

debug: false
license:            # auto-managed by BuiltByBit — leave blank
  key: ""
  source: ""
  fingerprint: ""
metrics: true

Key	Default	Description
debug	false	Log every vote as it’s accepted or refused, with the reason. Noisy on a busy server — turn it on when /daisyvotes doctor isn’t enough to explain a missing vote.
metrics	true	Send anonymous usage metrics to bStats. No personal or server-identifying data is collected. Set false to opt out.

license

Caution

Leave this section alone. BuiltByBit downloads embed your key automatically and fill these fields after the first start. The key is a private credential — don’t post it publicly. The fingerprint is a short, non-secret id that’s safe to include in support tickets.

Key	Default	Description
key	""	License key. Filled automatically; only paste one if you received it manually.
source	""	Where the saved key came from (usually builtbybit or manual).
fingerprint	""	Non-secret support identifier for the saved key.

visuals

Startup banner, action-bar reminders, and party visuals.

visuals:
  startup-banner: true
  banner-style: Classic        # no longer used
  actionbar-reminders: true
  party-countdown: true
  party-boss-bar: true
  party-boss-bar-seconds: 10
  effects:
    enabled: true
    vote-received: true
    first-vote: true
    streak-milestone: true
    party: true
    wheel-rare-win: true

Key	Default	Description
startup-banner	true	Print the branded startup banner on load.
banner-style	Classic	Does nothing since 2.5.0. The banner is drawn by the framework, which picks an ASCII fallback automatically on panels that can’t render box-drawing characters. The key is kept only so existing configs still parse; startup-banner still turns the banner off.
actionbar-reminders	true	Show a subtle action-bar nudge to players who haven’t voted today.
party-countdown	true	Show a title countdown when a vote party triggers.
party-boss-bar	true	Show vote-party progress on a boss bar. It appears when a vote moves the count and fades again — it is not a permanent bar.
party-boss-bar-seconds	10	How long the progress bar stays up after a vote. Each vote restarts the timer, so a burst keeps it visible.

visuals.effects

Sounds and particles for vote moments. Each can be toggled on its own; enabled is the master switch.

Key	Default	Description
enabled	true	Master switch for all effects.
vote-received	true	Effect when a vote is received.
first-vote	true	Special effect on a player’s first-ever vote.
streak-milestone	true	Effect when a streak milestone is reached.
party	true	Effect when a vote party triggers.
wheel-rare-win	true	Effect on a rare wheel win.

engagement

Streaks, leaderboard nudges, and contributor badges.

engagement:
  streak-grace-minutes: 120
  streak-freezes: true
  almost-there-actionbar: true
  leaderboard-envy: true
  contributor-badges: true

Key	Default	Description
streak-grace-minutes	120	Minutes of grace after the day rolls over before an unprotected streak breaks. Default is two hours.
streak-freezes	true	Allow earnable streak freezes to protect one missed vote day.
almost-there-actionbar	true	Show an action-bar nudge telling a player how many votes they are behind the next person.
leaderboard-envy	true	Broadcast/notify near-top players that they’re close to overtaking someone.
contributor-badges	true	Track how many vote parties each player has helped unlock.

wheel

The daily reward wheel.

wheel:
  enabled: true
  required-sites: 5
  reset-zone: "server"
  animation-ticks: 80
  announce-rare-rewards: true

Key	Default	Description
enabled	true	Master switch for the wheel.
required-sites	5	Distinct sites a player must vote in a day to earn one spin. Clamps to your configured site count.
reset-zone	"server"	Time zone the daily set resets in. Use server or an IANA id like Europe/Berlin.
animation-ticks	80	Length of the spin animation, in ticks (20 ticks = 1 second). Minimum 20.
announce-rare-rewards	true	Broadcast rare wheel wins to the server.

points

The vote points economy. Points are spent in /vote shop.

points:
  enabled: true
  per-vote: 1
  per-site: {}      # optional overrides, e.g. minecraftservers: 2

Key	Default	Description
enabled	true	Master switch for vote points and the shop.
per-vote	1	Points granted per accepted vote (global default).
per-site	{}	Optional per-site overrides keyed by site id. Sites not listed use per-vote.

vote-party

Server-wide vote parties.

vote-party:
  required-votes: 25
  mode: OnlinePlayers          # OnlinePlayers | VotersSinceLastParty | ServerWide
  reset-overflow: false
  broadcast-progress-every: 0

Key	Default	Description
required-votes	25	Total votes needed to trigger a party.
mode	OnlinePlayers	Who gets party rewards. See Vote Parties for all three modes.
reset-overflow	false	When false, votes beyond the goal carry into the next party. When true, the excess is dropped.
broadcast-progress-every	0	Broadcast party progress in chat every N votes. 0 disables it — the boss bar shows the same thing. An existing config keeps whatever you set.

sites

Vote cooldown and anti-fraud. See Voting & Anti-Fraud.

sites:
  default-cooldown-hours: 24
  require-configured-site: true
  duplicate-window-seconds: 10

Key	Default	Description
default-cooldown-hours	24	Cooldown used for the “already voted” candle state.
require-configured-site	true	Strict mode. Only accept votes whose service name matches a configured site. Blocks forged votes from a leaked Votifier token. Set false to accept any vote.
duplicate-window-seconds	10	Drop identical votes (same player + site) arriving within this many seconds. 0 disables the check.

stats

Leaderboard size and caching. See Top Voters & Leaderboards.

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

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

offline-rewards

Queue rewards for players who vote while offline; they claim with /vote claim.

offline-rewards:
  enabled: true
  notify-on-join: true

Key	Default	Description
enabled	true	Save rewards earned while offline.
notify-on-join	true	Tell players on join that they have rewards to claim.

reminders

Periodic “you haven’t voted today” reminders. See Reminders & Offline Rewards.

reminders:
  enabled: true
  interval-minutes: 30

Key	Default	Description
enabled	true	Enable periodic reminders.
interval-minutes	30	Minutes between action-bar reminder sweeps. Minimum 5.

top-voters

Automatic Top 3 awards each period. Full details and the default rank rewards are on Top Voters & Leaderboards.

top-voters:
  daily:
    enabled: false
    # rank1 / rank2 / rank3 reward lists
  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.

discord

Post embeds to a channel webhook. The four embed events and their placeholders are documented on Discord Webhooks.

discord:
  enabled: false
  webhook-url: ""
  username: "DaisyVotes"
  avatar-url: ""
  # on-vote / on-party / on-streak-milestone / on-rare-wheel-win embeds

Key	Default	Description
enabled	false	Master switch for Discord webhooks.
webhook-url	""	Channel webhook URL (Channel Settings → Integrations → Webhooks).
username	"DaisyVotes"	Username the webhook posts as.
avatar-url	""	Avatar the webhook posts with.

update-checker

Tells you when a newer DaisyVotes is out.

update-checker:
  enabled: true
  notify-on-join: true

Key	Default	Description
enabled	true	Check docs.daisy.cat once, shortly after start-up.
notify-on-join	true	Message admins on join when an update is available.

Fixed in 2.8.1

This did not work before 2.8.1. The check asked the Spiget API for a SpigotMC resource id — DaisyVotes is sold on BuiltByBit and has never had one, so spigot-resource-id defaulted to 0, the check returned before doing anything, and no server has ever been told about an update. The key is gone; a leftover spigot-resource-id line in your config.yml is ignored and can be deleted.

It now reads a static JSON file on docs.daisy.cat. Nothing about your server is sent — it is a plain GET, once per start-up, on a background thread. Set enabled: false to stop it entirely.

The join notice needs daisyvotes.admin.update or daisyvotes.admin, so granting the first on its own gets a developer the notice without the rest of the admin surface.

A failed check is reported as a failed check

/daisyvotes doctor has an Updates line that distinguishes up to date, an update available, a version below the supported minimum, still checking, switched off, and could not reach the host — that last one as a warning carrying the reason, never as a pass. A check that never completed has established nothing about whether you are current, and the old one could not tell you the difference.

world-restrictions

New in 2.6.0

For servers running separate inventories per world — Multiverse and friends — where an item bought in the creative world does not follow the player home. Without this, the vote shop quietly converts vote points into nothing there.

world-restrictions:
  enabled: false
  mode: Blacklist              # Blacklist | Whitelist
  worlds: []                   # e.g. [creative, minigames]
  block-menus: true
  block-purchases: true
  queue-rewards: true

Key	Default	Description
enabled	false	Master switch. Nothing is restricted until you turn this on.
mode	Blacklist	Blacklist: the worlds listed are the restricted ones. Whitelist: they are the only ones DaisyVotes works in.
worlds	[]	World names as they appear in /mv list or your server folder. Case-insensitive.
block-menus	true	/vote and every DaisyVotes menu are unavailable in a restricted world.
block-purchases	true	Vote-shop purchases are refused. Checked before points are spent.
queue-rewards	true	Reward items are held for /vote claim instead of being given on the spot.

Votes are never refused

A vote is cast on a website and paid for with the player’s time. DaisyVotes will not decline one because of where the player happened to be standing — the vote counts in full, including the streak, points and party progress. Only the items wait, and the player is told so.

An empty whitelist restricts nothing, rather than disabling the plugin server-wide. Somebody who switched the mode and has not filled in the list yet has not asked for that.

messages

All chat and action-bar copy. Supports MiniMessage tags and {placeholders}. Every key, its default, and the available placeholders are on the dedicated page:

Messages & MiniMessage Every message key, its default, and a MiniMessage primer.

Applying changes

Run /daisyvotes reload to apply config edits without a restart. DaisyVotes rebuilds its services on reload so new values take effect immediately.