Rule: chance

chance: 30 means “33 times out of 100, this rule passes”. Useful for rare loot displays, lottery tickets, or any “sometimes you see X” UI.

beginner

Features: chance-rule

Open: /ame_snip_chance Copy

menu.conf

# Snippet: chance rule for probabilistic display
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/rule-chance
# Open: /ame_snip_chance

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

title: "&6Chance Rule"
size: 1
activators { command: "ame_snip_chance" }

items: [
  # 30% chance to render this rare item at slot 4
  {
    slot: 4
    material: NETHER_STAR
    name: "&dRare Star"
    lore: ["&730% chance to appear."]
    rules { chance: 30 }
  }
  # Fallback: 70% chance the slot stays empty (no fallback item, slot just blank)
  ${buttonClose} { slot: 8 }
]

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

Usage

{
  slot: 4
  material: NETHER_STAR
  name: "&dRare item"
  rules { chance: 30 }
}

The rule rolls when the menu is rendered (on open and on each updateInterval tick if set). For a fallback item that shows the OTHER 70% of the time, add a second item at the same slot with no rules - the dual-item pattern handles it.

For weighted random outcomes after a click (not display), use randActions instead - see Action: randActions.