tool yml - magemonkeystudio/fabled GitHub Wiki

🛠 tool.yml — Decorative GUI Icons

The tool.yml file defines custom decorative icons that can be used to visually enhance your class, skill, and attribute menus. These icons are added to your inventory while editing menus in the GUI editor.

They are ideal for adding:

📌 Section labels (e.g. "Attributes", "Elemental Spells")
🖼 Decorative dividers or spacers
📄 Tooltip hints or visual cues

These icons are not used to represent skills, attributes, or classes — only to enhance the visual layout.

📂 File Location

/plugins/Fabled/tool.yml

This file must be edited manually. When you define new entries here, they will become available as draggable icons the next time you enter the GUI editor.

🎮 How to Use in the GUI Editor

To access your decorative icons:

Run the command:
```
/class customize
```
Open the menu you want to edit (e.g. skills, attributes, class selector)
Your defined icons from tool.yml will appear in your inventory
Drag and drop these icons into the menu slots as needed
Save your layout to apply the changes to gui.yml

For full details on using the editor, see: Class Customize

📘 Example Entry

FIRE_ICON: 
  type: 'PAPER' 
  data: '1'         # Custom Model Data (for resource packs)
  durability: '0'
  name: '&cFire Skill' 
  lore:
    - '&7Unleash burning magic'

Field	Description
`type`	Minecraft material name
`data`	Custom model data value
`durability`	Legacy durability field (usually 0)
`name`	Display name (supports color codes)
`lore`	Tooltip text shown on hover

🔧 Related Internal File

`tool-config.json`

/plugins/Fabled/tool-config.json

This file stores editor metadata for the GUI tool system. It is created and managed automatically by the plugin.
You do not need to edit or configure this file manually.

✅ Best Practices

Use uppercase, clear keys like FIRE_ICON, INFO_LABEL, or SECTION_DIVIDER
Add data: values to support custom model overrides in resource packs
Combine with placeholders like {skill_points} or {attr:mana} to enhance context