Кулдаун на голосование

Меню голосования с двумя кусками состояния: глобальный счётчик, который инкрементят все (общее количество голосов сервера за всё время), и персональная временная переменная, которая блокирует игрока на 24 часа после голоса. Связка incVar (глобальный) с setVarp ::1d (персональный временный) - типичный паттерн “голосуй раз в сутки”.

menu.conf
_shared/templates.conf

# Кулдаун на голосование - глобальный счётчик голосов + персональный 24ч кулдаун
# Docs: https://abstractmenus.github.io/docs/ru/examples/state-and-vars/vote-cooldown
# Open: /ame_vote
# Requires: -

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

title: "&6Ежедневное голосование"
size: 3
updateInterval: 20

activators {
  command: "ame_vote"
}

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

  # Глобальный счётчик голосов - сколько всего голосов получил сервер.
  {
    slot: 11
    material: BEACON
    name: "&6Всего голосов на сервере"
    lore: ["", "&e%var_:ame_vote_total:0%", "", "&8(За всё время, по всем игрокам)"]
  }

  # ========== Кнопка голосования - dual-вариант ==========
  # Вариант ON COOLDOWN: персональная временная переменная задана, голосовать пока нельзя.
  {
    slot: 13
    material: GRAY_DYE
    name: "&7Голосовать (на кулдауне)"
    lore: [
      "&7Ты уже голосовал недавно."
      ""
      "&cДоступно через &e%varpt_:ame_vote_cd%"
    ]
    rules { existVarp: "ame_vote_cd" }
  }
  # Вариант READY: кулдауна нет, клик - голосуем.
  {
    slot: 13
    material: LIME_DYE
    name: "&aГолосовать!"
    lore: [
      "&7Клик - проголосовать за сервер."
      "&7Голосовать можно раз в 24 часа."
    ]
    click {
      actions {
        # Увеличиваем глобальный счётчик голосов.
        incVar: "ame_vote_total"
        # Ставим персональный кулдаун, который сам истечёт через 1 день.
        setVarp: "ame_vote_cd::1::1d"
        sound: ${successSound}
        message: "&aСпасибо за голос! Возвращайся через 24 часа."
        refreshMenu: true
      }
    }
  }

  # Информация о наградах
  {
    slot: 15
    material: DIAMOND
    name: "&bНаграды за голос"
    lore: [
      "&7Каждый голос даёт:"
      "&7- &f$100"
      "&7- &f1 vote-токен"
      "&7- &fшанс на алмазы"
      ""
      "&8Настраивается в твоём vote-обработчике"
    ]
  }

  ${buttonClose} { slot: 22 }
]

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/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: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# 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: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  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&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf

Бандл включает _shared/templates.conf и INSTALL.txt.

Что показывает

incVar для глобальных счётчиков, общих для всех игроков
setVarp с временным суффиксом ::1d
Плейсхолдер %var_:name:default% для глобальных переменных (синтаксис двоеточия и дефолта тот же, что у varp)
Связка глобальных и персональных переменных в одном click-обработчике
Dual-item для кнопки голосования (состояния ON_COOLDOWN и READY)

Глобальные vs персональные

Два семейства переменных:

var_* / setVar / incVar - глобальные, на весь сервер. Все читают и пишут одно и то же значение. Здесь - для общего количества голосов.
varp_* / setVarp / incVarp - персональные. У каждого игрока своя копия. Здесь - для блокировки кулдауна.

При клике трогаются оба внутри одного блока actions:

actions {
  incVar: "ame_vote_total"     # глобальный счётчик +1
  setVarp: "ame_vote_cd::1::1d" # персональная блокировка на 24 часа
  ...
}

Глобальный счётчик растёт бесконечно. Персональный кулдаун сам истекает через 1 день, открывая кнопку голосования заново.

Интеграция с реальным голосованием

Этот пример - самостоятельная демка. Чтобы привязать к настоящему голосованию (Votifier, MinecraftPocket и т.д.):

Не давайте игроку кликать по кнопке голосования - награда триггерится внешним vote-сайтом/прокси.
Используйте ту же связку incVar + setVarp внутри Bukkit-листенера, который обрабатывает входящие голоса.
Поставьте перму вроде iconmenu.canclaim или другой гейт, и это меню превратится в “забрать награду за голос”, а не в “проголосовать”.

В разделе документации про переменные описаны опции персистентности, если нужны гарантии после рестарта на глобальном счётчике.

Попробовать

Положите бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введите /ame_vote в игре.
Кликните на лаймовую кнопку “Голосовать!”. Счётчик растёт, кнопка становится серой с обратным отсчётом 23ч 59м.