carbon

Vars
all_scars	All of the scars a carbon has afflicted throughout their limbs
all_wounds	All of the wounds a carbon has afflicted throughout their limbs
dreaming	How many dream images we have left to send
external	"External" air tank. Never set this manually. Not required to stay directly equipped on the mob (i.e. could be a machine or MOD suit module).
handcuffed	A reference to the current handcuff on this carbon if one is equipped.
internal	Equipped air tank. Never set this manually.
internal_organs	List of /obj/item/organ in the mob. They don't go in the contents for some reason I don't want to know.
internal_organs_slot	List of /obj/item/organ in the mob by slot ID for easy access. They don't go in the contents for some reason I don't want to know.
legcuffed	A reference to the current legcuff on this carbon if one is equipped. Bear traps use this.
silent	Can't talk. Value goes down every life proc. NOTE TO FUTURE CODERS: DO NOT INITIALIZE NUMERICAL VARS AS NULL OR I WILL MURDER YOU.
transformation_timer	Timer id of any transformation
visual_only_organs	Only load in visual organs
Procs
adjustOrganLoss
adjustPlasma	Adjusts the plasma level of the carbon's plasma vessel if they have one
bleed_warn	bleed_warn() is used to for carbons with an active client to occasionally receive messages warning them about their bleeding status (if applicable)
can_breathe_helmet	Returns TRUE if an air tank compatible helmet is equipped.
can_breathe_internals	Returns TRUE if an air tank compatible mask or breathing tube is equipped.
can_breathe_mask	Returns TRUE if an air tank compatible mask is equipped.
can_breathe_tube	Returns TRUE if a breathing tube is equipped.
check_virus	Medical HUD! Basic mode needs suit sensors on.
clear_stamina_regen	Clears dynamic stamina regeneration on all limbs, typically used for continuous buildup like chems.
close_all_airtanks	Quickly/lazily close all airtanks without any returns or notifications.
close_externals	Close the the currently open external (that's EX-ternal) air tank. Returns TREUE if successful.
close_internals	Actually closes the active internal or external air tank. Returns TRUE if the tank was opened successfully.
cutoff_internals	Prepares emergency disconnect from open air tanks and notifies in chat. Usually called after mob suddenly unequips breathing apparatus.
embed_object	Embeds an object into this carbon
generate_fake_scars	generate_fake_scars()- for when you want to scar someone, but you don't want to hurt them first. These scars don't count for temporal scarring (hence, fake)
getOrganLoss
getPlasma	Gets the plasma level of this carbon's plasma vessel, or -1 if they don't have one
get_biological_state	get_biological_state is a helper used to see what kind of wounds we roll for. By default we just assume carbons (read:monkeys) are flesh and bone, but humans rely on their species datums
get_bleed_rate	A helper to see how much blood we're losing per tick
get_blood_dna_list	Get the mobs dna list
get_embedded_objects	Returns a list of all embedded objects
get_embedded_part	Returns the bodypart that the item is embedded in or returns false if it is not currently embedded
get_total_bleed_rate	get our total bleedrate
get_wounded_bodyparts	Returns a list of bodyparts with wounds (in case someone has a wound on an otherwise fully healed limb)
handle_breath_temperature	Fourth and final link in a breath chain
handle_liver	Decides if the liver is failing or not.
humanize	Humanize
immortality	For the Wishgranter
invalid_internals	Returns truthy if air tank is open and mob lacks apparatus, or if the tank moved away from the mob.
is_bleeding	if any of our bodyparts are bleeding
open_internals	Open the internal air tank without checking for any breathing apparatus. Returns TRUE if the air tank was opened successfully. Closes any existing tanks before opening another one.
remove_embedded_object	Removes the given embedded object from this carbon
secondary_shock	Called slightly after electrocute act to apply a secondary stun.
setOrganLoss
should_electrocute	Returns whether or not the carbon should be able to be shocked
spray_blood	This proc is a helper for spraying blood for things like slashing/piercing wounds and dismemberment.
toggle_close_internals	Prepares to close the currently open internal air tank and notifies in chat. Handles displaying messages to the user before doing the actual closing. Returns TRUE if
toggle_externals	Toggles the given external (that's EX-ternal) air tank open, or close the currently open one, if a compatible breathing apparatus is found. Returns TRUE if the tank was opened successfully.
toggle_internals	Toggles the given internal air tank open, or close the currently open one, if a compatible breathing apparatus is found. Returns TRUE if the tank was opened successfully.
toggle_open_internals	Prepares to open the internal air tank and notifies the mob in chat. Handles displaying messages to the user before doing the actual opening. Returns TRUE if the tank was opened/closed successfully.
try_open_internals	Opens the given internal air tank if a breathing apparatus is found. Returns TRUE if successful, FALSE otherwise. Returns TRUE if the tank was opened successfully.
try_remove_embedded_object	Called when a mob tries to remove an embedded object from this carbon
wearing_shock_proof_gloves	Returns if the carbon is wearing shock proof gloves

Var Details

var
all_scars
– /list

All of the scars a carbon has afflicted throughout their limbs

var
all_wounds
– /list

All of the wounds a carbon has afflicted throughout their limbs

var
dreaming
–

How many dream images we have left to send

var
external
– /obj/item/tank

"External" air tank. Never set this manually. Not required to stay directly equipped on the mob (i.e. could be a machine or MOD suit module).

var
handcuffed
– /obj/item/restraints

A reference to the current handcuff on this carbon if one is equipped.

var
internal
– /obj/item/tank

Equipped air tank. Never set this manually.

var
internal_organs
– /list

List of /obj/item/organ in the mob. They don't go in the contents for some reason I don't want to know.

var
internal_organs_slot
– /list

List of /obj/item/organ in the mob by slot ID for easy access. They don't go in the contents for some reason I don't want to know.

var
legcuffed
– /obj/item/restraints

A reference to the current legcuff on this carbon if one is equipped. Bear traps use this.

var
silent
–

Can't talk. Value goes down every life proc. NOTE TO FUTURE CODERS: DO NOT INITIALIZE NUMERICAL VARS AS NULL OR I WILL MURDER YOU.

var
transformation_timer
–

Timer id of any transformation

var
visual_only_organs
–

Only load in visual organs

Proc Details

adjustOrganLoss
(slot, amount, maximum)

adjustOrganLoss
- inputs: slot (organ slot, like ORGAN_SLOT_HEART), amount (damage to be done), and maximum (currently an arbitrarily large number, can be set so as to limit damage)
- outputs:
- description: If an organ exists in the slot requested, and we are capable of taking damage (we don't have GODMODE on), call the damage proc on that organ.

proc
adjustPlasma
(amount)

Adjusts the plasma level of the carbon's plasma vessel if they have one

proc
bleed_warn
(bleed_amt, forced)

bleed_warn() is used to for carbons with an active client to occasionally receive messages warning them about their bleeding status (if applicable)

Arguments:

bleed_amt- When we run this from [/mob/living/carbon/human/proc/handle_blood] we already know how much blood we're losing this tick, so we can skip tallying it again with this
forced-

proc
can_breathe_helmet
()

Returns TRUE if an air tank compatible helmet is equipped.

proc
can_breathe_internals
()

Returns TRUE if an air tank compatible mask or breathing tube is equipped.

proc
can_breathe_mask
()

Returns TRUE if an air tank compatible mask is equipped.

proc
can_breathe_tube
()

Returns TRUE if a breathing tube is equipped.

proc
check_virus
()

Medical HUD! Basic mode needs suit sensors on.

clear_stamina_regen
()

Clears dynamic stamina regeneration on all limbs, typically used for continuous buildup like chems.

Make sure it's used AFTER stamina damage is applied.

proc
close_all_airtanks
()

Quickly/lazily close all airtanks without any returns or notifications.

proc
close_externals
()

Close the the currently open external (that's EX-ternal) air tank. Returns TREUE if successful.

proc
close_internals
(is_external)

Actually closes the active internal or external air tank. Returns TRUE if the tank was opened successfully.

Arguments:

is_external - A boolean which indicates if the air tank must be equipped, or stored elsewhere.

proc
cutoff_internals
()

Prepares emergency disconnect from open air tanks and notifies in chat. Usually called after mob suddenly unequips breathing apparatus.

proc
embed_object
(/obj/item/embedding, part, deal_damage, silent, forced)

Embeds an object into this carbon

proc
generate_fake_scars
(num_scars, forced_type)

generate_fake_scars()- for when you want to scar someone, but you don't want to hurt them first. These scars don't count for temporal scarring (hence, fake)

If you want a specific wound scar, pass that wound type as the second arg, otherwise you can pass a list like WOUND_LIST_SLASH to generate a random cut scar.

Arguments:

num_scars- A number for how many scars you want to add
forced_type- Which wound or category of wounds you want to choose from, WOUND_LIST_BLUNT, WOUND_LIST_SLASH, or WOUND_LIST_BURN (or some combination). If passed a list, picks randomly from the listed wounds. Defaults to all 3 types

getOrganLoss
(slot)

getOrganLoss
- inputs: slot (organ slot, like ORGAN_SLOT_HEART)
- outputs: organ damage
- description: If an organ exists in the slot requested, return the amount of damage that organ has

proc
getPlasma
()

Gets the plasma level of this carbon's plasma vessel, or -1 if they don't have one

proc
get_biological_state
()

get_biological_state is a helper used to see what kind of wounds we roll for. By default we just assume carbons (read:monkeys) are flesh and bone, but humans rely on their species datums

go look at the species def for more info /datum/species/proc/get_biological_state

proc
get_bleed_rate
()

A helper to see how much blood we're losing per tick

↑
get_blood_dna_list
()

Get the mobs dna list

proc
get_embedded_objects
()

Returns a list of all embedded objects

proc
get_embedded_part
(/obj/item/embedded)

Returns the bodypart that the item is embedded in or returns false if it is not currently embedded

proc
get_total_bleed_rate
()

get our total bleedrate

proc
get_wounded_bodyparts
(brute, burn, stamina, status)

Returns a list of bodyparts with wounds (in case someone has a wound on an otherwise fully healed limb)

proc
handle_breath_temperature
(/datum/gas_mixture/breath)

Fourth and final link in a breath chain

proc
handle_liver
()

Decides if the liver is failing or not.

proc
humanize
(tr_flags, /datum/changelingprofile/chosen_prof)

Humanize

proc
immortality
()

For the Wishgranter

proc
invalid_internals
()

Returns truthy if air tank is open and mob lacks apparatus, or if the tank moved away from the mob.

proc
is_bleeding
()

if any of our bodyparts are bleeding

proc
open_internals
(/obj/item/tank/target_tank, is_external)

Open the internal air tank without checking for any breathing apparatus. Returns TRUE if the air tank was opened successfully. Closes any existing tanks before opening another one.

Arguments:

tank - The given tank to open and start breathing from.
is_external - A boolean which indicates if the air tank must be equipped, or stored elsewhere.

proc
remove_embedded_object
(/obj/item/embedded, new_loc, silent, forced, unsafe)

Removes the given embedded object from this carbon

proc
secondary_shock
(should_stun, stuntime)

Called slightly after electrocute act to apply a secondary stun.

setOrganLoss
(slot, amount)

setOrganLoss
- inputs: slot (organ slot, like ORGAN_SLOT_HEART), amount(damage to be set to)
- outputs:
- description: If an organ exists in the slot requested, and we are capable of taking damage (we don't have GODMODE on), call the set damage proc on that organ, which can
- ```
		 set or clear the failing variable on that organ, making it either cease or start functions again, unlike adjustOrganLoss.
```

proc
should_electrocute
(power_source)

Returns whether or not the carbon should be able to be shocked

proc
spray_blood
(splatter_direction, splatter_strength)

This proc is a helper for spraying blood for things like slashing/piercing wounds and dismemberment.

The strength of the splatter in the second argument determines how much it can dirty and how far it can go

Arguments:

splatter_direction: Which direction the blood is flying
splatter_strength: How many tiles it can go, and how many items it can pass over and dirty

proc
toggle_close_internals
(is_external)

Prepares to close the currently open internal air tank and notifies in chat. Handles displaying messages to the user before doing the actual closing. Returns TRUE if

Arguments:

is_external - A boolean which indicates if the air tank must be equipped, or stored elsewhere.

proc
toggle_externals
(/obj/item/tank)

Toggles the given external (that's EX-ternal) air tank open, or close the currently open one, if a compatible breathing apparatus is found. Returns TRUE if the tank was opened successfully.

Arguments:

tank - The given tank to toggle open and start breathing from externally.

proc
toggle_internals
(/obj/item/tank)

Toggles the given internal air tank open, or close the currently open one, if a compatible breathing apparatus is found. Returns TRUE if the tank was opened successfully.

Arguments:

tank - The given tank to toggle open and start breathing from internally.

proc
toggle_open_internals
(/obj/item/tank/target_tank, is_external)

Prepares to open the internal air tank and notifies the mob in chat. Handles displaying messages to the user before doing the actual opening. Returns TRUE if the tank was opened/closed successfully.

Arguments:

tank - The given tank to toggle open and start breathing from.
is_external - A boolean which indicates if the air tank must be equipped, or stored elsewhere.

proc
try_open_internals
(/obj/item/tank/target_tank, is_external)

Opens the given internal air tank if a breathing apparatus is found. Returns TRUE if successful, FALSE otherwise. Returns TRUE if the tank was opened successfully.

Arguments:

tank - The given tank we will attempt to toggle open and start breathing from.
is_external - A boolean which indicates if the air tank must be equipped, or stored elsewhere.

proc
try_remove_embedded_object
(/mob/user)

Called when a mob tries to remove an embedded object from this carbon

proc
wearing_shock_proof_gloves
()

Returns if the carbon is wearing shock proof gloves

/mob/living/carbon

Vars

Procs

Var Details

var all_scars – /list

var all_wounds – /list

var dreaming –

var external – /obj/item/tank

var handcuffed – /obj/item/restraints

var internal – /obj/item/tank

var internal_organs – /list

var internal_organs_slot – /list

var legcuffed – /obj/item/restraints

var silent –

var transformation_timer –

var visual_only_organs –

Proc Details

adjustOrganLoss(slot, amount, maximum)

proc adjustPlasma(amount)

proc bleed_warn(bleed_amt, forced)

proc can_breathe_helmet()

proc can_breathe_internals()

proc can_breathe_mask()

proc can_breathe_tube()

proc check_virus()

clear_stamina_regen()

proc close_all_airtanks()

proc close_externals()

proc close_internals(is_external)

proc cutoff_internals()

proc embed_object(/obj/item/embedding, part, deal_damage, silent, forced)

proc generate_fake_scars(num_scars, forced_type)

getOrganLoss(slot)

proc getPlasma()

proc get_biological_state()

proc get_bleed_rate()

↑get_blood_dna_list()

proc get_embedded_objects()

proc get_embedded_part(/obj/item/embedded)

proc get_total_bleed_rate()

proc get_wounded_bodyparts(brute, burn, stamina, status)

proc handle_breath_temperature(/datum/gas_mixture/breath)

proc handle_liver()

proc humanize(tr_flags, /datum/changelingprofile/chosen_prof)

proc immortality()

proc invalid_internals()

proc is_bleeding()

proc open_internals(/obj/item/tank/target_tank, is_external)

proc remove_embedded_object(/obj/item/embedded, new_loc, silent, forced, unsafe)

proc secondary_shock(should_stun, stuntime)

setOrganLoss(slot, amount)

proc should_electrocute(power_source)

proc spray_blood(splatter_direction, splatter_strength)

proc toggle_close_internals(is_external)

proc toggle_externals(/obj/item/tank)

proc toggle_internals(/obj/item/tank)

proc toggle_open_internals(/obj/item/tank/target_tank, is_external)

proc try_open_internals(/obj/item/tank/target_tank, is_external)

proc try_remove_embedded_object(/mob/user)

proc wearing_shock_proof_gloves()

var
all_scars
– /list

var
all_wounds
– /list

var
dreaming
–

var
external
– /obj/item/tank

var
handcuffed
– /obj/item/restraints

var
internal
– /obj/item/tank

var
internal_organs
– /list

var
internal_organs_slot
– /list

var
legcuffed
– /obj/item/restraints

var
silent
–

var
transformation_timer
–

var
visual_only_organs
–

adjustOrganLoss
(slot, amount, maximum)

proc
adjustPlasma
(amount)

proc
bleed_warn
(bleed_amt, forced)

proc
can_breathe_helmet
()

proc
can_breathe_internals
()

proc
can_breathe_mask
()

proc
can_breathe_tube
()

proc
check_virus
()

clear_stamina_regen
()

proc
close_all_airtanks
()

proc
close_externals
()

proc
close_internals
(is_external)

proc
cutoff_internals
()

proc
embed_object
(/obj/item/embedding, part, deal_damage, silent, forced)

proc
generate_fake_scars
(num_scars, forced_type)

getOrganLoss
(slot)

proc
getPlasma
()

proc
get_biological_state
()

proc
get_bleed_rate
()

↑
get_blood_dna_list
()

proc
get_embedded_objects
()

proc
get_embedded_part
(/obj/item/embedded)

proc
get_total_bleed_rate
()

proc
get_wounded_bodyparts
(brute, burn, stamina, status)

proc
handle_breath_temperature
(/datum/gas_mixture/breath)

proc
handle_liver
()

proc
humanize
(tr_flags, /datum/changelingprofile/chosen_prof)

proc
immortality
()

proc
invalid_internals
()

proc
is_bleeding
()

proc
open_internals
(/obj/item/tank/target_tank, is_external)

proc
remove_embedded_object
(/obj/item/embedded, new_loc, silent, forced, unsafe)

proc
secondary_shock
(should_stun, stuntime)

setOrganLoss
(slot, amount)

proc
should_electrocute
(power_source)

proc
spray_blood
(splatter_direction, splatter_strength)

proc
toggle_close_internals
(is_external)

proc
toggle_externals
(/obj/item/tank)

proc
toggle_internals
(/obj/item/tank)

proc
toggle_open_internals
(/obj/item/tank/target_tank, is_external)

proc
try_open_internals
(/obj/item/tank/target_tank, is_external)

proc
try_remove_embedded_object
(/mob/user)

proc
wearing_shock_proof_gloves
()