Shared Extras

This page covers common menu features used across all menu types.

Global menu sounds

open_sounds:
  - 'BLOCK_CHEST_OPEN|1|1'

close_sounds:
  - 'BLOCK_CHEST_CLOSE|1|1'

click_sounds:
  - 'UI_BUTTON_CLICK|1|1'

• open_sounds: Played when menu opens
• close_sounds: Played when menu closes
• click_sounds: Global fallback click sound for menu items

Filler system

filler:
  global:
    material: BLACK_STAINED_GLASS_PANE
    name: ' '

  border:
    material: GRAY_STAINED_GLASS_PANE
    name: ' '

  pagination:
    material: LIGHT_GRAY_STAINED_GLASS_PANE
    name: ' '

  custom:
    top_bar:
      material: BLUE_STAINED_GLASS_PANE
      name: ' '
      slots: '0-8'

• global: Fills all empty slots
• border: Overrides border slots
• pagination: Used for empty pagination slots
• custom: Named filler blocks for specific slot groups

Snapshot support

snapshot:
  enabled: true
  snapshot_id: 'editor_main'
  restore_on_close: true

• enabled: Enables inventory snapshot handling
• snapshot_id: Snapshot key
• restore_on_close: Restore original inventory when menu closes

Player inventory control

player_inventory:
  enabled: true
  allowed_slots: '0-8'

• enabled: Allows interactions with player inventory while menu is open
• allowed_slots: Restricts which player inventory slots can be used

Editable slots (ITEM_INPUT)

editable_slots: '10-16,19-25,28-34'

• Defines GUI slots where players can move/place items
• Used by ITEM_INPUT menus

Slot syntax (shared)

slot: 13

slots: '10-16,19-25'

slots:
  - 10
  - 13
  - 16

You can use integer, range, or list format.