gui yml - goflishMC/fabled-temp GitHub Wiki

🖼 gui.yml — GUI Configuration

The gui.yml file stores all visual layout data for your custom skill, attribute, and class menus. It is automatically generated by Fabled when a server owner uses the /class customize command to edit their GUIs in-game.

📂 File Location

/plugins/Fabled/gui.yml

⚠️ Do not edit this file manually. It is overwritten each time you save changes through /class customize.

🎮 What It Controls

The GUI system in gui.yml allows you to customize:

Skill Menus – Displaying icons, tooltips, unlock conditions, and branches
Attribute Menus – Showing available and spent points, stats, and icons
Class Selection Menus – Choosing base classes and professions

Each menu is stored by group, class, or mode and can contain:

Slot positioning (row, column)
Icons (material, glow)
Lore (hover text)
Unlock requirements (level, cost)
Click actions

✏️ How to Customize GUIs

To safely update your menus, use:

/class customize

This opens the in-game GUI Editor where you can:

Drag and drop items to new positions
Edit skill icons and colors
Configure lore placeholders like {attr:level} or {skill_points}
Save changes directly to gui.yml

✅ When finished, your layout is saved automatically and applied in real time.

📌 Best Practices

Avoid editing gui.yml directly. Doing so can break icons, layouts, or metadata.
Use /class customize in-game or the Web Editor export for full control.
Always back up gui.yml before importing a custom config.

🧪 Dynamic Placeholder Support

Skill icons and lore in the GUI editor support special placeholders, such as:

{name}, {type}, {level}/{max}, {attr:mana}, {req:level}, {skill_points}

See: PlaceholderAPI Placeholders