GUI Settings

The GUI Settings entry defines global defaults for all GUIs: lifecycle audio, storage click behaviors, and skill tree node connector items.

Type: Manifest Entry Entry ID: gui_settings

Configuration

Audio Defaults

Field	Type	Default	Description
onOpen	Sound?	null	Sound played when any GUI opens
onClose	Sound?	null	Sound played when any GUI closes
onScroll	Sound?	null	Sound played on scroll events
onClick	Sound?	null	Sound played on any click

Each sound accepts:

• sound — Bukkit Sound enum value (e.g., block.chest.open)
• volume — Float (0.0 to 1.0+)
• pitch — Float (0.5 to 2.0)

Storage Interaction Configuration

Controls which click types perform each storage action. All values are optional and fall back to sensible defaults.

Field	Type	Default	Description
placeOneClick	StorageClickType	LEFT	Place one item from cursor
placeAllClick	StorageClickType	SHIFT_LEFT	Place all items from cursor
takeOneClick	StorageClickType	RIGHT	Take one item from slot
takeAllClick	StorageClickType	SHIFT_RIGHT	Take all items from slot
takeStackClick	StorageClickType	SWAP_OFFHAND	Take one full stack (64)
fillFromInvClick	StorageClickType	DOUBLE_CLICK	Fill slot from player inventory
dropAllClick	StorageClickType	DROP	Drop all items from slot on ground

StorageClickType Values

Value	Bukkit Equivalent
LEFT	Left click
RIGHT	Right click
SHIFT_LEFT	Sneak + left click
SHIFT_RIGHT	Sneak + right click
MIDDLE	Middle click (scroll wheel press)
DOUBLE_CLICK	Double click
DROP	Drop key (Q)
DROP_ALL	Ctrl + Drop (Ctrl+Q)
SWAP_OFFHAND	Swap to offhand (F)

Node Defaults

Field	Type	Default	Description
connectorLines	GuiItemData?	null	Default item for skill tree connector lines

Example

manifest:
  type: gui_settings
  id: "global_gui_settings"
  audioDefaults:
    onOpen:
      sound: "block.chest.open"
      volume: 1.0
      pitch: 1.0
    onClose:
      sound: "block.chest.close"
      volume: 1.0
      pitch: 1.0
    onScroll:
      sound: "ui.button.click"
      volume: 0.5
      pitch: 1.5
    onClick:
      sound: "ui.button.click"
      volume: 1.0
      pitch: 1.0
  storageInteraction:
    placeOneClick: LEFT
    placeAllClick: SHIFT_LEFT
    takeOneClick: RIGHT
    takeAllClick: SHIFT_RIGHT
    takeStackClick: SWAP_OFFHAND
    fillFromInvClick: DOUBLE_CLICK
    dropAllClick: DROP