Action: randActions

randActions takes a list of action groups and picks exactly one at random to execute. Each entry is a full self-contained group - sounds, messages, items, anything goes.

intermediate

Features: randActionsweighted-random-via-repeat

Open: /ame_snip_rand Copy

menu.conf

# Snippet: randActions for one-of-N random outcome
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/action-rand-actions
# Open: /ame_snip_rand

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

title: "&6Random Actions"
size: 1
activators { command: "ame_snip_rand" }

items: [
  {
    slot: 4
    material: ENDER_PEARL
    name: "&5Lucky Roll"
    lore: ["&7Click - random outcome from 4 options."]
    click {
      actions {
        # Pick exactly one of the 4 entries at random and run its block.
        randActions: [
          {
            sound: ${successSound}
            message: "&aJackpot! +10 XP"
            giveXp: 10
          }
          {
            sound: ${successSound}
            message: "&eDecent. +1 emerald"
            itemAdd { material: EMERALD }
          }
          {
            sound: ${clickSound}
            message: "&7Meh. +5 cooked beef"
            itemAdd { material: COOKED_BEEF, count: 5 }
          }
          {
            sound: ${failSound}
            message: "&cBetter luck next time."
          }
        ]
      }
    }
  }
  ${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

randActions: [
  { message: "Outcome A" }
  { message: "Outcome B" }
  { message: "Outcome C" }
]

Each entry has equal probability by default. To weight outcomes, repeat them - an entry appearing twice is twice as likely:

randActions: [
  { message: "Common outcome" }
  { message: "Common outcome" }
  { message: "Common outcome" }
  { message: "Rare outcome" }
]

Above: 3-in-4 chance of “Common”, 1-in-4 chance of “Rare”.

For one-of-N display (which item shows up) instead of one-of-N action, use the chance rule on items - see Rule: chance.