OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationMenus: buttons that invoke reusable Actions

Menus: buttons that invoke reusable Actions

Menus are YAML under plugins/Obsidrel/resources/ui/menus/. Showcase demonstrates buttons invoking reusable Actions without granting players administrator command permissions.

Basic menu

Create menus/tutorial.yml:

yaml
tutorial:
  enabled: true
  title: '<light_purple>My Menu</light_purple>'
  rows: 3
  buttons:
    prize:
      slot: 11
      material: EMERALD
      name: '<red>Receive a reward</red>'
      actions:
        - '[action] showcase_give_arcane_lens'
    hammer:
      slot: 15
      material: NETHERITE_AXE
      name: '<gold>Receive hammer</gold>'
      actions:
        - '[action] showcase_give_hammer'

Dependencies: showcase_give_arcane_lens and showcase_give_hammer are bundled Showcase Actions; replace them with your own if Showcase is absent. It awards an Arcane Lens, not a ruby.

Advanced: conditions inside the invoked Action

Create a reusable Condition for a level or permission and attach it to your Action via conditions: [id]. Menu presentation stays simple while the same rule can be reused from a Trigger.

Important fields

  • enabled, listed, permission, title, rows, refresh-ticks.
  • buttons.<id>.slot, material, item-model, name, lore, actions.
  • fill.material/name for decorative slots.
  • visual.background for bitmap font-based inventory backgrounds, when configured.

Verification

After reload, open the menu through its available command; test slots, dependencies, permissions and clicks. For item models/backgrounds, build and deliver the pack. Refer to installed Showcase menu examples for each action/navigation syntax.

Actions and Conditions · Visual UI · Fonts.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.