human

Any humanoid (non-Xeno) mob, such as humans, plasmamen, lizards.

Var Details

afk_thefts

When an braindead player has their equipment fiddled with, we log that info here for when they come back so they know who took their ID while they were DC'd for 30 seconds

base_mob_height

Base height of the mob, modified by stuff like dwarfism or species

blood_in_hands

How many "units of blood" we have on our hands

coretemperature

The core temperature of the human compaired to the skin temp of the body

eye_color_heterochromatic

Var used to keep track of a human mob having a heterochromatic right eye. To ensure prefs don't overwrite shit

grad_color

Colours used for hair and facial hair gradients.

grad_style

Styles used for hair and facial hair gradients.

heat_exposure_stacks

Exposure to damaging heat levels increases stacks, stacks clean over time when temperatures are lower. Stack is consumed to add a wound.

last_death_info

A datum that tracks all the information at the time of there death. Used for powers that tell you the sitatuons of there demise.

mob_height

Actual height of the mob. Don't touch this one, it is set via update_mob_height()

override_voice

Allows for special overrides of voice

physique

Which body type to use

received_ownership_keys

List of ownership types the player has claimed keys for (e.g., "apartment", "car")

seconds_in_low_pressure

Tracks how long in seconds we've been in a low pressure environment

Proc Details

add_blood_DNA_to_items

Adds blood DNA to certain slots the mob is wearing

adjust_coretemperature

Adjust the core temperature of a mob

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

apply_height_filters

Applies a filter to an appearance according to mob height

apply_height_offsets

Used in some circumstances where appearances can get cut off from the mob sprite from being too tall

upper_torso is to specify whether the appearance is locate in the upper half of the mob rather than the lower half, higher up things (hats for example) need to be offset more due to the location of the filter displacement

burn_clothing

Used by fire code to damage worn items.

Arguments:

• seconds_per_tick
• times_fired
• stacks: Current amount of firestacks

change_st_power_level

Change the level of a power the mob possesses.

check_pocket_weght

Signal proc for COMSIG_ATOM_CONTENTS_WEIGHT_CLASS_CHANGED to check if an item is suddenly too heavy for our pockets

check_reflect

Reflection checks for anything in your l_hand, r_hand, or wear_suit based on the reflection chance of the object

clean_face

Called on the COMSIG_COMPONENT_CLEAN_FACE_ACT signal

copy_clothing_prefs

copies over clothing preferences like underwear to another human

crabize

Turns the source atom into a crab crab, the peak of evolutionary design.

crewlike_monkify

Proc used to make monkey roles able to function like crew, but not be able to shift into humans easily.

do_cpr

Performs CPR on the target after a delay.

electrocute_act

Calculates the siemens coeff based on clothing and species, can also restart hearts.

equip_outfit_and_loadout

Equips this mob with a given outfit and loadout items as per the passed preferences.

Loadout items override the pre-existing item in the corresponding slot of the job outfit. Some job items are preserved after being overridden - belt items, ear items, and glasses. The rest of the slots, the items are overridden completely and deleted.

Species with special outfits are snowflaked to have loadout items placed in their bags instead of overriding the outfit.

• outfit - the job outfit we're equipping
• preference_source - the preferences to draw loadout items from.
• visuals_only - whether we call special equipped procs, or if we just look like we equipped it

equip_species_outfit

A version of equipOutfit that overrides passed in outfits with their entry on the species' outfit override registry

fan_hud_set_fandom

FAN HUDs! For identifying other fans on-sight.

force_say

Makes the player force say what's in their current input box. Arguments: alter_phrases - Optional list of alternate suffixes to blurt out immediate - If [TRUE], the say must be invoked inline due to side effects that may cause the mob to be unable to speak

format_scars

For use formatting all of the scars this human has for saving for persistent scarring, returns a string with all current scars/missing limb amputation scars for saving or loading purposes

get_age_text

Reports how old the mob appears to be

get_base_mob_height

Gets the mob's base height, ignoring adjustments from traits or species Necessary due to VAR_PRIVATE (it's not used in hot code anyways)

get_body_temp_normal

get_body_temperature Returns the body temperature with any modifications applied

This applies the result from proc/get_body_temp_normal_change() against the bodytemp_normal for the species and returns the result

arguments:

• apply_change (optional) Default True This applies the changes to body temperature normal

get_clothing_on_part

Get all the clothing on a specific body part

get_equipped_items

Used to return a list of equipped items on a human mob; does not by default include held items, see include_flags

Argument(s):

• Optional - include_flags, (see obj.flags.dm) describes which optional things to include or not (pockets, accessories, held items)

get_medhud_examine_info

Collects information displayed about src when examined by a user with a medical HUD.

get_mismatched_limb_text

Reports all body parts which are mismatched with the user's species

get_missing_organs

Returns a list of all missing organs this species should have

list [key] is the ORGAN_SLOT missing an organ, list value is the text name of the slot organ

get_underwear_overlays

Returns a list of all underclothing overlays to be applied to the mob

get_visible_name

Combines get_id_name() and get_face_name() to determine a mob's name variable. Made into a separate proc as it'll be useful elsewhere

give_emote_overlay

Creates a new emote bodypart overlay and applies it to the human. The overlay can be removed by simply deleting the returned overlay.

• Arguments:
• overlay_typepath - Typepath to the overlay that should be applied. Should be a subtype of datum/bodypart_overlay/simple/emote.

Returns the given overlay, which can be deleted to stop displaying it. Will return null if no bodypart matching the overlay's attached_body_zone field can be found.

give_st_power

Add a power with a certain level to the mob. Fails if no splat compatible with the power is found

give_st_powers

Add a list of powers with certain levels to the mob.

Defaults to level 1 if no corresponding level is given for a power. Adds the power to a splat that can support it, fails if no splats compatible with the power are found.

Arguments:

• power_types - List of powers to add to the mob.
• levels - List of power levels to apply to the power of the same index.

handle_environment

Environment handlers for species

hardset_dna

Sets the DNA of the mob to the given DNA.

increment_scar_slot

When we're joining the game in /mob/dead/new_player/proc/create_character, we increment our scar slot then store the slot in our mind datum.

infuse_organ

Attempt to replace/add-to the occupant's organs with "mutated" equivalents. Returns TRUE on success, FALSE on failure. Requires the target mob to have an existing organic organ to "mutate".

invisible_man_toggle

When TRAIT_INVISIBLE_MAN is added or removed we need to update a few things

load_persistent_scars

Read all the scars we have for the designated character/scar slots, verify they're good/dump them if they're old/wrong format, create them on the user, and write the scars that passed muster back to the file

load_scar

Takes a single scar from the persistent scar loader and recreates it from the saved data

make_full_human_copy

Makes a full copy of src and returns it. Attempts to copy as much as possible to be a close to the original. This includes job outfit (which handles skillchips), quirks, and mutations. We do not set a mind here, so this is purely the body. Args: location - The turf the human will be spawned on.

name_override

For Guestbooks.

no_underwear_toggle

When TRAIT_NO_UNDERWEAR is added or removed we need to update our body to hide or show underwear sprites

on_dwarf_trait

Gaining or losing [TRAIT_DWARF] updates our height and grants passtable

on_staked

Gaining [TRAIT_STAKED] forces us into torpor if we're kindred, and just murders us if we're not.

on_tootall_trait

Gaining or losing TRAIT_TOO_TALL updates our height

on_unstaked

Losing [TRAIT_STAKED] forces us out of torpor if we're kindred.

pick_infusion_organ

Picks a random mutated organ from the given infuser entry which is also compatible with this human. Tries to return a typepath of a valid mutant organ if all of the following criteria are true:

1. Target must have a pre-existing organ in the same organ slot as the new organ;

• or the new organ must be external.

2. Target's pre-existing organ must be organic / not robotic.
3. Target must not have the same/identical organ.

psykerize

Proc with no side effects that turns someone into a psyker. returns FALSE if it could not psykerize.

randomize_human_appearance

Fully randomizes everything according to the given flags.

remove_st_power

Remove a power from the mob.

render_only_head

Makes all aspects of the mob invisibile but the head and its associated sprites

rot_body

Rots the vampire's body along four stages of decay.

Vampire bodies are either pre-decayed if they're Cappadocians, or they decay on death to what their body should naturally be according to their chronological age. Stage 1 is fairly normal looking with discoloured skin, stage 2 is somewhat decayed-looking, stage 3 is very decayed, and stage 4 is a long-dead completely decayed corpse. This has no effect on Clans that already have alt_sprites unless they're being rotted to stage 3 and above.

Arguments:

• rot_stage - how much to rot the vampire, on a scale from 1 to 4.

save_persistent_scars

Save any scars we have to our designated slot, then write our current slot so that the next time we call /mob/living/carbon/human/proc/increment_scar_slot (the next round we join), we'll be there

send_applicable_messages

Any "special" suicide messages are handled by the related item that the mob uses to kill itself. This is just messages for when it's done with the bare hands.

set_auspice

Gives the human a Auspice, applying on_gain effects and post_gain effects if the parameter is true. Can also remove Auspices with or without a replacement, and apply on_lose effects. Will have no effect the human is being given the Auspice it already has.

Arguments:

• setting_auspice - Typepath or Auspice singleton to give to the human
• joining_round - If this Auspice is being given at roundstart and should call on_join_round

set_body_sprite

Assigns a human an alternative body sprite accounting for body model. If no sprite name is supplied, sets it to the default for the human depending on species or Clan.

Arguments:

• sprite_name - Name of the sprite that'll be used as the base for this human's limbs.
• greyscale - If the new limbs use skin tone.

set_breed_form

Gives the human a breed_form, applying on_gain effects and post_gain effects if the parameter is true. Can also remove breed_forms with or without a replacement, and apply on_lose effects. Will have no effect the human is being given the breed_form it already has.

Arguments:

• setting_breed_form - Typepath or breed_form singleton to give to the human
• joining_round - If this breed_form is being given at roundstart and should call on_join_round

set_clan

Gives the human a vampiric Clan, applying on_gain effects and post_gain effects if the parameter is true. Can also remove Clans with or without a replacement, and apply on_lose effects. Will have no effect the human is being given the Clan it already has.

Arguments:

• setting_clan - Typepath or Clan singleton to give to the human
• joining_round - If this Clan is being given at roundstart and should call on_join_round

set_eye_color

Sets both mob's and eye organ's eye color values If color_right is not passed, its assumed to be the same as color_left

set_fera_tribe

Gives the human a tribe, applying on_gain effects and post_gain effects if the parameter is true. Can also remove tribes with or without a replacement, and apply on_lose effects. Will have no effect the human is being given the tribe it already has.

Arguments:

• setting_tribe - Typepath or tribe singleton to give to the human
• joining_round - If this tribe is being given at roundstart and should call on_join_round

set_mob_height

Setter for mob height - updates the base height of the mob (which is then adjusted by traits or species)

• new_height - The new base height for this mob, should be one of the HUMAN_HEIGHT defines
• update_dna - if TRUE (default), updates the mob's DNA with the new height value

set_service_style

Gives the appearance of being an agent

setup_organless_effects

This proc is for holding effects applied when a mob is missing certain organs It is called very, very early in human init because all humans innately spawn with no organs and gain them during init Gaining said organs removes these effects

singularity_act

Overrides the point value that the mob is worth

slow_psykerize

flavorful variant of psykerizing that deals damage and sends messages before calling psykerize()

smart_equip_targeted

take the most recent item out of a slot or place held item in a slot

something_horrible

DNA HELPER-PROCS

toggle_externals

Returns TRUE if the tank successfully toggles open/closed. Opens the tank only if a breathing apparatus is found.

update_ID_card

Security HUDs! Basic mode shows only the job.

update_face_offset

Updates face (as of now, only eye) offsets

update_mob_height

Updates the mob's height

Mainly so that dwarfism can adjust height without needing to override existing height

Returns a mob height num

update_visible_name

Used to update our name based on whether our face is obscured/disfigured

wash

Called when this human should be washed

wash_hands

Wash the hands, cleaning either the gloves if equipped and not obscured, otherwise the hands themselves if they're not obscured.

Returns false if we couldn't wash our hands due to them being obscured, otherwise true

write_preference_midround

Preliminary wrapper for the prefs write_preference_midround that ensures your acctually on the same character as the one you spawned in as.