vote-sites
The list of sites players see in /vote.
vote-sites.yml is the list of sites players actually see when they
run /vote. It's purely cosmetic — Votifier itself doesn't care
about this file. The only thing that matters for receiving votes is
that NuVotifier is wired up to the trackers; this file just tells
players where to go.
Quick example
sites:
minecraft-mp:
display-name: "<#4DA6E8>Minecraft-MP</>"
url: "https://minecraft-mp.com/server/123456/vote/"
cooldown: "12h"
material: PAPER
slot: 10
planet-minecraft:
display-name: "<#38D9F0>Planet Minecraft</>"
url: "https://www.planetminecraft.com/server/your-server/vote/"
cooldown: "24h"
material: BOOK
slot: 12
topg:
display-name: "<#FF9D5E>TopG</>"
url: "https://topg.org/Minecraft/in-123456"
cooldown: "12h"
material: NETHER_STAR
slot: 14Reference
| Key | Type | Default | Notes |
|---|---|---|---|
display-name | string | MiniMessage. Shown as the item name in the GUI. | |
url | string | The vote URL the player gets when they click. Sent as a clickable component in chat. | |
cooldown | string | 12h | Per-site cooldown shown in the GUI. Format: 30m, 12h, 24h, 1d. |
material | string | PAPER | Bukkit material name for the GUI item. |
slot | int | Slot index in the main GUI (0..53 for a 54-slot menu). | |
lore | list | Optional MiniMessage lore lines under the item name. |
How the cooldown is tracked
VotePlus does not enforce the cooldown server-side — the actual
rate-limit is whatever the tracker enforces on its end. The
cooldown field is only used to show the player a "next vote
available in 04h12m" countdown in the GUI, computed from the last
vote VotePlus received from that site name.
This means the site key in vote-sites.yml must match what the
tracker sends in the serviceName field of the Votifier packet —
otherwise the cooldown timer never advances. If you're not sure what
your tracker sends, enable general.debug and check latest.log
after a test vote.
If you change a site's URL, the cooldown timer carries over because it's keyed by site name, not URL. This is usually what you want — players don't get an extra free vote when you fix a typo.