status_effect

Vars
alert_type	The typepath to the alert thrown by the status effect when created. Status effect "name"s and "description"s are shown to the owner here.
duration	When set initially / in on_creation, this is how long the status effect lasts in deciseconds. While processing, this becomes the world.time when the status effect will expire. -1 = infinite duration.
examine_text	If defined, this text will appear when the mob is examined - to use he, she etc. use "SUBJECTPRONOUN" and replace it in the examines themselves
id	The ID of the effect. ID is used in adding and removing effects to check for duplicates, among other things.
linked_alert	The alert itself, created in [proc/on_creation] (if alert_type is specified).
on_remove_on_mob_delete	If TRUE, we call [proc/on_remove] when owner is deleted. Otherwise, we call [proc/be_replaced].
owner	The mob affected by the status effect.
processing_speed	Used to define if the status effect should be using SSfastprocess or SSprocessing
status_type	How many of the effect can be on one mob, and/or what happens when you try to add a duplicate.
tick_interval	When set initially / in on_creation, this is how long between [proc/tick] calls in deciseconds. Note that this cannot be faster than the processing subsystem you choose to fire the effect on. (See: [var/processing_speed]) While processing, this becomes the world.time when the next tick will occur. -1 = will prevent ticks, and if duration is also unlimited (-1), stop processing wholesale.
Procs
be_replaced	Called instead of on_remove when a status effect of status_type STATUS_EFFECT_REPLACE is replaced by itself, or when a status effect with on_remove_on_mob_delete set to FALSE has its mob deleted
before_remove	Called before being fully removed (before on_remove) Returning FALSE will cancel removal
get_examine_text	Gets and formats examine text associated with our status effect. Return 'null' to have no examine text appear (default behavior).
nextmove_adjust	Adds nextmove adjustment additiviely to the owner while applied
nextmove_modifier	Adds nextmove modifier multiplicatively to the owner while applied
on_apply	Called whenever the effect is applied in on_created Returning FALSE will cause it to delete itself during creation instead.
on_creation	Called from New() with any supplied status effect arguments. Not guaranteed to exist by the end. Returning FALSE from on_apply will stop on_creation and self-delete the effect.
on_remove	Called whenever the buff expires or is removed (qdeleted) Note that at the point this is called, it is out of the owner's status_effects list, but owner is not yet null
on_timeout	Called specifically whenever the status effect expires.
refresh	Called when a status effect of status_type STATUS_EFFECT_REFRESH has its duration refreshed in apply_status_effect - is passed New() args
remove_duration	Remove [seconds] of duration from the status effect, qdeling / ending if we eclipse the current world time.
tick	Called every tick from process(). This is only called of tick_interval is not -1.

Var Details

var
alert_type
–

The typepath to the alert thrown by the status effect when created. Status effect "name"s and "description"s are shown to the owner here.

var
duration
–

When set initially / in on_creation, this is how long the status effect lasts in deciseconds. While processing, this becomes the world.time when the status effect will expire. -1 = infinite duration.

var
examine_text
–

If defined, this text will appear when the mob is examined - to use he, she etc. use "SUBJECTPRONOUN" and replace it in the examines themselves

var
id
–

The ID of the effect. ID is used in adding and removing effects to check for duplicates, among other things.

var
linked_alert
– /atom/movable/screen/alert/status_effect

The alert itself, created in [proc/on_creation] (if alert_type is specified).

var
on_remove_on_mob_delete
–

If TRUE, we call [proc/on_remove] when owner is deleted. Otherwise, we call [proc/be_replaced].

var
owner
– /mob/living

The mob affected by the status effect.

var
processing_speed
–

Used to define if the status effect should be using SSfastprocess or SSprocessing

var
status_type
–

How many of the effect can be on one mob, and/or what happens when you try to add a duplicate.

var
tick_interval
–

When set initially / in on_creation, this is how long between [proc/tick] calls in deciseconds. Note that this cannot be faster than the processing subsystem you choose to fire the effect on. (See: [var/processing_speed]) While processing, this becomes the world.time when the next tick will occur. -1 = will prevent ticks, and if duration is also unlimited (-1), stop processing wholesale.

Proc Details

proc
be_replaced
()

Called instead of on_remove when a status effect of status_type STATUS_EFFECT_REPLACE is replaced by itself, or when a status effect with on_remove_on_mob_delete set to FALSE has its mob deleted

proc
before_remove
()

Called before being fully removed (before on_remove) Returning FALSE will cancel removal

proc
get_examine_text
()

Gets and formats examine text associated with our status effect. Return 'null' to have no examine text appear (default behavior).

proc
nextmove_adjust
()

Adds nextmove adjustment additiviely to the owner while applied

proc
nextmove_modifier
()

Adds nextmove modifier multiplicatively to the owner while applied

proc
on_apply
()

Called whenever the effect is applied in on_created Returning FALSE will cause it to delete itself during creation instead.

proc
on_creation
(/mob/living/new_owner, ...)

Called from New() with any supplied status effect arguments. Not guaranteed to exist by the end. Returning FALSE from on_apply will stop on_creation and self-delete the effect.

proc
on_remove
()

Called whenever the buff expires or is removed (qdeleted) Note that at the point this is called, it is out of the owner's status_effects list, but owner is not yet null

proc
on_timeout
()

Called specifically whenever the status effect expires.

proc
refresh
(effect, ...)

Called when a status effect of status_type STATUS_EFFECT_REFRESH has its duration refreshed in apply_status_effect - is passed New() args

proc
remove_duration
(seconds)

Remove [seconds] of duration from the status effect, qdeling / ending if we eclipse the current world time.

proc
tick
(seconds_between_ticks)

Called every tick from process(). This is only called of tick_interval is not -1.

Note that every tick =/= every processing cycle.

seconds_between_ticks = This is how many SECONDS that elapse between ticks. This is a constant value based upon the initial tick interval set on the status effect. It is similar to seconds_per_tick, from processing itself, but adjusted to the status effect's tick interval.

status_effect /datum/status_effect

Vars

Procs

Var Details

var alert_type –

var duration –

var examine_text –

var id –

var linked_alert – /atom/movable/screen/alert/status_effect

var on_remove_on_mob_delete –

var owner – /mob/living

var processing_speed –

var status_type –

var tick_interval –

Proc Details

proc be_replaced()

proc before_remove()

proc get_examine_text()

proc nextmove_adjust()

proc nextmove_modifier()

proc on_apply()

proc on_creation(/mob/living/new_owner, ...)

proc on_remove()

proc on_timeout()

proc refresh(effect, ...)

proc remove_duration(seconds)

proc tick(seconds_between_ticks)