common errors - magemonkeystudio/fabled GitHub Wiki

❗ Common Errors

This page covers frequently encountered issues when configuring or testing Fabled, along with tips on how to fix them.


📄 Skill Doesn’t Show Up in /class skill

Possible Cause Solution
Not added to class in Web Editor Assign the skill to the class before exporting
Player is not professed into the class Use /class profess <class> to switch
Skill has a level requirement Make sure the player meets the skill's skill-req-lvl
Not added to GUI via /class customize Open the GUI editor and add the skill to the class menu

⚙️ Skill Loads But Does Nothing

Possible Cause Solution
Missing mechanics Ensure the skill has a trigger and at least one mechanic
Signal path is blocked Use Message components to debug branches
Required attribute not met Check if the player meets skill requirements
Particle mechanic out of range Verify radius, target filters, or offsets

🛑 Skill Export Won’t Load (After Web Editor Export)

Possible Cause Solution
Files not placed in the correct folders Make sure exported files go into the right locations:

skills//plugins/Fabled/dynamic/skills/
classes//plugins/Fabled/dynamic/classes/
attributes.yml/plugins/Fabled/
effects.yml/plugins/Fabled/
Old files were left behind Delete any outdated skill/class files before copying in new ones
Manually edited exports have errors Avoid editing files by hand; if needed, don’t quote numeric values like "1.5"
Effect key is missing or invalid Ensure effect-key matches a valid entry in effects.yml

🔢 Placeholder Isn’t Displaying

Possible Cause Solution
Placeholder is deprecated Check placeholderapi for updated placeholder syntax
Not supported in current context Some placeholders only work in menus or with PlaceholderAPI
Misspelled PlaceholderAPI syntax Use %fabled_default_currentmana%, not {attr:mana}

🚫 Class or Attribute Not Applying

Possible Cause Solution
Player isn’t professed Use /class profess <class>
Attribute missing from group Add the attribute via the Web Editor
Wrong formula or scale values Double-check formulas and stat scaling in the attribute editor

🎯 Targeting Doesn’t Work

Possible Cause Solution
Invalid range or filters Increase target radius and check target group
Target type doesn’t match Use Enemy, Ally, or All as appropriate
Skill activates but doesn’t hit Use Particle mechanics to confirm targeting zone

🧪 Debugging Tips

  • Use /class skill to see available skills
  • Use Message and Particle mechanics to trace signal paths
  • Preview mechanics in the Web Editor
  • Test with simplified versions before layering complex logic
  • Double-check effect-key, particle types, and duration settings

🔗 Related Pages

⚠️ **GitHub.com Fallback** ⚠️