Skip to content

Commands and permissions

Commands

Command Permission
/emenus embermenus.admin The builder home screen
/emenus create <name> [rows] embermenus.admin New menu, straight into the editor
/emenus edit <menu> embermenus.admin Edit an existing one
/emenus open <menu> [player] [args] embermenus.use Open a menu
/emenus list embermenus.use Every menu on the server
/emenus templates embermenus.admin The ready-made menus
/emenus browse embermenus.admin Menus shared by other owners
/emenus import [folder] embermenus.admin Bring menus in from another plugin
/emenus delete <menu> confirm embermenus.admin Delete a menu file
/emenus reload embermenus.admin Reread everything from disk

Aliases: /emenus, /menus, /menu

Opening a menu for somebody else needs embermenus.admin.

Permissions

Node Default
embermenus.use everyone Open menus
embermenus.admin op Build, edit, import, browse, reload

Each menu can also require any node you choose, through Open permission, and each icon can require its own through Who can see it.

Placeholders

Requires PlaceholderAPI.

%embermenus_count% How many menus exist
%embermenus_open% The menu this player has open, or none
%embermenus_arg_<name>% An argument of the open menu
%embermenus_can_open_<menu>% true when this player may open it
%embermenus_slots_<menu>% How many slots a menu has
menu:
  title: "&8Shop"          # colour codes and placeholders both work
  rows: 5                   # 1 to 6. `size:` in slots is also accepted
  open_command:             # each becomes a real command
    - shop
  open_permission: ""       # empty means everybody
  open_requirement: {}      # see Requirements
  update_interval: 0        # seconds; 0 is off
  args: []                  # names for /menu <arg1> <arg2>
  open_commands: []         # actions that run when it opens
  close_commands: []        # actions that run when it closes
  register_command: true    # false stops it claiming its own command
  items: {}

An item

    example:
      material: DIAMOND_SWORD
      slot: 13               # or slots: [0, 8] or slots: "0-8, 45-53"
      priority: 0
      amount: 1
      display_name: "&aExample"
      lore:
        - "&7A line"
      model_data: 0
      glow: false
      unbreakable: false
      hide_attributes: false
      rgb: ""                # "#ff8f00" or "255,143,0"; leather and potions
      enchantments:
        - "SHARPNESS;3"
      item_flags:
        - HIDE_ENCHANTS
      view_requirement: {}
      left_click_requirement: {}
      left_click_commands: []

Both spellings are accepted for the fields that have two in the wild: display_name or name, lore or display_lore, model_data or custom_model_data, rows or size.

Config

language: en
install-templates-on-first-run: true
register-menu-commands: true
debug: false

community:
  enabled: true
  url: "https://cdn.emberplugins.online/community/"

Files

plugins/EmberMenus/
  config.yml
  lang/          en, de, es, fr, pt_BR, ru, zh_CN
  menus/         one file per menu, named after the menu