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

​GUI Settings

​Configuration

​Audio Defaults

​Storage Interaction Configuration

​StorageClickType Values

​Node Defaults

​Example