creating skills - magemonkeystudio/fabled GitHub Wiki

✨ Creating Skills

The Skills tab in the Web Editor allows you to create fully featured custom abilities, complete with scaling attributes, cast triggers, cooldowns, and more.

βž• Creating a New Skill

  1. Click on the Skills tab in the top bar.
  2. Use the βž• Add Skill button in the left sidebar to create a new entry.
  3. Select the new skill to begin editing it.

🧾 Skill Fields & Settings

Each skill includes a variety of properties, organized into a single form:

  • Name – The skill’s internal and display name.
  • Type – Flavor tag (e.g., Damage, Utility, Passive).
  • Max Level – The maximum upgradeable level for the skill.
  • Cost – Skill point cost per level (can scale).
  • Cooldown – Delay in seconds before the skill can be used again.
  • Cooldown Message – Toggle: show message when trying to use the skill on cooldown.
  • Mana – Mana cost for casting this skill (only works with Cast trigger).
  • Cast Message – Radius-based chat/message effect sent on cast.
  • Combo – Combo key string (e.g. L R R for left-right-right). Works if combos are enabled.
  • Icon – Select or upload an icon for this skill.

πŸ” Requirements

  • Skill Requirement – Skill that must be unlocked first.
  • Skill Requirement Level – Minimum level of the required skill.
  • Permission – Optional permission node required to unlock. Example: fabled.skill.fireball.
  • Incompatible Skills – Skills that cannot be used together (mutual exclusivity).

πŸ” Logic Structure

Each skill contains logic blocks made of:

  • Triggers – How the skill is activated (e.g. Cast, Initialize, OnKill)
  • Targets – What the skill applies to (e.g. Self, Location, Area)
  • Conditions – Checks that must be true (e.g. "target is not ally")
  • Mechanics – The actual effects (e.g. damage, particle, message)

Each trigger forms a tree that starts with its target, followed by optional conditions, and ends in one or more mechanics.

🧠 Attributes and Scaling

The following fields can use formulas to scale:

  • Mana
  • Cooldown
  • Cost
  • Mechanic values (like damage, duration, range)

Formula Variables

  • a β€” Attribute value (e.g., Strength)
  • v β€” Skill level
  • c β€” Class level
  • t β€” Target level

Example: 10 + a * 0.5 would scale based on the player’s Strength attribute.

πŸ’Ύ Saving & Exporting

Once you're done:

  • Use the πŸ’Ύ Save button to export just this skill.
  • Or use the πŸ“€ Upload All to Server to export all entries.
  • Skill files are saved in: 
    /plugins/Fabled/skills.yml

Reload the plugin with:

/fabled reload

πŸ§ͺ Testing Tips

  • Equip the class that includes this skill.
  • Open your skill bar or skill GUI to bind it.
  • Cast using your server's configured casting mode.
  • Use /fabled debug to help test visual effects and values.

πŸ”— Related Pages