spell

This is the base action for how many of the game's spells (and spell adjacent) abilities function. These spells function off of a cooldown-based system.

Pre-spell checks:

can_cast_spell checks if the OWNER of the spell is able to cast the spell.
is_valid_target checks if the TARGET THE SPELL IS BEING CAST ON is a valid target for the spell. NOTE: The CAST TARGET is often THE SAME as THE OWNER OF THE SPELL, but is not always - depending on how Pre Activate is resolved.
try_invoke is run in can_cast_spell to check if the OWNER of the spell is able to say the current invocation.

The spell chain:

before_cast is the last chance for being able to interrupt a spell cast. This returns a bitflag. if SPELL_CANCEL_CAST is set, the spell will not continue.
spell_feedback is called right before cast, and handles invocation and sound effects. Overridable, if you want a special method of invocation or sound effects, or you want your spell to handle invocation / sound via special means.
cast is where the brunt of the spell effects should be done and implemented.
after_cast is the aftermath - final effects that follow the main cast of the spell. By now, the spell cooldown has already started

Other procs called / may be called within the chain:

invocation handles saying any vocal (or emotive) invocations the spell may have, and can be overriden or extended. Called by spell_feedback.
reset_spell_cooldown is a way to handle reverting a spell's cooldown and making it ready again if it fails to go off at any point. Not called anywhere by default. If you want to cancel a spell in before_cast and would like the cooldown restart, call this.

Other procs of note:

level_spell is where the process of adding a spell level is handled. this can be extended if you wish to add unique effects on level up for wizards.
delevel_spell is where the process of removing a spell level is handled. this can be extended if you wish to undo unique effects on level up for wizards.
get_spell_title returns the prefix of the spell name based on its level, for use in updating the button name / spell name.

Vars
antimagic_flags	This determines what type of antimagic is needed to block the spell. (MAGIC_RESISTANCE, MAGIC_RESISTANCE_MIND, MAGIC_RESISTANCE_HOLY) If SPELL_REQUIRES_NO_ANTIMAGIC is set in Spell requirements, The spell cannot be cast if the caster has any of the antimagic flags set.
cooldown_reduction_per_rank	If the spell uses the wizard spell rank system, the cooldown reduction per rank of the spell
invocation	What is uttered when the user casts the spell
invocation_self_message	What is shown in chat when the user casts the spell, only matters for INVOCATION_EMOTE
invocation_type	What type of invocation the spell is. Can be "none", "whisper", "shout", "emote"
school	The school of magic the spell belongs to. Checked by some holy sects to punish the caster for casting things that do not align with their sect's alignment - see magic.dm in defines to learn more
smoke_amt	The amount of smoke to create on cast. This is a range, so a value of 5 will create enough smoke to cover everything within 5 steps.
smoke_type	The typepath of the smoke to create on cast.
sound	The sound played on cast.
sparks_amt	If set to a positive number, the spell will produce sparks when casted.
spell_level	The current spell level, if taken multiple times by a wizard
spell_max_level	The max possible spell level
spell_requirements	Flag for certain states that the spell requires the user be in to cast.
Procs
after_cast	Actions done after the main cast is finished. This is called after the cooldown's already begun.
before_cast	Actions done before the actual cast is called. This is the last chance to cancel the spell from being cast.
can_cast_spell	Checks if the owner of the spell can currently cast it. Does not check anything involving potential targets.
cast	Actions done as the main effect of the spell.
delevel_spell	Levels the spell down a single level, down to 1.
get_spell_title	Gets the title of the spell based on its level.
invocation	The invocation that accompanies the spell, called from spell_feedback() before cast().
level_spell	Levels the spell up a single level, reducing the cooldown. If bypass_cap is TRUE, will level the spell up past it's set cap.
reset_spell_cooldown	Resets the cooldown of the spell, sending COMSIG_SPELL_CAST_RESET and allowing it to be used immediately (+ updating button icon accordingly)
spell_feedback	Provides feedback after a spell cast occurs, in the form of a cast sound and/or invocation
try_invoke	Checks if the current OWNER of the spell is in a valid state to say the spell's invocation

Var Details

var
antimagic_flags
–

This determines what type of antimagic is needed to block the spell. (MAGIC_RESISTANCE, MAGIC_RESISTANCE_MIND, MAGIC_RESISTANCE_HOLY) If SPELL_REQUIRES_NO_ANTIMAGIC is set in Spell requirements, The spell cannot be cast if the caster has any of the antimagic flags set.

var
cooldown_reduction_per_rank
–

If the spell uses the wizard spell rank system, the cooldown reduction per rank of the spell

var
invocation
–

What is uttered when the user casts the spell

var
invocation_self_message
–

What is shown in chat when the user casts the spell, only matters for INVOCATION_EMOTE

var
invocation_type
–

What type of invocation the spell is. Can be "none", "whisper", "shout", "emote"

var
school
–

The school of magic the spell belongs to. Checked by some holy sects to punish the caster for casting things that do not align with their sect's alignment - see magic.dm in defines to learn more

var
smoke_amt
–

The amount of smoke to create on cast. This is a range, so a value of 5 will create enough smoke to cover everything within 5 steps.

var
smoke_type
–

The typepath of the smoke to create on cast.

var
sound
–

The sound played on cast.

var
sparks_amt
–

If set to a positive number, the spell will produce sparks when casted.

var
spell_level
–

The current spell level, if taken multiple times by a wizard

var
spell_max_level
–

The max possible spell level

var
spell_requirements
–

Flag for certain states that the spell requires the user be in to cast.

Proc Details

proc
after_cast
(/atom/cast_on)

Actions done after the main cast is finished. This is called after the cooldown's already begun.

It can be used to apply late spell effects where order matters (for example, causing smoke after a teleport occurs in cast()) or to clean up variables or references post-cast.

proc
before_cast
(/atom/cast_on)

Actions done before the actual cast is called. This is the last chance to cancel the spell from being cast.

Can be used for target selection or to validate checks on the caster (cast_on).

Returns a bitflag.

SPELL_CANCEL_CAST will stop the spell from being cast.
SPELL_NO_FEEDBACK will prevent the spell from calling [proc/spell_feedback] on cast. (invocation), sounds)
SPELL_NO_IMMEDIATE_COOLDOWN will prevent the spell from starting its cooldown between cast and before after_cast.

proc
can_cast_spell
(feedback)

Checks if the owner of the spell can currently cast it. Does not check anything involving potential targets.

proc
cast
(/atom/cast_on)

Actions done as the main effect of the spell.

For spells without a click intercept, [cast_on] will be the owner. For click spells, [cast_on] is whatever the owner clicked on in casting the spell.

proc
delevel_spell
()

Levels the spell down a single level, down to 1.

proc
get_spell_title
()

Gets the title of the spell based on its level.

proc
invocation
()

The invocation that accompanies the spell, called from spell_feedback() before cast().

proc
level_spell
(bypass_cap)

Levels the spell up a single level, reducing the cooldown. If bypass_cap is TRUE, will level the spell up past it's set cap.

proc
reset_spell_cooldown
()

Resets the cooldown of the spell, sending COMSIG_SPELL_CAST_RESET and allowing it to be used immediately (+ updating button icon accordingly)

proc
spell_feedback
()

Provides feedback after a spell cast occurs, in the form of a cast sound and/or invocation

proc
try_invoke
(feedback)

Checks if the current OWNER of the spell is in a valid state to say the spell's invocation

The spell action /datum/action/cooldown/spell

Vars

Procs

Var Details

var antimagic_flags –

var cooldown_reduction_per_rank –

var invocation –

var invocation_self_message –

var invocation_type –

var school –

var smoke_amt –

var smoke_type –

var sound –

var sparks_amt –

var spell_level –

var spell_max_level –

var spell_requirements –