grab

Vars
breakability	The baseline index of break_chance_table, before modifiers. This can be higher than the length of break_chance_table.
can_absorb	Whether this grab state is strong enough to, as a changeling, absorb the person you're grabbing.
can_throw	If the grabber can throw the person grabbed.
damage_stage	Affects how much damage is being dealt using certain actions.
downgrab	The grab that this will downgrade to if it downgrades, null means break grab on downgrade
downgrade_on_action	If the grab needs to be downgraded when the grabber does stuff.
downgrade_on_move	If the grab needs to be downgraded when the grabber moves.
enable_violent_interactions	If the grab is strong enough to be able to force someone to do something harmful to them, like slam their head into glass.
point_blank_mult	How much the grab increases point blank damage.
restrains	If the grab acts like cuffs and prevents action from the victim.
same_tile	If the grabbed person and the grabbing person are on the same tile.
upgrab	The grab that this will upgrade to if it upgrades, null means no upgrade
Procs
add_context	Add screentip context, user will always be assailant.
apply_unique_grab_effects	Apply effects that should only be applied when a grab type is first used on a mob.
enter_as_down	Return TRUE unless the grab state is changing during this proc (for example, calling upgrade())
enter_as_up	Return TRUE unless the grab state is changing during this proc (for example, calling upgrade())
handle_resist	Handle resist actions from the affected mob. Returns TRUE if the grab was broken.
let_go	DO NOT CALL THIS DIRECTLY GOOD LORD!!! This should ONLY be called by /obj/item/hand_item/grab/Destroy()
refresh_updown	Called during world/New to setup references.
remove_bodyzone_effects	Clear out any effects from special_bodyzone_effects()
remove_unique_grab_effects	Remove effects added by apply_unique_grab_effects()
setup	Called by the grab item's setup() proc. May return FALSE to interrupt, otherwise the grab has succeeded.
special_bodyzone_effects	Handles special targeting like eyes and mouth being covered. CLEAR OUT ANY EFFECTS USING remove_bodyzone_effects()
update_stage_effects	Add effects that apply based on damage_stage here

Var Details

var
breakability
–

The baseline index of break_chance_table, before modifiers. This can be higher than the length of break_chance_table.

var
can_absorb
–

Whether this grab state is strong enough to, as a changeling, absorb the person you're grabbing.

var
can_throw
–

If the grabber can throw the person grabbed.

var
damage_stage
–

Affects how much damage is being dealt using certain actions.

var
downgrab
– /datum/grab

The grab that this will downgrade to if it downgrades, null means break grab on downgrade

var
downgrade_on_action
–

If the grab needs to be downgraded when the grabber does stuff.

var
downgrade_on_move
–

If the grab needs to be downgraded when the grabber moves.

var
enable_violent_interactions
–

If the grab is strong enough to be able to force someone to do something harmful to them, like slam their head into glass.

var
point_blank_mult
–

How much the grab increases point blank damage.

var
restrains
–

If the grab acts like cuffs and prevents action from the victim.

var
same_tile
–

If the grabbed person and the grabbing person are on the same tile.

var
upgrab
– /datum/grab

The grab that this will upgrade to if it upgrades, null means no upgrade

Proc Details

proc
add_context
(/list/context, /obj/item/held_item, /mob/living/user, /atom/movable/target)

Add screentip context, user will always be assailant.

proc
apply_unique_grab_effects
(/atom/movable/affecting)

Apply effects that should only be applied when a grab type is first used on a mob.

proc
enter_as_down
(/obj/item/hand_item/grab/G, silent)

Return TRUE unless the grab state is changing during this proc (for example, calling upgrade())

proc
enter_as_up
(/obj/item/hand_item/grab/G, silent)

Return TRUE unless the grab state is changing during this proc (for example, calling upgrade())

proc
handle_resist
(/obj/item/hand_item/grab/G)

Handle resist actions from the affected mob. Returns TRUE if the grab was broken.

proc
let_go
(/obj/item/hand_item/grab/G)

DO NOT CALL THIS DIRECTLY GOOD LORD!!! This should ONLY be called by /obj/item/hand_item/grab/Destroy()

proc
refresh_updown
()

Called during world/New to setup references.

proc
remove_bodyzone_effects
(/obj/item/hand_item/grab/G, old_zone, new_zone)

Clear out any effects from special_bodyzone_effects()

proc
remove_unique_grab_effects
(/atom/movable/affecting)

Remove effects added by apply_unique_grab_effects()

proc
setup
(/obj/item/hand_item/grab)

Called by the grab item's setup() proc. May return FALSE to interrupt, otherwise the grab has succeeded.

proc
special_bodyzone_effects
(/obj/item/hand_item/grab/G)

Handles special targeting like eyes and mouth being covered. CLEAR OUT ANY EFFECTS USING remove_bodyzone_effects()

proc
update_stage_effects
(/obj/item/hand_item/grab/G, /datum/grab/old_grab, dropping_grab)

Add effects that apply based on damage_stage here

grab /datum/grab

Vars

Procs

Var Details

var breakability –

var can_absorb –

var can_throw –

var damage_stage –

var downgrab – /datum/grab

var downgrade_on_action –

var downgrade_on_move –

var enable_violent_interactions –

var point_blank_mult –

var restrains –

var same_tile –

var upgrab – /datum/grab

Proc Details

proc add_context(/list/context, /obj/item/held_item, /mob/living/user, /atom/movable/target)

proc apply_unique_grab_effects(/atom/movable/affecting)

proc enter_as_down(/obj/item/hand_item/grab/G, silent)

proc enter_as_up(/obj/item/hand_item/grab/G, silent)

proc handle_resist(/obj/item/hand_item/grab/G)

proc let_go(/obj/item/hand_item/grab/G)

proc refresh_updown()

proc remove_bodyzone_effects(/obj/item/hand_item/grab/G, old_zone, new_zone)

proc remove_unique_grab_effects(/atom/movable/affecting)

proc setup(/obj/item/hand_item/grab)

proc special_bodyzone_effects(/obj/item/hand_item/grab/G)

proc update_stage_effects(/obj/item/hand_item/grab/G, /datum/grab/old_grab, dropping_grab)