Custom GUIs

Create and configure new GUI screens.

Updated: 2026-07-23 07:24:59 UTC

Custom GUIslink

Custom GUIs are new screens that you can fill with FancyMenu elements.

Creating a Custom GUIlink

  1. Open Customization -> Custom GUIs -> Manage Custom GUIs.
  2. Select New GUI.
  3. Enter an identifier and configure the screen settings.
  4. Select Done, then open the new GUI from the manager.
  5. Create and edit its layout like any other screen.

Identifiers may use lowercase letters, digits, ., _, and -. They cannot contain spaces and must be unique. Empty, invalid, or duplicate identifiers cannot be saved.

Custom GUIs always have screen customization enabled; their customization toggle cannot be disabled.

Screen Settingslink

SettingBehavior
Allow ESCLets Escape close the GUI and return to its parent screen
Pause Game/WorldPauses singleplayer while the GUI is open
Render World BackgroundShows the loaded world behind the GUI
World Background OverlayAdds the standard blur/dark overlay over the world
Popup ModeKeeps the parent screen visible behind the Custom GUI
Popup Background OverlayAdds blur/tint over the parent screen in Popup Mode

Popup Mode does not merge the two screens. The Custom GUI remains the active screen while its parent is rendered behind it. Closing the Custom GUI returns to that parent when one exists.

Opening a Custom GUIlink

Use the exact Custom GUI identifier with either:

Overriding an Existing Screenlink

A Custom GUI can replace a Vanilla or mod screen whenever that screen opens.

  1. Create the replacement Custom GUI.
  2. Open the screen you want to replace.
  3. Enable Customization -> Settings -> Advanced Customization Mode.
  4. Select Customization -> Custom GUIs -> Override Current with Custom GUI.
  5. Choose the replacement Custom GUI.

Manage saved overrides through Customization -> Custom GUIs -> Manage Overridden Screens.

An override skips the original screen, so test its navigation and any features that depend on the original screen's behavior.