martial_art

Vars
active	Are we being actively used by a mob?
combo_timer	The length of time until streaks are auto-reset.
current_target	Weakref to the last mob we attacked, for determining when to reset streaks
display_combos	If TRUE, a combo meter will be displayed on the HUD for the current streak
help_verb	Path to verb to display help text for this martial art.
holder	The current mob associated with this martial art datum. Do not set directly.
id	ID of the martial art
locked_to_use	If TRUE, the user is locked to using this martial art, and can't swap to other ones they know. If the mob has two locked martial arts, it's first come first serve.
max_streak_length	The maximum length of streaks allowed
name	Player readable name of the martial art
origin	Where this martial art is from, sometimes the same as the holder if it's tied to them If the origin is deleted, this martial art will be too.
pacifist_style	If TRUE, this style allows you to punch people despite being a pacifist (IE: Boxing, which does no damage)
smashes_tables	If TRUE, this martial art smashes tables when performing table slams and head smashes
streak	The streak of attacks the user has performed
timerid	Timer ID for the combo reset timer.
Procs
activate_style	Called when this martial art is added to a mob.
add_to_streak	Adds the passed element to the current streak, resetting it if the target is not the same as the last target.
attempt_grab	Signal proc for COMSIG_LIVING_GRAB to hook into the grab
can_teach	Checks if the passed mob can be taught this martial art.
can_use	Checks if the passed mob can use this martial art.
deactivate_style	Called when this martial art is removed from a mob.
disarm_act	Called when disarm-intenting on someone
grab_act	Called when grabbing someone
harm_act	Called when harm-intenting on someone
help_act	Called when help-intenting on someone
reset_streak	Resets the current streak.
teach	Teaches the passed mob this martial art.
unarmed_strike	Signal proc for COMSIG_LIVING_UNARMED_ATTACK to hook into the appropriate proc
unlearn	Removes this martial art from the passed mob.

Var Details

var
active
–

Are we being actively used by a mob?

var
combo_timer
–

The length of time until streaks are auto-reset.

var
current_target
– /datum/weakref

Weakref to the last mob we attacked, for determining when to reset streaks

var
display_combos
–

If TRUE, a combo meter will be displayed on the HUD for the current streak

var
help_verb
–

Path to verb to display help text for this martial art.

var
holder
– /mob/living

The current mob associated with this martial art datum. Do not set directly.

var
id
–

ID of the martial art

var
locked_to_use
–

If TRUE, the user is locked to using this martial art, and can't swap to other ones they know. If the mob has two locked martial arts, it's first come first serve.

var
max_streak_length
–

The maximum length of streaks allowed

var
name
–

Player readable name of the martial art

var
origin
– /datum

Where this martial art is from, sometimes the same as the holder if it's tied to them If the origin is deleted, this martial art will be too.

var
pacifist_style
–

If TRUE, this style allows you to punch people despite being a pacifist (IE: Boxing, which does no damage)

var
smashes_tables
–

If TRUE, this martial art smashes tables when performing table slams and head smashes

var
streak
– /final

The streak of attacks the user has performed

var
timerid
–

Timer ID for the combo reset timer.

Proc Details

proc
activate_style
(/mob/living/new_holder)

Called when this martial art is added to a mob.

proc
add_to_streak
(element, /mob/living/defender)

Adds the passed element to the current streak, resetting it if the target is not the same as the last target.

Arguments

element - The element to add to the streak. This is some one letter string.
mob/living/defender - The mob being attacked

proc
attempt_grab
(/mob/living/source, /mob/living/grabbing)

Signal proc for COMSIG_LIVING_GRAB to hook into the grab

proc
can_teach
(/mob/living/new_holder)

Checks if the passed mob can be taught this martial art.

Arguments

mob/living/new_holder - The mob to check

Returns

TRUE - The mob can be taught this martial art
FALSE - The mob cannot be taught this martial art

proc
can_use
(/mob/living/martial_artist)

Checks if the passed mob can use this martial art.

Arguments

mob/living/martial_artist - The mob to check

Returns

TRUE - The mob can use this martial art
FALSE - The mob cannot use this martial art

proc
deactivate_style
(/mob/living/remove_from)

Called when this martial art is removed from a mob.

proc
disarm_act
(/mob/living/attacker, /mob/living/defender)

Called when disarm-intenting on someone

What is checked going into this: Adjacency, TRAIT_MARTIAL_ARTS_IMMUNE, attacker incapacitated, can_unarmed_attack, can_use

What is NOT: check_block

Arguments

mob/living/attacker - The mob attacking
mob/living/defender - The mob being attacked

Returns

MARTIAL_ATTACK_INVALID - The attack is not valid, do normal unarmed attack
MARTIAL_ATTACK_FAIL - The attack is valid, but failed. No followup attack is made.
MARTIAL_ATTACK_SUCCESS - The attack is valid, and succeeded. No followup attack is made.

proc
grab_act
(/mob/living/attacker, /mob/living/defender)

Called when grabbing someone

What is checked going into this: Adjacency, TRAIT_MARTIAL_ARTS_IMMUNE, attacker incapacitated, can_unarmed_attack, can_use

What is NOT: check_block

Arguments

mob/living/attacker - The mob attacking
mob/living/defender - The mob being attacked

Returns

MARTIAL_ATTACK_INVALID - The attack is not valid, do normal unarmed attack
MARTIAL_ATTACK_FAIL - The attack is valid, but failed. No followup attack is made.
MARTIAL_ATTACK_SUCCESS - The attack is valid, and succeeded. No followup attack is made.

proc
harm_act
(/mob/living/attacker, /mob/living/defender)

Called when harm-intenting on someone

What is checked going into this: Adjacency, TRAIT_MARTIAL_ARTS_IMMUNE, attacker incapacitated, can_unarmed_attack, can_use

What is NOT: check_block

Arguments

mob/living/attacker - The mob attacking
mob/living/defender - The mob being attacked

Returns

MARTIAL_ATTACK_INVALID - The attack is not valid, do normal unarmed attack
MARTIAL_ATTACK_FAIL - The attack is valid, but failed. No followup attack is made.
MARTIAL_ATTACK_SUCCESS - The attack is valid, and succeeded. No followup attack is made.

proc
help_act
(/mob/living/attacker, /mob/living/defender)

Called when help-intenting on someone

What is checked going into this: Adjacency, TRAIT_MARTIAL_ARTS_IMMUNE, attacker incapacitated, can_unarmed_attack, can_use

What is NOT: check_block

Arguments

mob/living/attacker - The mob attacking
mob/living/defender - The mob being attacked

Returns

MARTIAL_ATTACK_INVALID - The attack is not valid, do normal unarmed attack
MARTIAL_ATTACK_FAIL - The attack is valid, but failed. No followup attack is made.
MARTIAL_ATTACK_SUCCESS - The attack is valid, and succeeded. No followup attack is made.

proc
reset_streak
(/mob/living/new_target, update_icon)

Resets the current streak.

Arguments

mob/living/new_target - (Optional) The mob being attacked while the reset is occurring.
update_icon - If TRUE, the combo display will be updated.

proc
teach
(/mob/living/new_holder)

Teaches the passed mob this martial art.

Arguments

mob/living/new_holder - The mob to teach this martial art to.

Returns

TRUE - The martial art was successfully taught.
FALSE - The mob failed to learn the martial art, for whatever reason.

proc
unarmed_strike
(/mob/living/source, /atom/attack_target, proximity, modifiers)

Signal proc for COMSIG_LIVING_UNARMED_ATTACK to hook into the appropriate proc

proc
unlearn
(/mob/living/old_holder)

Removes this martial art from the passed mob.

Arguments

mob/living/old_holder - The mob to remove this martial art from.

martial_art /datum/martial_art

Vars

Procs

Var Details

var active –

var combo_timer –

var current_target – /datum/weakref

var display_combos –

var help_verb –

var holder – /mob/living

var id –

var locked_to_use –

var max_streak_length –

var name –

var origin – /datum

var pacifist_style –

var smashes_tables –

var streak – /final

var timerid –

Proc Details

proc activate_style(/mob/living/new_holder)

proc add_to_streak(element, /mob/living/defender)

proc attempt_grab(/mob/living/source, /mob/living/grabbing)

proc can_teach(/mob/living/new_holder)

proc can_use(/mob/living/martial_artist)

proc deactivate_style(/mob/living/remove_from)

proc disarm_act(/mob/living/attacker, /mob/living/defender)

proc grab_act(/mob/living/attacker, /mob/living/defender)

proc harm_act(/mob/living/attacker, /mob/living/defender)

proc help_act(/mob/living/attacker, /mob/living/defender)

proc reset_streak(/mob/living/new_target, update_icon)

proc teach(/mob/living/new_holder)

proc unarmed_strike(/mob/living/source, /atom/attack_target, proximity, modifiers)

proc unlearn(/mob/living/old_holder)

martial_art
/datum/martial_art

var
active
–

var
combo_timer
–

var
current_target
– /datum/weakref

var
display_combos
–

var
help_verb
–

var
holder
– /mob/living

var
id
–

var
locked_to_use
–

var
max_streak_length
–

var
name
–

var
origin
– /datum

var
pacifist_style
–

var
smashes_tables
–

var
streak
– /final

var
timerid
–

proc
activate_style
(/mob/living/new_holder)

proc
add_to_streak
(element, /mob/living/defender)

proc
attempt_grab
(/mob/living/source, /mob/living/grabbing)

proc
can_teach
(/mob/living/new_holder)

proc
can_use
(/mob/living/martial_artist)

proc
deactivate_style
(/mob/living/remove_from)

proc
disarm_act
(/mob/living/attacker, /mob/living/defender)

proc
grab_act
(/mob/living/attacker, /mob/living/defender)

proc
harm_act
(/mob/living/attacker, /mob/living/defender)

proc
help_act
(/mob/living/attacker, /mob/living/defender)

proc
reset_streak
(/mob/living/new_target, update_icon)

proc
teach
(/mob/living/new_holder)

proc
unarmed_strike
(/mob/living/source, /atom/attack_target, proximity, modifiers)

proc
unlearn
(/mob/living/old_holder)