DaisyVotes — config.yml Reference

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

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

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

Key	Default	Description
`debug`	`false`	Verbose console logging. Turn on only when diagnosing an issue.
`metrics`	`true`	Send anonymous usage metrics to bStats. No personal or server-identifying data is collected. Set `false` to opt out.

`license`

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        # Classic | Gradient
  actionbar-reminders: true
  party-countdown: true
  party-boss-bar: true
  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`	`Classic` uses named colors that render cleanly in most consoles (recommended). `Gradient` is accepted but most consoles render gradients poorly.
`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 a boss bar during the party countdown.

`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: 5

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`	`5`	Broadcast party progress every N votes.

`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: 5

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`	`5`	How often to check for a period rollover. 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`

Notify admins when a newer DaisyVotes version is available.

update-checker:
  enabled: true
  spigot-resource-id: 0
  notify-on-join: true

Key	Default	Description
`enabled`	`true`	Enable the update check.
`spigot-resource-id`	`0`	Your SpigotMC resource id (the number in the resource URL). `0` disables the check.
`notify-on-join`	`true`	Notify admins on join when an update is available.

`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.