Wikis / MythicRPG / Spells / Learning

Learning

Spells can be learned by players in a variety of ways, and not all ways need to be used on your server.

Any castable spells a player learns will appear in their Spellbook.

Learnable Spells

Admin Commands

The most direct way to teach someone a spell:

/mythicrpg spells teach [player] [spell] (level)

You can also remove a spell with /mythicrpg spells unlearn [player] [spell], and list a player's known spells with /mythicrpg spells get [player].

Archetypes

Leveling

Spells can be configured to be granted automatically by an archetype upon reaching a certain level. Configured under an archetype's SpellUnlocks section.

Each entry is a single line with the format <spell>[:<spellLevel>] [<archetypeLevel>]:

<spell> — the spell id
<spellLevel> (optional) — the level the spell is taught at. Defaults to 1.
<archetypeLevel> (optional) — the archetype level at which the spell is unlocked. Defaults to the archetype's MinLevel.

Pyromancer:
  Group: CLASS
  Display: 'Pyromancer'
  SpellUnlocks:
  - Fireball
  - RainOfFire 10
  - Inferno:3 25

In this example:

Fireball is learned immediately upon gaining the Pyromancer archetype.
RainOfFire is learned upon reaching archetype level 10.
Inferno is learned at spell level 3 upon reaching archetype level 25.

If a player loses an archetype, all spells learned from it are removed.

Talent Trees

Talents can teach spells via the SPELL component. Investing additional points into the talent raises the taught spell's level. See Talents for the full configuration.

Cleave:
  Display: 'Cleave'
  MaxPoints: 5
  Components:
    - Type: SPELL
      Spell: warrior_cleave

Spells learned through a talent are removed if the talent is refunded or the player loses access to the tree.

Mechanics

Players can be taught spells with the teachRPGSpell mechanic (alias teachSpell) and have them removed with forgetRPGSpell (alias forgetSpell).

You can use these to build NPCs or Custom Menus that teach spells, hand a spell out as a boss-kill reward, or wire up custom tome-style items.

Skills:
- teachSpell{spell=DoubleJump} @trigger

Signs

Spell signs teach a spell when a player right-clicks them.

To create one, place a sign with [Learn Spell] (or [Learn Skill]) on the first line, and the spell's id on the second line.

Tomes

Tomes are custom written-book items that teach a spell when right-clicked. Hand them to players directly or place them in loot chests, etc.

Get a tome via the admin command:

/mythicrpg spells tome get [spell] (uses)

You can also specify a spell level by appending :<level> to the spell id, e.g. /mythicrpg spells tome get Fireball:3 1.

Globally Available Spells

Global Spells and Global Mechanics let you apply spells and mechanics to every player automatically.

Global Spells

Global Spells are spells that are auto-granted to everyone. Add Global: true to the metaskill:

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 config-spells.yml under Configuration.GlobalSkills. They are written like normal mob skill lines and apply to all online players.

The default config ships with an example that gives everyone basic mana regeneration:

Configuration:
  GlobalSkills:
  # Example of using this to implement global mana regeneration
  - modifyResource{resource=mana;amount=10} @self ~onTimer:20

You can use any mechanic and any trigger here that applies to players, including calls into your own custom mythic skills.

Core Plugins