Rule: permission

The permission rule is the most-used gate in any menu - “only let the player do this if they have the permission.” Pair it with denyActions for a friendly rejection.

beginner

Features: permission-ruledenyActions-substitution

Open: /ame_snip_perm Copy

menu.conf

# Snippet: permission rule
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/rule-permission
# Open: /ame_snip_perm

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

title: "&6Permission Rule"
size: 1
activators { command: "ame_snip_perm" }

items: [
  {
    slot: 4
    material: DIAMOND
    name: "&bAdmin Reward"
    lore: ["&7Click - admins only."]
    click {
      rules { permission: "abstractmenus.admin" }
      actions {
        itemAdd { material: DIAMOND }
        sound: ${successSound}
        message: "&aAdmin diamond claimed."
      }
      denyActions: ${denyNoPerm}
    }
  }
  ${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

click {
  rules { permission: "myplugin.admin" }
  actions { ... }
  denyActions: ${denyNoPerm}
}

The rule passes if the player has the named permission node. To gate by group instead of permission, swap to the group rule (works with LuckPerms). To invert (allow only those WITHOUT the permission), prefix with -: -permission: "...".