Рулетка

Открываете меню, и иконка предмета быстро перебирает алмаз -> изумруд -> золото -> алмаз…, постепенно замедляясь. Когда всё останавливается, игрок получает случайную награду (или не получает ничего). Показывает формат AnimatedMenu с frames, эффект замедления через рост delay и хук onAnimEnd для логики “что происходит после анимации”.

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

• Блок frames как альтернатива items для анимированных меню
• delay: (в тиках) на каждом кадре и clear: false для сохранения статичных предметов
• Совместная работа статичного блока items: и frames
• Хук onAnimEnd для запуска действий по завершении анимации
• randActions для выбора одного из N исходов случайно
• Темп анимации - быстро в начале, медленно к концу

средний

Фичи: framesAnimatedMenuonAnimEndrandActionsstatic-items-with-frames

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

menu.conf

# Рулетка - анимация замедления из 8 кадров + случайный приз через randActions
# Docs: https://abstractmenus.github.io/docs/ru/examples/casino-and-games/roulette
# Open: /ame_roulette
# Requires: -

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

title: "&6Рулетка"
size: 1

activators {
  command: "ame_roulette"
}

# Статичные предметы, которые видны во всех кадрах. clear: false на кадрах оставляет их на месте.
items: [
  ${borderBlack} { slot: 0 }
  ${borderBlack} { slot: 1 }
  ${borderBlack} { slot: 2 }
  ${borderBlack} { slot: 6 }
  ${borderBlack} { slot: 7 }
  ${buttonClose} { slot: 8 }
]

# Случайный приз, выдаётся после завершения вращения.
onAnimEnd {
  randActions: [
    {
      sound: ${successSound}
      itemAdd { material: DIAMOND, count: 1 }
      message: "&bВы выиграли 1 алмаз!"
    }
    {
      sound: ${successSound}
      itemAdd { material: EMERALD, count: 2 }
      message: "&aВы выиграли 2 изумруда!"
    }
    {
      sound: ${successSound}
      itemAdd { material: GOLD_INGOT, count: 4 }
      message: "&6Вы выиграли 4 золотых слитка!"
    }
    {
      sound: ${failSound}
      message: "&7В следующий раз повезёт."
    }
  ]
}

# Кадры анимации. У каждого clear: false, чтобы статичные предметы не пропадали.
# Задержки растут к концу - получается ощущение замедления.
frames: [
  { delay: 2,  clear: false, items: [ { slot: 4, material: DIAMOND,    name: "&b?" } ] }
  { delay: 2,  clear: false, items: [ { slot: 4, material: EMERALD,    name: "&a?" } ] }
  { delay: 2,  clear: false, items: [ { slot: 4, material: GOLD_INGOT, name: "&6?" } ] }
  { delay: 2,  clear: false, items: [ { slot: 4, material: DIAMOND,    name: "&b?" } ] }
  { delay: 4,  clear: false, items: [ { slot: 4, material: EMERALD,    name: "&a?" } ] }
  { delay: 6,  clear: false, items: [ { slot: 4, material: GOLD_INGOT, name: "&6?" } ] }
  { delay: 10, clear: false, items: [ { slot: 4, material: DIAMOND,    name: "&b?" } ] }
  { delay: 20, clear: false, items: [ { slot: 4, material: NETHER_STAR, name: "&e?" } ] }
]

_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.

Как работает AnimatedMenu

Если в файле меню в корне есть блок frames:, плагин считает меню анимированным. frames заменяет обычный однопроходный рендеринг items на последовательность кадров, проигрываемых по порядку.

У каждого кадра есть:

• delay: задержка перед этим кадром в тиках (по умолчанию 20 = 1 секунда)
• clear: очищать ли инвентарь перед рендером items этого кадра (по умолчанию true)
• items: предметы, которые добавляются в этом кадре
• Опционально: rules, onStart, onEnd

Статичный блок items: в корне работает вместе с кадрами. Если у кадров clear: false, эти статичные предметы сохраняются - именно то, что нужно для рамок и кнопки закрытия.

Трюк с замедлением

Рулетка ощущается правильно, когда замедляется к концу. Делаем это через постепенно растущие значения delay::

frames: [
  { delay: 2,  ... }   # 0.1s - очень быстро
  { delay: 2,  ... }
  { delay: 2,  ... }
  { delay: 2,  ... }
  { delay: 4,  ... }   # начинает замедляться
  { delay: 6,  ... }
  { delay: 10, ... }
  { delay: 20, ... }   # 1s - драматичная пауза на финальном кадре
]

Всего: примерно 2.4 секунды. Финальный кадр с NETHER_STAR держится целую секунду, пока onAnimEnd выдаёт приз.

Выдача приза

onAnimEnd запускается после того, как закончится последний кадр. Внутри блок randActions, который случайно выбирает один из четырёх исходов:

onAnimEnd {
  randActions: [
    { sound: ${successSound}, itemAdd { material: DIAMOND }, message: "..." }
    { sound: ${successSound}, itemAdd { material: EMERALD, count: 2 }, message: "..." }
    ...
    { sound: ${failSound}, message: "&7В следующий раз повезёт." }
  ]
}

У каждой записи свой блок действий. Один выбирается равномерно случайно. Исход “не выиграл” - просто звук и сообщение, без itemAdd.

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

Чтобы взвешивать исходы по-разному, повторяйте их. Запись, встречающаяся дважды, имеет вдвое больший шанс. Чтобы изменить продолжительность вращения, правьте значения delay: - общее время равно сумме всех задержек.

Чтобы сменить, какие предметы появляются во время вращения, замените material: в items каждого кадра. Они декоративные - реальный приз идёт из onAnimEnd, а не “куда попадёт вращение”.

Попробовать

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

1. Положите бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Введите /ame_roulette в игре. Смотрите на вращение, узнайте, что выпало.