Body & Presentation

EasyMenu 7 supports decorative body elements for dialogs and detailed presentation settings to control rendering behavior.

---

Body Content (body)

body defines decorative introductory text and item icons rendered above the buttons in Native Dialogs:

menu-title: "&6Featured Shop"
dialog: true

# Decorative header content
body:
  - type: text
    text: "&eWeekend Special Sale! 20% OFF everything.\n&7Check out featured items below:"

  - type: item
    material: NETHERITE_SWORD
    name: "&c&lFeatured Weapon"
    lore:
      - "&7Legendary Netherite Sword"
      - "&eSpecial: $5,000"

menu-items:
  - id: buy
    material: EMERALD
    name: "Buy Now"
    command: "shop buy featured"

:::info Dropped on Inventory GUIs In standard chest UIs, body content is safely omitted. Because body elements carry no executable actions, no functionality is lost. :::

---

Presentation Modes (presentation)

Customize menu presentation modes per file:

presentation:
  mode: native-preferred # Display mode
  fallback: true         # Allow falling back to chest UI on unsupported servers

  inventory:
    size: 54
    background: "GRAY_STAINED_GLASS_PANE"

  native:
    columns: 2
    button-width: 160
    can-close-with-escape: true
    pause: false

Supported Modes (presentation.mode)

Mode	Priority Chain	Description
inventory (default)	Chest UI	Classic inventory menu format.
native-preferred	Dialog → Chest UI	Native Dialog where supported, Chest UI otherwise.
native-required	Dialog only	Only opens on servers with Dialog support (shows friendly error on older servers).
rich-preferred	Rich UI → Dialog → Chest UI	Uses the richest supported interface.
rich-required	Rich UI only	Requires a rich renderer.
auto	Automatic	Automatically selects the optimal presentation based on client and server capabilities.

:::tip Precedence If both dialog: true and a presentation section are defined, presentation takes precedence and a warning is logged. :::