DaisyVotes — Vote Sites & Menus

menus.yml defines your vote sites — each one a candle in the /vote dashboard — plus the titles of the stats and top menus.

The dashboard

File shape

menus.yml

vote-menu:
  title: "DaisyVotes"
  rows: 6
  sites:
    - id: "minecraftservers"
      slot: 20
      display-name: "<gradient:#FFC8DD:#FFF1C1>Minecraft Servers</gradient>"
      url: "https://minecraftservers.org/vote/example"
      service-aliases:
        - "Minecraft Servers"
        - "minecraftservers.org"
      reward-title: "Minecraft Servers Bonus"
      cooldown: { every: "12h" }
      item:
        material: "pink_candle"
      voted-item:
        material: "gray_candle"
    # … four more sites

Older configs may contain lore that does nothing

menus.yml files generated before 2.6.0 shipped candle lore containing {site_votes}, {site_reward_hint} and {cooldown}. Those placeholders never existed — editing those lines changed nothing in-game, and no error said so. They are harmless to leave and safe to delete.

Candle lore is generated by the plugin. To customise menu text, use vote-menu.buttons, where the full descriptor is honoured.

vote-menu

Key	Default	Description
title	"DaisyVotes"	The menu title (MiniMessage).
rows	6	Menu height, 1–6. Slots run 0 to rows * 9 - 1; a button outside that is skipped.
buttons	(see below)	New in 2.6.0 Every button on the menu except the site candles.
sites	(5 sites)	The list of vote sites.

vote-menu.buttons

New in 2.6.0

Every button on the vote dashboard is yours: where it sits, what item it is, what it says, and whether it is there at all. Keys are stable names — stats, wheel, top-voters, claim, party, streak, milestone, close, shop, rewards.

vote-menu:
  buttons:
    shop:
      slot: 42
      enabled: true
      item:
        material: emerald
        glint: true
        name: "<gradient:#FFF1C1:#FFC8DD>Vote Shop</gradient>"
        lore:
          - "<#B8C0CC>Your points: <#FFF1C1><points>"
          - ""
          - "<#FFFFFF>Click to open the shop."

Field	Description
slot	Where it sits, 0–53. Set -1 to leave it out.
enabled	false removes the button entirely.
item	The item to show — the full item descriptor.
inactive-item	Shown instead when the button has nothing to offer: no spins left, no rewards waiting, a streak about to lapse. Falls back to item when unset.

Placeholders available in any button’s name or lore:

<player> <total_votes> <daily_votes> <weekly_votes> <monthly_votes> <season_votes> <streak> <best_streak> <points> <rank> <party_assists> <wheel_spins> <wheel_sites> <wheel_required> <progress_bar> <behind_top> <milestone_name> <milestone_remaining> <queued> <party_current> <party_required> <party_remaining> <party_progress_bar> <grace_remaining> <next_streak_days>

daily_votes / weekly_votes / monthly_votes / season_votes new in 2.8.0

This is the complete list DaisyVotes supplies. The same list is printed as a comment at the top of your own menus.yml, and a build-time test (MainMenuPlaceholdersTest) fails in both directions if that comment and the code ever disagree — so if this page is ever stale, the comment in your file is the one to trust.

Don't like the bundle?

The claim button’s empty state is a bundle, which renders its own vanilla contents tooltip. 2.6.0 hides that with hide-vanilla-tooltip: true — or change inactive-item.material to whatever you prefer. Nothing depends on it being a bundle.

A button key you don’t mention keeps its shipped default, so you only need to write the ones you’re changing. Omitting the whole buttons section gives you the stock menu.

New in 2.8.0 Other plugins’ %placeholders% also work here. With PlaceholderAPI installed, write %player_name%, %vault_eco_balance%, or any other %placeholder% into a button’s name or lore and it’s resolved for whoever opens the menu. The resolved value is escaped, so colour codes or MiniMessage tags returned by another plugin’s placeholder show up as literal text rather than being applied — the same protection that stops a player named <red> from recolouring your menu. This is a different system from the <…> placeholders above: those are DaisyVotes’ own, resolved without PlaceholderAPI at all. See Placeholders for where else this applies and what doesn’t resolve.

Site fields

Each entry under vote-menu.sites:

Field	Required	Description
id	✅	Internal site id. Used for /vote <id>, per-site rewards, and per-site point overrides. Must be unique.
slot	✅	Inventory slot in the dashboard, 0–53. Must be unique per site.
display-name	✅	MiniMessage name shown for the site.
url	✅	The vote page opened when the candle is clicked.
item	✅	The candle shown when the player can vote (see Item descriptor).
service-aliases	—	Names that the server list sends to Votifier for this site. This is how an incoming vote is matched to this site.
reward-title	—	A short header shown in reward previews.
reward-summary	—	Extra preview lines (list of strings).
voted-item	—	The candle shown when the player has already voted here (on cooldown). Defaults to a dimmed copy of item.
cooldown	—	New in 2.6.0 How often this site lets a player vote again. See Per-site cooldowns.

Per-site cooldowns

New in 2.6.0

Voting sites do not agree on how often you may vote, or even on the model. Some allow another vote a fixed number of hours after the last one. Others reset at a wall-clock time in their timezone — so a player who votes at 23:00 can vote again in an hour, not in twelve.

Before 2.6.0 there was one global sites.default-cooldown-hours for every site, so the second kind was wrong by most of a day at the wrong hour.

sites:
  # A rolling window since this player's last vote here.
  - id: planetminecraft
    cooldown: { every: "12h" }        # 30m, 8h, 12h, 24h, 1d

  # A fixed daily reset, in the site's own timezone.
  - id: minecraft-mp
    cooldown:
      resets-at: "00:00"
      zone: "America/New_York"        # or "server"

Field	Description
every	Rolling window since the last vote: 30m, 8h, 12h, 1d.
resets-at	Fixed daily reset as HH:mm. Takes precedence over every.
zone	IANA timezone the reset happens in. server uses the game host’s zone.

A site with no cooldown uses sites.default-cooldown-hours from config.yml, so existing configs are unaffected.

This is display only

The cooldown decides what the candle shows and whether it is lit — it does not refuse votes. The voting site decides whether a vote counts, and DaisyVotes discovering afterwards that it disagreed would mean discarding a vote the player really cast. A wrong value here costs you an accurate countdown, never a vote.

service-aliases is the important one

DaisyVotes matches an incoming vote to a site by comparing the service name the list sends to Votifier against each site’s id and service-aliases. If they don’t match and you’re in strict mode (sites.require-configured-site: true, the default), the vote is rejected. Always include the exact service name the list uses.

Item descriptor

item and voted-item are item descriptors:

Field	Description
material	A Minecraft material id (e.g. pink_candle, diamond), or a custom item from Nexo, Oraxen or ItemsAdder.
name	MiniMessage display name.
lore	A list of MiniMessage lore lines.
amount	Stack size (optional; defaults to 1).

| glint | Enchantment shimmer, without a fake enchantment. | | custom-model-data | Resource-pack model number. | | model | Resource-pack item model key, e.g. mypack:candle/pink. Preferred over custom-model-data. | | hide-vanilla-tooltip | Hides the vanilla enchantment/attribute/unbreakable lines. |

On site candles, only `material` is used from the descriptor

A candle’s name comes from the site’s display-name, and its lore is generated by the plugin from the site’s vote count, reward hint and cooldown. Writing name or lore under a site’s item has no effect.

This is unlike vote-menu.buttons, where the full descriptor is honoured. Making candle text configurable too is on the list.

Custom items

Anywhere a material goes — here, in rewards, and in the shop — you can write an item from Nexo, Oraxen or ItemsAdder instead of a vanilla id:

item:
  material: "nexo:ruby_sword"        # needs Nexo
  # material: "oraxen:ruby_sword"    # needs Oraxen
  # material: "itemsadder:mypack:ruby"  # needs ItemsAdder

The custom item arrives finished — its own model, name and lore — and anything else you set on the descriptor (amount, glint, hide-vanilla-tooltip) is written on top of it. name and lore still apply everywhere except site candles, same as for a vanilla material.

DaisyVotes has no hard (compile-time) dependency on any of these three plugins — it reaches whichever one is installed by reflection, so there is nothing to bundle and nothing required if you don’t use one. If the named plugin isn’t installed, or it has no item with that id, the slot falls back to a plain material rather than the item you meant, and /daisyvotes doctor lists exactly which configured id couldn’t be resolved and which plugin would fix it.

New in 2.6.2

Custom-item support is new. It’s been read against the real Nexo/Oraxen/ItemsAdder APIs, but if something renders oddly on your server, report it rather than working around it.

The default sites

id	Slot	Candle	Service aliases
minecraftservers	20	pink_candle	Minecraft Servers, minecraftservers.org
planetminecraft	21	purple_candle	Planet Minecraft, pmc
minecraftmp	22	yellow_candle	Minecraft MP, minecraft-mp
topg	23	lime_candle	TopG, topg.org
bestservers	24	light_blue_candle	Best Servers, minecraft.buzz

Note

The default urls are examples (.../example). Replace each with your real vote page — /daisyvotes doctor warns about any URL that still contains example.

Adding or removing a site

• Add: copy an existing entry, give it a unique id and slot, set its url, service-aliases, and item, then /daisyvotes reload. To grant a site-specific bonus, see per-site rewards.
• Remove: delete the entry and reload. (If you use the daily wheel, remember that wheel.required-sites clamps to the number of sites you have.)

Other menus

stats-menu:
  title: "<gradient:#FFC8DD:#BDE0FE>Your Vote Stats</gradient>"

top-menu:
  title: "<gradient:#FFF1C1:#BDE0FE>Top Voters</gradient>"

Key	Default	Description
stats-menu.title	Your Vote Stats	Title of the /vote stats menu.
top-menu.title	Top Voters	Title of the /vote top menu.