martial_art 
Vars | |
| active | Are we being actively used by a mob? |
|---|---|
| combo_display | The Combo HUD given to display comboes, if we're set to display them. |
| 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 |
| on_hud_created | Gives the owner of the martial art the combo HUD. |
| 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
active
Are we being actively used by a mob?
combo_display
The Combo HUD given to display comboes, if we're set to display them.
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.
Proc Details
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.
Arguments
- element - The element to add to the streak. This is some one letter string.
- mob/living/defender - The mob being attacked
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.
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
can_use
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
deactivate_style
Called when this martial art is removed from a mob.
disarm_act
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.
grab_act
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.
harm_act
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.
help_act
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.
on_hud_created
Gives the owner of the martial art the combo HUD.
reset_streak
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.
teach
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.
unarmed_strike
Signal proc for COMSIG_LIVING_UNARMED_ATTACK to hook into the appropriate proc
unlearn
Removes this martial art from the passed mob.
Arguments
- mob/living/old_holder - The mob to remove this martial art from.