Счётчик и тоггл

Два самых частых примитива состояния в любом GUI: числовой счётчик, который можно увеличивать и уменьшать, и бинарный тоггл. Оба показывают систему персональных переменных (varp) и паттерн dual-item для условного отображения.

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

• incVarp / decVarp / removeVarp для числовых мутаций
• setVarp с шорткатом "name::value"
• Синтаксис плейсхолдера %varp_:name:default%
• Правило existVarp для проверки “существует ли эта переменная у игрока”
• Паттерн dual-item: два предмета на одном слоте, у первого правила, второй - фолбек
• refreshMenu: true, чтобы отображение обновлялось без закрытия и переоткрытия меню

средний

Фичи: incVarpdecVarpsetVarpremoveVarpexistVarprefreshMenudual-item-display

Открыть: /ame_counter Скопировать

menu.conf

# Счётчик и тоггл - демо персональных переменных
# Docs: https://abstractmenus.github.io/docs/ru/examples/state-and-vars/counter-toggle
# Open: /ame_counter
# Requires: -

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

title: "&6Счётчик и тоггл"
size: 3

activators {
  command: "ame_counter"
}

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

  # ========== Секция счётчика ==========
  # Сброс счётчика
  {
    slot: 10
    material: BARRIER
    name: "&cСбросить счётчик"
    lore: ["&7Клик - очистить счётчик."]
    click {
      actions {
        removeVarp: "ame_counter"
        sound: ${clickSound}
        refreshMenu: true
      }
    }
  }

  # Уменьшить
  {
    slot: 11
    material: RED_WOOL
    name: "&c-1"
    click {
      actions {
        decVarp: "ame_counter"
        sound: ${clickSound}
        refreshMenu: true
      }
    }
  }

  # Отображение счётчика - по умолчанию 0, если переменная не задана
  {
    slot: 12
    material: BOOK
    name: "&6Счётчик: &e%varp_:ame_counter:0%"
    lore: ["&7Твой персональный счётчик, сохраняется между сессиями."]
  }

  # Увеличить
  {
    slot: 13
    material: GREEN_WOOL
    name: "&a+1"
    click {
      actions {
        incVarp: "ame_counter"
        sound: ${clickSound}
        refreshMenu: true
      }
    }
  }

  # ========== Секция тоггла ==========
  # Паттерн dual-item: первый предмет рендерится, когда переменная есть,
  # второй - когда её нет.

  # Состояние ON (видно только когда переменная задана)
  {
    slot: 15
    material: LIME_DYE
    name: "&aТоггл: ВКЛ"
    lore: ["&7Клик - выключить."]
    rules { existVarp: "ame_toggle" }
    click {
      actions {
        removeVarp: "ame_toggle"
        sound: ${clickSound}
        refreshMenu: true
      }
    }
  }

  # Состояние OFF (фолбек, без правил - рендерится, когда вариант ON скрыт)
  {
    slot: 15
    material: GRAY_DYE
    name: "&7Тоггл: ВЫКЛ"
    lore: ["&7Клик - включить."]
    click {
      actions {
        setVarp: "ame_toggle::1"
        sound: ${clickSound}
        refreshMenu: true
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# 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 ↓ Бандл (.zip)

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

Как работает счётчик

Счётчик использует три действия и плейсхолдер:

• incVarp: "ame_counter" прибавляет 1 к переменной. Если её нет, плагин сначала автоматически инициализирует её нулём.
• decVarp: "ame_counter" отнимает 1.
• removeVarp: "ame_counter" удаляет переменную - фактически сброс в “счётчика нет”.

Отображающий предмет показывает %varp_:ame_counter:0%. Суффикс :0 - значение по умолчанию: когда переменная не существует, плейсхолдер рендерится как 0, а не пустая строка.

Каждое click-действие заканчивается на refreshMenu: true, чтобы отображение обновлялось сразу. Без этого счётчик обновлялся бы только при срабатывании auto-update интервала меню (или никогда, если updateInterval не задан).

Как работает тоггл

Тоггл использует паттерн dual-item: два предмета объявлены на одном слоте, первый рендерится только если его правила проходят, а второй - фолбек.

# Виден, когда тоггл задан
{ slot: 15, material: LIME_DYE, rules { existVarp: "ame_toggle" }, ... }

# Виден, когда тоггл НЕ задан
{ slot: 15, material: GRAY_DYE, ... }   # без правил = всегда проходит

Когда у игрока задана переменная ame_toggle, показывается зелёный предмет, и клик удаляет переменную. Когда переменной нет, показывается серый предмет, и клик ставит переменную в “1” (значение неважно для проверки существования, важно лишь, что переменная есть).

Этот паттерн часто используют для вещей вроде “выдать предмет / уже забрано”, “VIP-цена / обычная цена”, “замьючен / размьючен” - любое бинарное состояние, где игрок должен видеть разную картинку.

Кастомизация

Чтобы поменять имя переменной, замените ame_counter и ame_toggle везде - в действиях, в правиле existVarp и в плейсхолдере. Берите имена с серверным префиксом, чтобы избежать коллизий с другими меню.

Для счётчика с шагом больше 1 используйте объектную форму:

incVarp: [
  { name: "ame_counter", amount: 5 }
]

Попробовать

После установки example pack:

1. Положите бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Введите /ame_counter в игре.
4. Покликайте. Счётчик сохраняется - закройте меню, откройте снова, значение на месте.