Vote Cooldown

A vote menu with two pieces of state: a global counter that everyone bumps up (server’s all-time vote count) and a per-player temporal variable that locks them out for 24 hours after voting. Pairs incVar (global) with setVarp ::1d (personal temporal) for the typical “vote once a day” pattern.

intermediate

Features: incVar-globalsetVarp-temporalexistVarpvarpt-placeholdervar-placeholderdual-item-display

Open: /ame_vote Copy

menu.conf

# Vote Cooldown - global vote counter + per-player 24h cooldown
# Docs: https://abstractmenus.github.io/docs/en/examples/state-and-vars/vote-cooldown
# Open: /ame_vote
# Requires: -

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Daily Vote"
size: 3
updateInterval: 20

activators {
  command: "ame_vote"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  # Global vote count - shows how many total votes the server has received.
  {
    slot: 11
    material: BEACON
    name: "&6Total Server Votes"
    lore: ["", "&e%var_:ame_vote_total:0%", "", "&8(All-time count, all players)"]
  }

  # ========== Vote button - dual variant ==========
  # ON COOLDOWN variant: per-player temporal var exists, can't vote yet.
  {
    slot: 13
    material: GRAY_DYE
    name: "&7Vote (on cooldown)"
    lore: [
      "&7You've already voted recently."
      ""
      "&cAvailable in &e%varpt_:ame_vote_cd%"
    ]
    rules { existVarp: "ame_vote_cd" }
  }
  # READY variant: no cooldown, click to vote.
  {
    slot: 13
    material: LIME_DYE
    name: "&aVote!"
    lore: [
      "&7Click to vote for the server."
      "&7You can vote once every 24 hours."
    ]
    click {
      actions {
        # Increment the global vote counter.
        incVar: "ame_vote_total"
        # Set per-player cooldown that auto-expires after 1 day.
        setVarp: "ame_vote_cd::1::1d"
        sound: ${successSound}
        message: "&aThanks for voting! Come back in 24 hours."
        refreshMenu: true
      }
    }
  }

  # Reward earned info
  {
    slot: 15
    material: DIAMOND
    name: "&bVoting rewards"
    lore: [
      "&7Each vote gives:"
      "&7- &f$100"
      "&7- &f1 vote token"
      "&7- &fchance for diamonds"
      ""
      "&8Configure in your vote handler"
    ]
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

What it teaches

• incVar for global counters that all players share
• setVarp with the ::1d temporal duration suffix
• The %var_:name:default% placeholder for global vars (note: same colon-default syntax as varp)
• Pairing global and personal vars in the same click handler
• Dual-item display for the vote button (ON_COOLDOWN vs READY states)

Global vs personal

Two var families:

• var_* / setVar / incVar - global, server-wide. Everyone reads and writes the same value. Used here for the all-time vote total.
• varp_* / setVarp / incVarp - per-player. Each player has their own copy. Used here for the cooldown lockout.

When the click fires, both are touched in the same actions block:

actions {
  incVar: "ame_vote_total"     # global counter +1
  setVarp: "ame_vote_cd::1::1d" # per-player 24h temporal lockout
  ...
}

The global counter increments forever. The per-player cooldown auto-expires after 1 day, opening the vote button again.

Real vote integration

This example is a self-contained demo. To wire it to actual server voting (Votifier, MinecraftPocket, etc.):

1. Don’t have the player click the vote button - the external vote site/proxy fires the reward.
2. Use the same incVar + setVarp pattern inside whatever Bukkit listener handles incoming votes.
3. Set iconmenu.canclaim perm or similar gate, then this menu becomes a “claim your daily vote reward” button rather than a “vote” button.

The plugin docs page on variables covers persistence options if you need cross-restart guarantees on the global counter.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_vote in-game.
4. Click the lime “Vote!” button. Counter goes up, the button turns gray with a 23h 59m countdown.