# Menus

Draft

menus.yml
selector:
  title: "&c&lSelector"
  rows:
    - "--M-I-P--"
  items:
    M:
      title: "&cMy Avatars"
      action: "avatars"
      material: "HEART_OF_THE_SEA"
    I:
      title: "&eInformation"
      description:
        - "&aYour current avatar is: &7%player_avatar%"
      action: "info"
      material: "BOOK"
    P:
      title: "&7Preview Avatars"
      action: "preview"
      material: "ENDER_EYE"

#... truncated

Option	Description
`title`	The title of the menu, with support for the MiniMessage format
`rows`	Inventory/GUI rows represented in strings. See below for more details.
`items`	Definition of the items from the `rows` section

# "rows" format

A row is composed of 9 characters and each character represents an inventory slot.
Items are represented with letters from A to Z from the english alphabet.

The characters - (dash) and . (dot) are special.
The - (dash) means that the slot will always be empty, and the . (dot) means that the slot is available for the plugin to fill it dynamically with items.

For example, given the following rows definition:

rows:
 - '---------'
 - '---------'
 - '---------'

..........

editor draft notes:

Compat:
- minimessage
- oraxen
- hdb
- cmd/material
- texture

item:
- title
- description
- action