Spells/Learning.md

@@ -4,7 +4,8 @@ Any castable spells a player learns will appear in their [Spellbook](/Spells/Spe
 
 [[_TOC_]]
 
-# Learning Spells
+
+# Learnable Spells
 ## Admin Commands
 The most obvious way to learn spells is by using admin commands.
 
@@ -14,11 +15,11 @@ The admin command to teach someone a spell is:
 You can also use the `unlearn` command to remove a spell from someone.
 
 ## Archetypes
-#### by Leveling
+### Leveling
 Spells can be configured to automatically be given by an archetype upon reaching a certain level.
 
 This is configured in an archetype's `SpellUnlocks` section.
-```
+```yaml
 Pyromancer:
   Group: CLASS
   Display: 'Pyromancer'
@@ -32,18 +33,16 @@ In this example:
 
 If a player loses an archetype, all spells learned from it will be lost. 
 
-#### Talent Trees
+### Talent Trees
 _coming soon_
 
-## Automatically
-See [Global Spells ("MythicScript")](Spells/Global)
 
 ## Mechanics
 Players can be taught spells using the `teachSpell` mechanic (or have them removed via the `forgetspell` mechanic).
 
 You can use this to create NPCs or [Custom Menus](/Custom-Menus) that teach spells, have a boss that teaches a spell upon being defeated, or to use with Crucible to create your own custom tome-type items.
 
-```
+```yaml
 Skills:
 - teachSpell{spell=DoubleJump} @trigger
 ```
@@ -61,4 +60,38 @@ Tomes are special items that can teach you a spell. These can be given to player
 **You can obtain a tome using admin commands:**
 `/mythicrpg spells tome get [spell]`
 
-Mobs can also drop a tome using the custom `spelltome{spell=X}` drop type.
\ No newline at end of file
+Mobs can also drop a tome using the custom `spelltome{spell=X}` drop type.
+
+
+# Globally Available Spells
+Global Spells and Global Mechanics are spells and mechanics you can have automatically apply to all players.
+
+These included both active and passive spells, as well as special mechanics you can define to run on all players in the `config-spells.yml` config file.
+
+## Global Spells
+Global Spells are spells that are automatically given to everyone.
+
+To make a spell global, you simply put `Global: true` in the mythic skill's configuration.
+```yaml
+SomeGlobalSkill:
+  Spell: true
+  Global: true
+  ...
+```
+This will cause the spell to be given to all players, and if it's a passive it will automatically trigger for all players.
+
+## Global Mechanics
+Global Mechanics are defined in the `config-spells.yml` file, at the bottom under the `GlobalSkills` section. These are defined exactly like your typical mob skills, and will apply to all players.
+
+The default config file comes with a single example that would be used to give people basic "mana regeneration":
+```yaml
+Configuration:
+
+  GlobalSkills:
+  #
+  # Example of using this to implement global mana regeneration
+  - modifyReagent{reagent=mana;amount=10} @self ~onTimer:20
+  #
+```
+
+However, you are able to use pretty much any mechanics or mythic triggers that apply to players here, and call any other mythic skills, allowing you to use the mythic skill system to trigger all sorts of other random things you may want.
\ No newline at end of file