TDXPlugins
TDX VotePlusConfiguration

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

plugins/TDXVotePlus/vote-sites.yml
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: 14

Reference

KeyTypeDefaultNotes
display-namestringMiniMessage. Shown as the item name in the GUI.
urlstringThe vote URL the player gets when they click. Sent as a clickable component in chat.
cooldownstring12hPer-site cooldown shown in the GUI. Format: 30m, 12h, 24h, 1d.
materialstringPAPERBukkit material name for the GUI item.
slotintSlot index in the main GUI (0..53 for a 54-slot menu).
lorelistOptional 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.