skills/mechanics/skill.md

@@ -7,12 +7,12 @@ targeter is specified.
 
 Syntax
 ------
-
-    Skills:
-    - skill{skill=AnotherSkill} @Target ~onAttack
-    - skill{s=AnotherSkill} @Trigger ~onSpawn
-    - skill:OtherSkill @Trigger ~onDeath
-
+```yaml
+  Skills:
+  - skill{skill=AnotherSkill} @Target ~onAttack
+  - skill{s=AnotherSkill} @Trigger ~onSpawn
+  - skill:OtherSkill @Trigger ~onDeath
+```
 
 The attribute "sync=true" will be inherited by any sub-skills and cannot
 be set to *false* later in a skill-tree.
@@ -27,29 +27,54 @@ Cooldown
 Skill configurations are capable of utilizing cooldown
 Add cooldown to your skills like this:
 
-    internal_skillname:
-      Cooldown: <seconds>
-      Conditions:
-      - condition
-      - ...
-      Skills:
-      - mechanic{}
-      - ...
+```yaml
+internal_skillname:
+  Cooldown: <seconds>
+  Conditions:
+  - condition
+  - ...
+  Skills:
+  - mechanic{}
+  - ...
 
+```
 Note that this only applies for skill configurations that are saved as
 skill-files in */MythicMobs/Skills*. Cooldown can't be added to
 mechanics called directly in mob configuration files.
 
+OnCooldownSkill
+---------------
+
+If the metaskill is triggered while on cooldown, this option allows for it to launch another metaskill instead
+
+```yaml
+internal_skillname:
+  Cooldown: <seconds>
+  OnCooldownSkill: internal_fallbackskill_name
+  Skills:
+  - mechanic{}
+  - ...
+
+internal_fallbackskill_name:
+  Skills:
+  - mechanic{}
+  - ...
+```
+
+Note that the skill you set as the value of OnCooldownSkill can itself have a OnCooldownSkill option.
+
 Examples
 --------
 
-    Skills:
-    - skill{s=AnotherSkill;sync=true} @Target ~onAttack
-    - skill{s=ice_bolt;sync=true} @Target ~onTimer:100
-    - skill{sync=true;s=flamethrower} @TargetLocation ~onTimer:200
-    - skill:Onemechainc @Target ~onDamaged
-    - skill
-        {
-        skill=leafs;
-        sync=true
-        }
\ No newline at end of file
+```yaml
+  Skills:
+  - skill{s=AnotherSkill;sync=true} @Target ~onAttack
+  - skill{s=ice_bolt;sync=true} @Target ~onTimer:100
+  - skill{sync=true;s=flamethrower} @TargetLocation ~onTimer:200
+  - skill:Onemechainc @Target ~onDamaged
+  - skill
+      {
+      skill=leafs;
+      sync=true
+      }
+```
\ No newline at end of file