carbon

Var Details

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

bodyparts

Gets filled up in /datum/species/proc/replace_body. Will either contain a list of typepaths if nothing has been created yet, or a list of the body part objects.

can_be_shoved_into

Can other carbons be shoved into this one to make it fall?

cold_protection

Protection (insulation) from the cold, Value 0-1 corresponding to the percentage of protection

damageoverlaytemp

Used to temporarily increase severity of / apply a new damage overlay (the red ring around the ui / screen). This number will translate to equivalent brute or burn damage taken. Handled in [mob/living/proc/update_damage_hud]. (For example, setting damageoverlaytemp = 20 will add 20 "damage" to the overlay the next time it updates.) This number is also reset to 0 every tick of carbon Life(). Pain.

disgust

Measure of how disgusted we are. See DISGUST_LEVEL_GROSS and friends

dna

Carbon

dreaming

How many dream images we have left to send

ears

only used by humans.

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).

external_organs

List of /obj/item/organ/external in the mob, similarly used as internal_organs.

external_organs_slot

Same as above, but stores "ID" = "organ" pairs.

failed_last_breath

This is used to determine if the mob failed a breath. If they did fail a brath, they will attempt to breathe each tick, otherwise just once per 4 ticks.

glasses

only used by humans.

gloves

only used by humans

hand_bodyparts

A collection of arms (or actually whatever the fug /bodyparts you monsters use to wreck my systems)

handcuffed

Whether or not the mob is handcuffed

heat_protection

Protection (insulation) from the heat, Value 0-1 corresponding to the percentage of protection

icon_render_keys

A cache of bodypart = icon to prevent excessive icon creation.

internal

Equipped air tank. Never set this manually.

internal_organs

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

internal_organs_slot

Same as above, but stores "slot ID" - "organ" pairs for easy access.

last_mind

last mind to control this mob, for blood-based cloning

legcuffed

Same as handcuffs but for legs. Bear traps use this.

old_disgust

How disgusted we were LAST time we processed disgust. Helps prevent unneeded work

shoes

only used by humans.

skillchip_complexity_modifier

Simple modifier for whether this mob can handle greater or lesser skillchip complexity. See /datum/mutation/human/biotechcompat/ for example.

stam_regen_start_time

used to halt stamina regen temporarily

tinttotal

Total level of visualy impairing items

transformation_timer

Timer id of any transformation

visual_only_organs

Only load in visual organs

Proc Details

add_bodypart

Proc to hook behavior on bodypart additions. Do not directly call. You're looking for [/obj/item/bodypart/proc/try_attach_limb()].

adjustOrganLoss

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.

Arguments:

• slot - organ slot, like [ORGAN_SLOT_HEART]
• amount - damage to be done
• maximum - currently an arbitrarily large number, can be set so as to limit damage
• required_organtype - targets only a specific organ type if set to ORGAN_ORGANIC or ORGAN_ROBOTIC

adjustPlasma

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

adjust_bodytemperature

Adjust the body temperature of a mob expanded for carbon mobs allowing the use of insulation and change steps

vars:

• amount The amount of degrees to change body temperature by
• min_temp (optional) The minimum body temperature after adjustment
• max_temp (optional) The maximum body temperature after adjustment
• use_insulation (optional) modifies the amount based on the amount of insulation the mob has
• use_steps (optional) Use the body temp divisors and max change rates
• capped (optional) default True used to cap step mode

adjust_skillchip_complexity_modifier

Modifies max_skillchip_count and updates active skillchips

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)

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-

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_passout

Check to see if we should be passed out from oyxloss

check_self_for_injuries

Check ourselves to see if we've got any shrapnel, return true if we do. This is a much simpler version of what humans do, we only indicate we're checking ourselves if there's actually shrapnel

check_virus

Medical HUD! Basic mode needs suit sensors on.

clone_skillchip_list

Creates a list of new skillchips cloned from old skillchips in the mob's brain.

Returns a complete list of new skillchips cloned from the mob's brain's existing skillchip stock. Rumour has it that Changelings just LOVE this proc. Arguments:

• cloned_chip_holder - The new holder for the cloned chips. Please don't be null.
• not_removable - Special override, whether or not to force cloned chips to be non-removable, i.e. to delete on removal.

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.

Arguments:

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

create_bodyparts

Creates body parts for this carbon completely from scratch. Optionally takes a map of body zones to what type to instantiate instead of them.

cutoff_internals

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

del_and_replace_bodypart

Replaces a single limb and deletes the old one if there was one

destroy_all_skillchips

Destroys all skillchips in the brain, handling appropriate cleanup and event calls.

disarm

Attempt to disarm the target mob. Will shove the target mob back, and drop them if they're in front of something dense or another carbon.

dream

Generates a dream sequence to be displayed to the sleeper.

Generates the "dream" to display to the sleeper. A dream consists of a subject, a verb, and (most of the time) an object, displayed in sequence to the sleeper. Dreams are generated as a list of strings stored inside dream_fragments, which is passed to and displayed in dream_sequence(). Bedsheets on the sleeper will provide a custom subject for the dream, pulled from the dream_messages on each bedsheet.

dream_sequence

Displays the passed list of dream fragments to a sleeping carbon.

Displays the first string of the passed dream fragments, then either ends the dream sequence or performs a callback on itself depending on if there are any remaining dream fragments to display.

Arguments:

• dream_fragments - A list of strings, in the order they will be displayed.

electrocute_act

Adds to the parent by also adding functionality to propagate shocks through pulling and doing some fluff effects.

expel_ingested

Expel the reagents you just tried to ingest

When you try to ingest reagents but you do not have a stomach you will spew the reagents on the floor.

Vars:

• bite: /atom the reagents to expel
• amount: int The amount of reagent

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)

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

If an organ exists in the slot requested, return the amount of damage that organ has

Arguments:

• slot - organ slot, like [ORGAN_SLOT_HEART]

getPlasma

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

get_all_covered_flags

Returns a bitfield of all zones covered by clothing

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_breath_from_internal

Attempts to take a breath from the external or internal air tank.

get_cold_protection

This returns the percentage of protection from cold as a value from 0 - 1 temperature is the temperature you're being exposed to

get_covered_body_zones

Returns a list of all body_zones covered by clothing

get_damageable_bodyparts

Returns a list of damageable bodyparts

get_damaged_bodyparts

Returns a list of damaged bodyparts

get_heat_protection

This returns the percentage of protection from heat as a value from 0 - 1 temperature is the temperature you're being exposed to

get_insulation_protection

Get the insulation that is appropriate to the temperature you're being exposed to. All clothing, natural insulation, and traits are combined returning a single value.

required temperature The Temperature that you're being exposed to

return the percentage of protection as a value from 0 - 1

get_total_bleed_rate

get our total bleedrate

get_traumas

TRAUMAS

get_wounded_bodyparts

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

give

Proc called when offering an item to another player

This handles creating an alert and adding an overlay to it

handle_breath_temperature

Fourth and final link in a breath chain

handle_dreams

Begins the dreaming process on a sleeping carbon.

Checks a 10% chance and whether or not the carbon this is called on is already dreaming. If the prob() passes and there are no dream images left to display, a new dream is constructed.

handle_environment

Base carbon environment handler, adds natural stabilization

handle_liver

Check to see if we have the liver, if not automatically gives you last-stage effects of lacking a liver.

has_equipped

This proc is called after an item has been successfully handled and equipped to a slot.

head_update

Handle stuff to update when a mob equips/unequips a headgear.

heal_bodypart_damage

Heals ONE bodypart randomly selected from damaged ones.

It automatically updates damage overlays if necessary

It automatically updates health status

heal_overall_damage

Heal MANY bodyparts, in random order

humanize

Humanize

implant_skillchip

Attempts to implant this skillchip into the target carbon's brain.

Returns whether the skillchip was inserted or not. Can optionally give chat message notification to the mob. Arguments:

• skillchip - The skillchip you want to insert.
• silent - Whether or not to display the implanting message.
• force - Whether to force the implant to happen, including forcing activating if activate = TRUE. Ignores incompatibility checks. Used by changelings.

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

lying_angle_on_lying_down

Special carbon interaction on lying down, to transform its sprite by a rotation.

natural_bodytemperature_stabilization

Used to stabilize the body temperature back to normal on living mobs

Arguments:

• environemnt: The environment gas mix
• delta_time: The amount of time that has elapsed since the last tick
• times_fired: The number of times SSmobs has ticked

on_nobreath_trait_gain

On gain of TRAIT_NOBREATH

This will clear all alerts and moods related to breathing.

on_nometabolism_trait_gain

On gain of TRAIT_NOMETABOLISM

This will clear all moods related to addictions and stop metabolization.

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.

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.

regenerate_organs

Recreates all of this mob's organs, and heals them to full.

remove_all_embedded_objects

Remove all embedded objects from all limbs on the carbon mob

remove_bodypart

Proc to hook behavior on bodypart removals. Do not directly call. You're looking for [/obj/item/bodypart/proc/drop_limb()].

remove_embedded_object

Remove a specific embedded item from the carbon mob

remove_skillchip

Attempts to remove this skillchip from the target carbon's brain.

Returns FALSE when the skillchip couldn't be removed for some reason, including the target or brain not existing or the skillchip not being in the brain. Arguments:

• target - The living carbon whose brain you want to remove the chip from.
• silent - Whether or not to display the removal message.

secondary_shock

Called slightly after electrocute act to apply a secondary stun.

setOrganLoss

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.

Arguments:

• slot - organ slot, like [ORGAN_SLOT_HEART]
• amount - damage to be set to
• required_organtype - targets only a specific organ type if set to ORGAN_ORGANIC or ORGAN_ROBOTIC

set_handcuffed

Modifies the handcuffed value if a different value is passed, returning FALSE otherwise. The variable should only be changed through this proc.

share_bodytemperature

Have two mobs share body heat between each other. Account for the insulation and max temperature change range for the mob

vars:

• M The mob/living/carbon that is sharing body heat

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.

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

take

Proc called when the player clicks the give alert

Handles checking if the player taking the item has open slots and is in range of the offerer Also deals with the actual transferring of the item to the players hands Arguments:

• offerer - The person giving the original item
• I - The item being given by the offerer

take_bodypart_damage

Damages ONE bodypart randomly selected from damagable ones.

It automatically updates damage overlays if necessary

It automatically updates health status

take_overall_damage

damage MANY bodyparts, in random order

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

Arguments:

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

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.

Arguments:

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

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.

Arguments:

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

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.

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.

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.

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.

update_body_parts

Checks to see if any bodyparts need to be redrawn, then does so. update_limb_data = TRUE redraws the limbs to conform to the owner.

update_bodypart_bleed_overlays

Has each bodypart update its bleed/wound overlay icon states

wearing_shock_proof_gloves

Returns if the carbon is wearing shock proof gloves