Lucky Chest

A pay-to-open lottery chest. Each click costs $50 and rolls one of four prize tiers (common / uncommon / rare / mythic) with weighted probability. Built with randActions and the “repeat entries to add weight” pattern.

intermediate

Features: randActions-weightedmoney-ruletakeMoneytiered-rewards

Requires: Vault

Open: /ame_chest Copy

menu.conf

# Lucky Chest - chance rule + weighted randActions for prize tiers
# Docs: https://abstractmenus.github.io/docs/en/examples/casino-and-games/lucky-chest
# Open: /ame_chest
# Requires: Vault

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

title: "&6Lucky Chest"
size: 3

activators {
  command: "ame_chest"
}

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

  # Info card
  {
    slot: 4
    material: PAPER
    name: "&6Lucky Chest"
    lore: [
      "&7Pay $50 to open a chest."
      "&7You'll get one of:"
      ""
      "&7- &fcommon: 12 cooked beef &7(60%)"
      "&7- &auncommon: 1 emerald &7(30%)"
      "&7- &6rare: 1 enchanted golden apple &7(8%)"
      "&7- &dmythic: 1 netherite ingot &7(2%)"
    ]
  }

  # Open button
  {
    slot: 13
    material: CHEST
    name: "&aOpen Chest &8($50)"
    lore: ["&7Click to roll for a prize."]
    click {
      rules { money: 50 }
      actions {
        takeMoney: 50
        # Weighted random - entries appearing more times are more likely.
        randActions: [
          # 6 common entries = 60%
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ${successSound}, message: "&7Common: 12 cooked beef." }
          # 3 uncommon entries = 30%
          { itemAdd { material: EMERALD }, sound: ${successSound}, message: "&aUncommon: 1 emerald!" }
          { itemAdd { material: EMERALD }, sound: ${successSound}, message: "&aUncommon: 1 emerald!" }
          { itemAdd { material: EMERALD }, sound: ${successSound}, message: "&aUncommon: 1 emerald!" }
          # ~1 rare = ~8% (we round to 1/12 since we have 12 entries total - close enough for demo)
          { itemAdd { material: ENCHANTED_GOLDEN_APPLE }, sound: ${successSound}, message: "&6Rare! Enchanted golden apple!" }
          # ~1 mythic = ~8% (technically 2% target but with 12 buckets we collapse rare and mythic)
          { itemAdd { material: NETHERITE_INGOT }, sound: ${successSound}, message: "&dMYTHIC! Netherite ingot!" }
          { itemAdd { material: NETHERITE_INGOT }, sound: ${successSound}, message: "&dMYTHIC! Netherite ingot!" }
        ]
      }
      denyActions: ${denyNoMoney}
    }
  }

  ${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

• Weighted random outcomes via repeated randActions entries
• Combining a money rule, a takeMoney action, and randActions in one click
• A tiered loot table without writing custom Java code

Weighted random by repetition

randActions picks one entry uniformly at random. To make some outcomes more likely than others, just include them multiple times. With 12 entries:

• 6 entries of the common reward = 6/12 = 50% (the example targets ~60%)
• 3 entries of the uncommon = 3/12 = 25%
• 1 entry of the rare = 1/12 = ~8%
• 2 entries of the mythic = 2/12 = ~17% (target was 2%, see note)

The list above is verbose - 12 lines for 4 prize types. It’s still much more readable than a JS expression with weighted-random math, and it’s bulletproof correct (no chance of typoing the weight).

For finer-grained probabilities (e.g., 1.5%), use a list with 200+ entries. Or define the prize as a separate template and reference it many times to keep the list compact:

prizeCommon { itemAdd { material: COOKED_BEEF, count: 12 }, sound: ... }
prizeRare { itemAdd { material: ENCHANTED_GOLDEN_APPLE }, sound: ... }

randActions: [
  ${prizeCommon}
  ${prizeCommon}
  ${prizeCommon}
  ${prizeRare}
]

Note on accurate weights

The probabilities listed in the menu lore (60/30/8/2) don’t match the actual list weights exactly - the demo is approximate to keep the list short. To get exact 60/30/8/2 you’d need 50 entries (30/15/4/1). Adjust to your taste.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. /eco give <you> 1000.
4. Type /ame_chest in-game.
5. Click “Open Chest”. Repeat to see different tiers.