Rule: if (placeholder expression)

When a built-in rule like permission or money doesn’t fit, the if rule lets you write expressions over any placeholder. Supports >, <, >=, <=, ==, !=, ===, !==, &&, ||, plus parentheses.

intermediate

Features: if-ruleplaceholder-comparisondual-item-display

Open: /ame_snip_if Copy

menu.conf

# Snippet: if rule with placeholder expression
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/rule-if-placeholder
# Open: /ame_snip_if

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

title: "&6If Rule"
size: 1
activators { command: "ame_snip_if" }

items: [
  # Visible only if the player has level 10+. Compares a placeholder via expression.
  {
    slot: 4
    material: ENCHANTED_BOOK
    name: "&aLevel 10+ Reward"
    lore: ["&7Visible to anyone level 10 or higher."]
    rules {
      if: "%player_level% >= 10"
    }
    click {
      actions {
        itemAdd { material: EXPERIENCE_BOTTLE, count: 4 }
        sound: ${successSound}
      }
    }
  }

  # Fallback message for low-level players
  {
    slot: 4
    material: BARRIER
    name: "&cLevel too low"
    lore: ["&7Reach level 10 to claim this reward."]
  }

  ${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 {
  if: "%player_level% >= 10"
}

rules {
  if: "(%player_lvl% == 5 || %player_lvl% == 10) && %player_world% == survival"
}

Inside the expression, placeholders unwrap to their string or numeric values. Bare strings (no quotes needed) are compared with the operators. Use ===/!== for case-insensitive matching of names.

For complex math, use the js rule instead - it runs JavaScript expressions. if is faster and recommended for plain logic.