Active (or on-use) spells can be cast in a variety of ways depending on how the server is configured.

Casting Spells

by Command

Any active learned spell can be cast with /cast <spell> as long as the player has permission to use the command.

While not the fastest way to cast, it's the most basic and does not require any binding setup.

from the Spellbook

Active spells can be cast directly from the Spellbook menu (/spellbook). Left-clicking a usable spell casts it. Right-clicking opens the binding window so the player can assign that spell to a quickcast slot (when player bindings are enabled).

Quickcasting

Quickcasting lets a player cast their bound spells without typing commands. It's configured server-wide in config-spells.yml under Configuration.Casting.QuickCasting. Pick one of the methods below by setting QuickCasting.Method:.

The method can be activated by an in-game action set under QuickCasting.Activation:

Common Options

These apply regardless of Method, set under Configuration.Casting.QuickCasting:

HOTBAR — Cast Bar

The cast bar can hold up to a configured number of bound spells (default 5, max 9). When toggled on, the player taps the slot number to cast the spell bound there.

QuickCasting.Location controls where the bar is rendered:

• ITEMS — overlays spell icons on the player's hotbar
• ACTION_MESSAGE — renders bound spells on the action bar using unicode icons
• TITLE / SUBTITLE — renders into the title area
• MYTHICHUD — renders via Mythic HUD
• NONE — no display

The render target is chosen by Display.Type (see Common Options); Location is the older key and is used only when Display.Type is unset.

Hotbar-specific options under Configuration.Casting.QuickCasting.HotBar:

CLICK_COMBO — Click / Dance Combos

The player toggles the combo input mode, then enters a short sequence of inputs to cast a spell. There are two modes set under Configuration.Casting.QuickCasting.ClickCombos.Mode:

• SLOTS — slot-based combos. Each binding slot has a fixed input pattern (e.g. slot 1 = LL, slot 2 = LR). Whichever slot's combo matches casts the spell bound to that slot.
• SPELLS — spell-defined combos. Each spell with a ClickCombo: or ClickCombos: value casts when its pattern is matched, regardless of bindings.

Available Inputs

A combo pattern is a sequence of input tokens. Available tokens:

UseMovementKeys: true enables W/A/S/D/J for "dance casting" — building combos from movement directions instead of (or alongside) clicks.

If the activator is set to SWAP_HANDS or DROP_ITEM, those keys are consumed for toggling the combo mode and become unavailable as combo inputs while the activator is active.

Notable Tuning Options

All configured under Configuration.Casting.QuickCasting.ClickCombos:

Display Hints

With ClickCombos.Display.ShowHints: true, the combo overlay shows the next valid inputs after the buffer. IconMap: lets you replace each input token with custom Unicode/font characters for in-world icons.

EmptyText sets what is shown between the overlay prefix and suffix while the buffer is empty (default <dark_gray>...</dark_gray>). Set it to "" to show nothing until the first input.

The hint string is wrapped with these options under ClickCombos.Display:

Configuration:
  Casting:
    QuickCasting:
      Method: CLICK_COMBO
      Activation: SWAP_HANDS
      Location: ACTION_MESSAGE
      ClickCombos:
        Mode: SLOTS
        ComboLength: 3
        AllowedInputs: [L, R]
        Slots:
          1: LLL
          2: LLR
          3: LRL
          4: LRR
        Display:
          EmptyText: "<dark_gray>...</dark_gray>"
          ShowHints: true
          IconMap:
            L: '⬅'
            R: '➡'

Spell-Side Configuration

A spell can declare its own click combo(s) using ClickCombo: (single) or ClickCombos: (list) in the spell config. These are used in SPELLS mode, or in SLOTS mode when AllowSpellCombosWithBindings is enabled.

fireball:
  Spell: true
  Trigger: ~onUse
  ClickCombos:
    - LRL
    - RRL
  Skills:
    - projectile{...}

Global Cooldown

By default each spell only has its own cooldown, so a player with several off-cooldown spells can fire all of them in the same tick. GlobalCooldown sets a minimum delay between any two spell casts by the same player.

Configuration:
  Casting:
    GlobalCooldown: 1s     # also accepts ticks and milliseconds: '20t', '500ms'

Details:

• It applies to every casting route: /cast, the spellbook, the quickcast hotbar, click combos, and the castSpell mechanic.
• The cooldown starts when a cast is initiated, not when it finishes. For a spell with a CastTime, it starts the moment the cast bar appears, so a player cannot slip an instant spell in while a long cast is running. A cast that is cancelled part-way still spends the global cooldown.
• A cast blocked by the global cooldown fails before any targeting, reagent or condition check runs, so nothing is consumed. The player gets the spell.cast.failed.global-cooldown message.
• It is a single server-wide value. It is not per-spell, and it is not affected by the CASTING_SPEED stat.
• Passive (non ~onUse) spells are never gated by it.
• Because castSpell casts a spell as if the target used it themselves, it is gated too. A skill that chains several castSpell mechanics at one target will only land the first while a global cooldown is set. Use the spell's Skills: list directly if you need several effects to fire together.

Cast Time

A spell with a CastTime: value runs through the cast-time pipeline before its skills execute: a cast bar is shown, the cast can be cancelled or pushed back, reagents can be deferred until completion, and lifecycle triggers (~onSpellCastStart, ~onSpellCastComplete, ~onSpellCastCancel, ~onSpellCastInterrupt, ~onSpellCastPushback) fire at the appropriate moments.

The base cast time is divided by the caster's CASTING_SPEED stat — a CASTING_SPEED of 2.0 makes a 2s cast take 1s.

A CastTime of 0 (the default) makes the spell instant; the cast pipeline is bypassed entirely.

Spell-Level Options

fireball:
  Spell: true
  Trigger: ~onUse
  CastTime: 2s          # also accepts ticks: '40t'
  Cost:
  - mana 40
  Casting:
    InstantCastThreshold: 4t
    UsabilityCheck: START
    ReagentTiming: FINISH
    RefundReagentsOnCancel: true
    CancelOnMove: true
    MovementTolerance: 0.0
    CancelOnDamage: false
    CancelOnInteraction: true
    Interruptible: true
    DamagePushback:
      Enabled: false
      Amount: 0.5s
      Max: 1s
    ReevaluateTargets: false
    ConcurrentPolicy: REJECT
    StatModifiers:
    - MOVEMENT_SPEED -0.9 ADDITIVE_MULTIPLIER
  Skills:
  - projectile{...}

StatModifiers accepts the standard line form (STAT_NAME VALUE [OPERATION]) or a section form:

Casting:
  StatModifiers:
  - MOVEMENT_SPEED -0.9 ADDITIVE_MULTIPLIER
  # or:
  - MOVEMENT_SPEED:
      Value: -0.9
      Operation: ADDITIVE_MULTIPLIER

Operations match Mythic stat modifier operations: ADDITIVE, ADDITIVE_MULTIPLIER, COMPOUND_MULTIPLIER, SETTER.

Server-Wide Defaults

Every option above can be set globally under Configuration.Casting.CastTime.Defaults in config-spells.yml. Per-spell Casting: blocks override the defaults.

Configuration:
  Casting:
    CastTime:
      Defaults:
        CastTime: 0
        InstantCastThreshold: 4t
        UsabilityCheck: START
        ReagentTiming: FINISH
        RefundReagentsOnCancel: true
        CancelOnMove: true
        MovementTolerance: 0.0
        CancelOnDamage: false
        CancelOnInteraction: true
        Interruptible: true
        DamagePushback:
          Enabled: false
          Amount: 0.5s
          Max: 1s
        ReevaluateTargets: false
        ConcurrentPolicy: REJECT
        StatModifiers: []

The Cast Bar

While a cast-time spell is being cast, a configurable cast bar is shown to the player. It is configured globally under Configuration.Casting.CastTime.Display:

Format placeholders:

CASTING_SPEED Stat

CASTING_SPEED is a Mythic stat added by MythicRPG. It scales how fast a player (or Mythic mob) finishes a cast:

adjusted cast time = base cast time / CASTING_SPEED

A CASTING_SPEED of 2.0 makes a 2s cast finish in 1s. A CASTING_SPEED of 0.5 makes a 2s cast take 4s. If the adjusted cast time falls at or below Casting.InstantCastThreshold, the spell casts instantly.

Lifecycle Triggers and Mechanics