Skip to content
AbstractMenus AbstractMenus

Roulette

Open the menu and an item icon flips through Diamond → Emerald → Gold → Diamond…, progressively slowing down. When it stops, the player gets a random reward (or nothing). Demonstrates the AnimatedMenu format with frames, the slowdown effect via increasing delay, and onAnimEnd for “what happens after the animation”.

What it teaches

Section titled “What it teaches”
  • The frames block as an alternative to items for animated menus
  • Per-frame delay: (in ticks) and clear: false to preserve static items
  • The static items: block working alongside frames
  • onAnimEnd hook for triggering actions when the animation completes
  • randActions for picking one of N outcomes at random
  • Designing the animation pacing - rapid frames at start, slow at the end
intermediate
Features: framesAnimatedMenuonAnimEndrandActionsstatic-items-with-frames
Open: /ame_roulette 
# Roulette - 8-frame slowdown animation + random prize via randActions
# Docs: https://abstractmenus.github.io/docs/en/examples/casino-and-games/roulette
# Open: /ame_roulette
# Requires: -


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


title: "&6Roulette"
size: 1


activators {
  command: "ame_roulette"
}


# Static items shown across all frames. clear: false on frames keeps these in place.
items: [
  ${borderBlack} { slot: 0 }
  ${borderBlack} { slot: 1 }
  ${borderBlack} { slot: 2 }
  ${borderBlack} { slot: 6 }
  ${borderBlack} { slot: 7 }
  ${buttonClose} { slot: 8 }
]


# Random prize awarded after the spin finishes.
onAnimEnd {
  randActions: [
    {
      sound: ${successSound}
      itemAdd { material: DIAMOND, count: 1 }
      message: "&bYou won 1 Diamond!"
    }
    {
      sound: ${successSound}
      itemAdd { material: EMERALD, count: 2 }
      message: "&aYou won 2 Emeralds!"
    }
    {
      sound: ${successSound}
      itemAdd { material: GOLD_INGOT, count: 4 }
      message: "&6You won 4 Gold Ingots!"
    }
    {
      sound: ${failSound}
      message: "&7Better luck next time."
    }
  ]
}


# Animation frames. Each frame has clear: false so static items survive.
# Delays grow toward the end to create a slowdown feel.
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?" } ] }
]
↓ menu.conf

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

How AnimatedMenu works

Section titled “How AnimatedMenu works”

When a menu file has a frames: block at the root, the plugin treats it as an animated menu. frames replaces the usual single-pass items rendering with a sequence of frames played in order.

Each frame has:

  • delay: ticks before this frame plays (default 20 = 1 second)
  • clear: whether to clear the inventory before this frame’s items render (default true)
  • items: the items to add for this frame
  • Optional rules, onStart, onEnd

A static items: block at the root works alongside frames. With clear: false on frames, those static items persist - exactly what we want for borders and the close button.

The slowdown trick

Section titled “The slowdown trick”

Roulettes feel right when they slow down at the end. We do this with progressively bigger delay: values:

frames: [
  { delay: 2,  ... }   # 0.1s - very fast
  { delay: 2,  ... }
  { delay: 2,  ... }
  { delay: 2,  ... }
  { delay: 4,  ... }   # starts slowing
  { delay: 6,  ... }
  { delay: 10, ... }
  { delay: 20, ... }   # 1s - dramatic pause on final frame
]

Total: roughly 2.4 seconds. The final NETHER_STAR frame holds for a full second while onAnimEnd fires the prize.

Awarding the prize

Section titled “Awarding the prize”

onAnimEnd runs after the last frame finishes. It contains a randActions block that picks one of four outcomes at random:

onAnimEnd {
  randActions: [
    { sound: ${successSound}, itemAdd { material: DIAMOND }, message: "..." }
    { sound: ${successSound}, itemAdd { material: EMERALD, count: 2 }, message: "..." }
    ...
    { sound: ${failSound}, message: "&7Better luck next time." }
  ]
}

Each entry has its own actions block. One is picked uniformly at random. The “no win” outcome is just a sound + message with no itemAdd.

Customizing

Section titled “Customizing”

To weight outcomes differently, repeat them. An outcome appearing twice in the list is twice as likely. To change the spin duration, edit the delay: values - the total spin time is the sum of all delays.

To change what items appear during the spin, swap the material: in each frame’s items. They’re decorative - the actual prize comes from onAnimEnd, not from “where the spin lands”.

Try it

Section titled “Try it”

After installing the example pack:

  1. Drop the bundle into plugins/AbstractMenus/menus/example/.
  2. /am reload.
  3. Type /ame_roulette in-game. Watch the spin, see what you win.