Skip to main content

Theme and menu configuration

GUIFX is intentionally file-based. You can keep themes beside your server files, version them with a resource pack project, or generate a first draft through Studio.

Important folder paths​

themes/<theme-id>.yml
menus/<menu-id>.yml
graphics/static/
graphics/animation/
graphics/widgets/static/
graphics/widgets/animation/
graphics/transition/static/
graphics/transition/animation/

Slot widgets​

Widgets use a named layout preset and top-inventory slot numbers. A chest with six rows uses chest_6; its top slots are 0 through 53.

slot-widgets:
  enabled: true

  layout:
    preset: chest_6

  widgets:
    next_arrow:
      enabled: true
      slot: 53
      mode: static
      image: widgets/static/next_arrow.png
      width: 16
      height: 16
      offset-x: 0
      offset-y: 0

Use Studio to place the widget by clicking a slot instead of calculating the slot number and layout origin yourself.

Validation is part of the workflow​

Run /guifx validate after editing. It catches missing files, invalid dimensions, incorrect frame sets, unsafe Client UI mappings, and configuration mistakes before pack generation.