species

This datum handles different species in the game, such as synthetics, mothmen, combat robots, skeletons, etc. It is used in mob/living/carbon/human to determine many things about them, including damage resistance, appearance, special behaviors, and more.

Vars
base_color	Used when setting species
blood_color	Color of the blood specific to our species
body_temperature	non-IS_SYNTHETIC species will try to stabilize at this temperature. (also affects temperature processing)
brute_damage_icon_state	icon state for calculating brute damage icons
brute_mod	Brute damage modifier
burn_damage_icon_state	icon state for calculating brute damage icons
burn_mod	Burn damage modifier
burstscreams	List of sounds for certain emotes [/datum/emote/living/carbon/human/burstscream/get_sound]
cold_level_1	Cold damage level 1 below this point
cold_level_2	Cold damage level 2 below this point
cold_level_3	Cold damage level 3 below this point
coughs	List of sounds for certain emotes [/datum/emote/living/carbon/human/cough/get_sound]
count_human	If this species counts as a human
damage_mask_icon	damage mask icon we want to use when drawing wounds
death_message	Message that gets sent on death()
death_sound	Sound that gets played on death()
default_language_holder	type that gets set as our language_holder on proc/set_species
dusted_anim	species-specific dusting animation
eyes	icon for eyes
flesh_color	Color of the gibs that spawn from our species [/mob/living/carbon/human/spawn_gibs]
gasps	List of sounds for certain emotes [/datum/emote/living/carbon/human/gasp/get_sound]
gibbed_anim	species-specific gibbing animation
goredcries	List of sounds for certain emotes [/datum/emote/living/carbon/human/gored/get_sound]
hair_color	If the species only has one hair color
has_organ	Associated list of our organs
hazard_high_pressure	Dangerously high pressure
hazard_low_pressure	Dangerously low pressure
heat_level_1	Heat damage level 1 above this point
heat_level_2	Heat damage level 2 above this point
heat_level_3	Heat damage level 2 above this point
hud	hud that our mob uses, gets given the type stored in hud_type on New()
hud_type	type that our hud gets set to on New()
icobase	Normal icon file
icon_template	Used in icon caching
inherent_actions	inherent species-specific actions
inherent_traits	Generic traits tied to having the species
inherent_verbs	inherent Species-specific verbs
joinable_roundstart	Whether it is possible to select this species and join as it
knock_down_reduction	how much the knocked_down effect is reduced per Life call
knock_out_reduction	how much the stunned effect is reduced per Life call
lighting_cutoff	Sets our mobs lighting_alpha on /mob/living/carbon/human/update_sight
limb_type	used in limb code to find which bodytype files to pull from, yes this code can defenitely be improved
max_stamina	new max_stamina /mob/living/var/max_stamina of the human mob once species is applied
name	Species name
namepool	List of names for random generation based on a given pool
no_equip	Inventory slots the race can't equip stuff to. Golems cannot wear jumpsuits, for example
paincries	List of sounds for certain emotes [/datum/emote/living/carbon/human/pain/get_sound]
race_key	Used in icon caching
reagent_tag	Used for metabolizing reagents
remains_type	used to determine what item is left behind in /spawn_dust_remains()
screams	List of sounds for certain emotes [/datum/emote/living/carbon/human/scream/get_sound]
secondary_unarmed	For empty hand harm-intent attack if the first fails
secondary_unarmed_type	type that our secondary_unarmed gets set to on New()
slowdown	How much slowdown is innate to our species
special_death_message	Special death message that gets overwritten if possible
species_flags	Special effects that are inherent to our species
species_type	what kind of species it is considered (See: Species defines)
stun_reduction	how much the stunned effect is reduced per Life call
taste_sensitivity	used in mob/living/proc/taste
total_health	new maxHealth /mob/living/carbon/human/var/maxHealth of the human mob once species is applied
unarmed	For empty hand harm-intent attack
unarmed_type	type that our unarmed gets set to on New()
warcries	List of sounds for certain emotes [/datum/emote/living/carbon/human/warcry/get_sound]
warning_high_pressure	High pressure warning
warning_low_pressure	Low pressure warning
Procs
add_inherent_abilities	Adds all species-specific verbs and actions
apply_damage	damage override at the species level, called by /mob/living/proc/apply_damage
build_hud	Builds the HUD using species-specific icons and usable slots
can_shred	Called when using the shredding behavior
can_understand	Used by xenos understanding larvae and dionaea understanding nymphs
create_organs	Handles creation of mob organs and limbs
get_inventory_dialogue	Grabs the window recieved when you click-drag someone onto you
handle_chemicals	Called by [/mob/living/carbon/human/reagent_check] Returns TRUE if we can't metabolize chems, or can't be poisoned by a toxin
handle_death	Handles any species-specific death events
handle_fire	Called on Life(), special behaviour if we are on fire
handle_login_special	Used to update alien icons for aliens
handle_logout_special	As above
handle_post_spawn	Handles anything not already covered by basic species assignment
handle_unique_behavior	Called on Life(), used for special behavior when the carbon human with this species is alive
hug	Called by [/mob/living/carbon/proc/help_shake_act], the act of hugging someone
on_species_gain	Called when we turn into a species, called by [/mob/living/carbon/human/proc/set_species()] drops things we shouldn't be allowed to equip, adds relevant traits, and adjusts the max health of our mob
post_species_loss	special things to change after we're no longer that species
prefs_name	Returns the name if there is one in prefs
random_name	Generates a random name from namepool
record_internal_injury	Record when a bone break or internal bleeding is inflicted
remove_inherent_abilities	Removes all species-specific verbs and actions
spec_unarmedattack	Snowflake proc for monkeys so they can call attackpaw
update_body	Basically just used to update moth wings
update_inv_head	Basically just used to update moth wings
update_inv_w_uniform	Basically just used to update moth wings
update_inv_wear_suit	Basically just used to update moth wings //Man moths are giga shitcoded

Var Details

var
base_color
–

Used when setting species

var
blood_color
–

Color of the blood specific to our species

var
body_temperature
–

non-IS_SYNTHETIC species will try to stabilize at this temperature. (also affects temperature processing)

var
brute_damage_icon_state
–

icon state for calculating brute damage icons

var
brute_mod
–

Brute damage modifier

var
burn_damage_icon_state
–

icon state for calculating brute damage icons

var
burn_mod
–

Burn damage modifier

var
burstscreams
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/burstscream/get_sound]

var
cold_level_1
–

Cold damage level 1 below this point

var
cold_level_2
–

Cold damage level 2 below this point

var
cold_level_3
–

Cold damage level 3 below this point

var
coughs
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/cough/get_sound]

var
count_human
–

If this species counts as a human

var
damage_mask_icon
–

damage mask icon we want to use when drawing wounds

var
death_message
–

Message that gets sent on death()

var
death_sound
–

Sound that gets played on death()

var
default_language_holder
–

type that gets set as our language_holder on proc/set_species

var
dusted_anim
–

species-specific dusting animation

var
eyes
–

icon for eyes

var
flesh_color
–

Color of the gibs that spawn from our species [/mob/living/carbon/human/spawn_gibs]

var
gasps
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/gasp/get_sound]

var
gibbed_anim
–

species-specific gibbing animation

var
goredcries
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/gored/get_sound]

var
hair_color
–

If the species only has one hair color

var
has_organ
– /list

Associated list of our organs

var
hazard_high_pressure
–

Dangerously high pressure

var
hazard_low_pressure
–

Dangerously low pressure

var
heat_level_1
–

Heat damage level 1 above this point

var
heat_level_2
–

Heat damage level 2 above this point

var
heat_level_3
–

Heat damage level 2 above this point

var
hud
– /datum/hud_data

hud that our mob uses, gets given the type stored in hud_type on New()

var
hud_type
–

type that our hud gets set to on New()

var
icobase
–

Normal icon file

var
icon_template
– /icon

Used in icon caching

var
inherent_actions
– /list

inherent species-specific actions

var
inherent_traits
– /list

Generic traits tied to having the species

var
inherent_verbs
– /list

inherent Species-specific verbs

var
joinable_roundstart
–

Whether it is possible to select this species and join as it

var
knock_down_reduction
–

how much the knocked_down effect is reduced per Life call

var
knock_out_reduction
–

how much the stunned effect is reduced per Life call

var
lighting_cutoff
–

Sets our mobs lighting_alpha on /mob/living/carbon/human/update_sight

var
limb_type
–

used in limb code to find which bodytype files to pull from, yes this code can defenitely be improved

var
max_stamina
–

new max_stamina /mob/living/var/max_stamina of the human mob once species is applied

var
name
–

Species name

var
namepool
– /datum/namepool

List of names for random generation based on a given pool

var
no_equip
– /list

Inventory slots the race can't equip stuff to. Golems cannot wear jumpsuits, for example

var
paincries
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/pain/get_sound]

var
race_key
–

Used in icon caching

var
reagent_tag
–

Used for metabolizing reagents

var
remains_type
–

used to determine what item is left behind in /spawn_dust_remains()

var
screams
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/scream/get_sound]

var
secondary_unarmed
– /datum/unarmed_attack

For empty hand harm-intent attack if the first fails

var
secondary_unarmed_type
–

type that our secondary_unarmed gets set to on New()

var
slowdown
–

How much slowdown is innate to our species

var
special_death_message
–

Special death message that gets overwritten if possible

var
species_flags
–

Special effects that are inherent to our species

var
species_type
–

what kind of species it is considered (See: Species defines)

var
stun_reduction
–

how much the stunned effect is reduced per Life call

var
taste_sensitivity
–

used in mob/living/proc/taste

var
total_health
–

new maxHealth /mob/living/carbon/human/var/maxHealth of the human mob once species is applied

var
unarmed
– /datum/unarmed_attack

For empty hand harm-intent attack

var
unarmed_type
–

type that our unarmed gets set to on New()

var
warcries
– /list

List of sounds for certain emotes [/datum/emote/living/carbon/human/warcry/get_sound]

var
warning_high_pressure
–

High pressure warning

var
warning_low_pressure
–

Low pressure warning

Proc Details

proc
add_inherent_abilities
(/mob/living/carbon/human/H)

Adds all species-specific verbs and actions

proc
apply_damage
(damage, damagetype, def_zone, blocked, sharp, edge, updating_health, penetration, /mob/living/carbon/human/victim, /mob/attacker)

damage override at the species level, called by /mob/living/proc/apply_damage

proc
build_hud
(/mob/living/carbon/human/H)

Builds the HUD using species-specific icons and usable slots

proc
can_shred
(/mob/living/carbon/human/H)

Called when using the shredding behavior

proc
can_understand
(/mob/other)

Used by xenos understanding larvae and dionaea understanding nymphs

proc
create_organs
(/mob/living/carbon/human/organless_human)

Handles creation of mob organs and limbs

proc
get_inventory_dialogue
(/mob/living/carbon/human/H)

Grabs the window recieved when you click-drag someone onto you

proc
handle_chemicals
(/datum/reagent/chem, /mob/living/carbon/human/H)

Called by [/mob/living/carbon/human/reagent_check] Returns TRUE if we can't metabolize chems, or can't be poisoned by a toxin

proc
handle_death
(/mob/living/carbon/human/H)

Handles any species-specific death events

proc
handle_fire
(/mob/living/carbon/human/H)

Called on Life(), special behaviour if we are on fire

proc
handle_login_special
(/mob/living/carbon/human/H)

Used to update alien icons for aliens

proc
handle_logout_special
(/mob/living/carbon/human/H)

As above

proc
handle_post_spawn
(/mob/living/carbon/human/H)

Handles anything not already covered by basic species assignment

proc
handle_unique_behavior
(/mob/living/carbon/human/H)

Called on Life(), used for special behavior when the carbon human with this species is alive

proc
hug
(/mob/living/carbon/human/H, /mob/living/target)

Called by [/mob/living/carbon/proc/help_shake_act], the act of hugging someone

proc
on_species_gain
(/mob/living/carbon/human/H, /datum/species/old_species)

Called when we turn into a species, called by [/mob/living/carbon/human/proc/set_species()] drops things we shouldn't be allowed to equip, adds relevant traits, and adjusts the max health of our mob

proc
post_species_loss
(/mob/living/carbon/human/H)

special things to change after we're no longer that species

proc
prefs_name
(/datum/preferences/prefs)

Returns the name if there is one in prefs

proc
random_name
(gender)

Generates a random name from namepool

proc
record_internal_injury
(/mob/living/carbon/human/victim, /mob/attacker, old_status, new_status)

Record when a bone break or internal bleeding is inflicted

proc
remove_inherent_abilities
(/mob/living/carbon/human/H)

Removes all species-specific verbs and actions

proc
spec_unarmedattack
(/mob/living/carbon/human/user, /atom/target)

Snowflake proc for monkeys so they can call attackpaw

proc
update_body
(/mob/living/carbon/human/H)

Basically just used to update moth wings

proc
update_inv_head
(/mob/living/carbon/human/H)

Basically just used to update moth wings

proc
update_inv_w_uniform
(/mob/living/carbon/human/H)

Basically just used to update moth wings

proc
update_inv_wear_suit
(/mob/living/carbon/human/H)

Basically just used to update moth wings //Man moths are giga shitcoded

The base species datum /datum/species

Vars

Procs

Var Details

var base_color –

var blood_color –

var body_temperature –

var brute_damage_icon_state –

var brute_mod –

var burn_damage_icon_state –

var burn_mod –

var burstscreams – /list

var cold_level_1 –

var cold_level_2 –

var cold_level_3 –

var coughs – /list

var count_human –

var damage_mask_icon –

var death_message –

var death_sound –

var default_language_holder –

var dusted_anim –

var eyes –

var flesh_color –

var gasps – /list

var gibbed_anim –

var goredcries – /list

var hair_color –

var has_organ – /list

var hazard_high_pressure –

var hazard_low_pressure –

var heat_level_1 –

var heat_level_2 –

var heat_level_3 –

var hud – /datum/hud_data

var hud_type –

var icobase –

var icon_template – /icon

var inherent_actions – /list

var inherent_traits – /list

var inherent_verbs – /list

var joinable_roundstart –

var knock_down_reduction –

var knock_out_reduction –

var lighting_cutoff –

var limb_type –

var max_stamina –

var name –

var namepool – /datum/namepool

var no_equip – /list

var paincries – /list

var race_key –

var reagent_tag –

var remains_type –

var screams – /list

var secondary_unarmed – /datum/unarmed_attack

var secondary_unarmed_type –

var slowdown –

var special_death_message –

var species_flags –

var species_type –

var stun_reduction –

var taste_sensitivity –

var total_health –

var unarmed – /datum/unarmed_attack

var unarmed_type –

var warcries – /list

var warning_high_pressure –

var warning_low_pressure –

Proc Details

proc add_inherent_abilities(/mob/living/carbon/human/H)

proc apply_damage(damage, damagetype, def_zone, blocked, sharp, edge, updating_health, penetration, /mob/living/carbon/human/victim, /mob/attacker)

proc build_hud(/mob/living/carbon/human/H)

proc can_shred(/mob/living/carbon/human/H)

proc can_understand(/mob/other)

proc create_organs(/mob/living/carbon/human/organless_human)

proc get_inventory_dialogue(/mob/living/carbon/human/H)

proc handle_chemicals(/datum/reagent/chem, /mob/living/carbon/human/H)

proc handle_death(/mob/living/carbon/human/H)

proc handle_fire(/mob/living/carbon/human/H)

The base species datum
/datum/species

var
base_color
–

var
blood_color
–

var
body_temperature
–

var
brute_damage_icon_state
–

var
brute_mod
–

var
burn_damage_icon_state
–

var
burn_mod
–

var
burstscreams
– /list

var
cold_level_1
–

var
cold_level_2
–

var
cold_level_3
–

var
coughs
– /list

var
count_human
–

var
damage_mask_icon
–

var
death_message
–

var
death_sound
–

var
default_language_holder
–

var
dusted_anim
–

var
eyes
–

var
flesh_color
–

var
gasps
– /list

var
gibbed_anim
–

var
goredcries
– /list

var
hair_color
–

var
has_organ
– /list

var
hazard_high_pressure
–

var
hazard_low_pressure
–

var
heat_level_1
–

var
heat_level_2
–

var
heat_level_3
–

var
hud
– /datum/hud_data

var
hud_type
–

var
icobase
–

var
icon_template
– /icon

var
inherent_actions
– /list

var
inherent_traits
– /list

var
inherent_verbs
– /list

var
joinable_roundstart
–

var
knock_down_reduction
–

var
knock_out_reduction
–

var
lighting_cutoff
–

var
limb_type
–

var
max_stamina
–

var
name
–

var
namepool
– /datum/namepool

var
no_equip
– /list

var
paincries
– /list

var
race_key
–

var
reagent_tag
–

var
remains_type
–

var
screams
– /list

var
secondary_unarmed
– /datum/unarmed_attack

var
secondary_unarmed_type
–

var
slowdown
–

var
special_death_message
–

var
species_flags
–

var
species_type
–

var
stun_reduction
–

var
taste_sensitivity
–

var
total_health
–

var
unarmed
– /datum/unarmed_attack

var
unarmed_type
–

var
warcries
– /list

var
warning_high_pressure
–

var
warning_low_pressure
–

proc
add_inherent_abilities
(/mob/living/carbon/human/H)

proc
apply_damage
(damage, damagetype, def_zone, blocked, sharp, edge, updating_health, penetration, /mob/living/carbon/human/victim, /mob/attacker)

proc
build_hud
(/mob/living/carbon/human/H)

proc
can_shred
(/mob/living/carbon/human/H)

proc
can_understand
(/mob/other)

proc
create_organs
(/mob/living/carbon/human/organless_human)

proc
get_inventory_dialogue
(/mob/living/carbon/human/H)

proc
handle_chemicals
(/datum/reagent/chem, /mob/living/carbon/human/H)

proc
handle_death
(/mob/living/carbon/human/H)

proc
handle_fire
(/mob/living/carbon/human/H)

proc
handle_login_special
(/mob/living/carbon/human/H)

proc
handle_logout_special
(/mob/living/carbon/human/H)

proc
handle_post_spawn
(/mob/living/carbon/human/H)

proc
handle_unique_behavior
(/mob/living/carbon/human/H)