Rules: and / or

The default rules { ... } block already ANDs everything inside. The explicit and wrapper is mostly useful inside or (since you can’t otherwise nest AND inside OR). The or wrapper passes when any of its child rules pass.

intermediate

Features: and-wrapperor-wrapperlogical-composition

Requires: LuckPermsVault

Open: /ame_snip_andor Copy

menu.conf

# Snippet: and / or logical wrappers
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/rule-and-or
# Open: /ame_snip_andor

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

title: "&6Logical Rules"
size: 1
activators { command: "ame_snip_andor" }

items: [
  # AND - all sub-rules must match. (rules block defaults to AND, this is here for explicit demo.)
  {
    slot: 2
    material: DIAMOND_SWORD
    name: "&bAdmin in CREATIVE"
    lore: ["&7Need: admin permission AND creative mode."]
    flags: HIDE_ATTRIBUTES
    rules {
      and {
        permission: "abstractmenus.admin"
        gamemode: CREATIVE
      }
    }
  }

  # OR - at least one sub-rule matches.
  {
    slot: 6
    material: GOLDEN_APPLE
    name: "&aVIP or rich"
    lore: ["&7Need: VIP permission OR $1000."]
    rules {
      or {
        permission: "abstractmenus.vip"
        money: 1000
      }
    }
  }

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

rules {
  or {
    permission: "vip"
    money: 1000
  }
}

This passes if the player has the VIP permission OR has $1000+. Either condition is enough.

rules {
  or: [
    {
      and {
        permission: "vip"
        money: 100
      }
    }
    {
      and {
        permission: "admin"
        gamemode: CREATIVE
      }
    }
  ]
}

Nested form: passes if (VIP and $100+) OR (admin and creative mode). Each entry in the or: list is a separate rule group.

There’s also oneof (matches first true entry, short-circuits) - see the Item Enhancer example for that.