species

Datum that handles different species in the game.

This datum handles species in the game, such as lizardpeople, mothmen, zombies, skeletons, etc. It is used in carbon humans to determine various things about them, like their food preferences, if they have biological genders, their damage resistances, and more.

Vars
armor	Percentage modifier for overall defense of the race, or less defense, if it's negative.
ass_image	For custom overrides for species ass images
attack_type	Type of damage attack does. Ethereals attack with burn damage for example.
attack_verb	Punch-specific attack verb.
breathid	What gas does this species breathe? Used by suffocation screen alerts, most of actual gas breathing is handled by mutantlungs. See [life.dm][code/modules/mob/living/carbon/human/life.dm]
brutemod	multiplier for brute damage
burnmod	multiplier for burn damage
cold_offset	moves their safe minimum temp by this value.
coldmod	multiplier for damage from cold temperature
damage_overlay_type	What kind of damage overlays (if any) appear on our species when wounded? If this is "", does not add an overlay.
disliked_food	Bitfield for food types that the species dislikes, giving them disgust. Humans hate raw food, for example.
exotic_blood	If your race bleeds something other than bog standard blood, change this to reagent id. For example, ethereals bleed liquid electricity.
exotic_blood_blend_mode	Which blend mode should this species blood use?
exotic_blood_color	Assume human as the default blood colour, override this default by species subtypes
exotic_bloodtype	If your race uses a non standard bloodtype (A+, O-, AB-, etc). For example, lizards have L type blood.
family_heirlooms	List of family heirlooms this species can get with the family heirloom quirk. List of types.
fixed_mut_color	To use MUTCOLOR with a fixed color that's independent of the mcolor feature in DNA.
fly	The actual flying ability given to flying species
flying_species	Is this species a flying species? Used as an easy check for some things
grab_sound	Special sound for grabbing
grad_color	The gradient color used to color the gradient.
grad_style	The gradient style used for the mob's hair.
hair_alpha	The alpha used by the hair. 255 is completely solid, 0 is invisible.
hair_color	This allows races to have specific hair colors. If null, it uses the H's hair/facial hair colors. If "mutcolor", it uses the H's mutant_color. If "fixedmutcolor", it uses fixedmutcolor
heatmod	multiplier for damage from hot temperature
hot_offset	moves their safe maximum temp by this value.
id	If the game needs to manually check your race to do something not included in a proc here, it will use this.
inert_mutation	Special mutation that can be found in the genepool exclusively in this species. Dont leave empty or changing species will be a headache
inherent_biotypes	List of biotypes the mob belongs to. Used by diseases.
inherent_traits	Generic traits tied to having the species.
liked_food	Bitfield for food types that the species likes, giving them a mood boost. Lizards like meat, for example.
meat	What the species drops when gibbed by a gibber machine.
mutant_bodyparts	Visible CURRENT bodyparts that are unique to a species. DO NOT USE THIS AS A LIST OF ALL POSSIBLE BODYPARTS AS IT WILL FUCK SHIT UP! Changes to this list for non-species specific bodyparts (ie cat ears and tails) should be assigned at organ level if possible. Assoc values are defaults for given bodyparts, also modified by aforementioned organs. They also allow for faster '[]' list access versus 'in'. Other than that, they are useless right now. Layer hiding is handled by [/datum/species/proc/handle_mutant_bodyparts] below.
mutant_brain	Replaces default brain with a different organ
mutant_heart	Replaces default heart with a different organ
mutant_organs	Internal organs that are unique to this race, like a tail.
mutantappendix	Replaces default appendix with a different organ.
mutantears	Replaces default ears with a different organ
mutanteyes	Replaces default lungs with a different organ Replaces default eyes with a different organ
mutanthands	Forces an item into this species' hands. Only an honorary mutantthing because this is not an organ and not loaded in the same way, you've been warned to do your research.
mutantliver	Replaces default liver with a different organ
mutantstomach	Replaces default stomach with a different organ
mutanttail	CIT SPECIFIC Mutant tail
mutanttongue	Replaces default tongue with a different organ
name	This is the fluff name. They are displayed on health analyzers and in the character setup menu. Leave them generic for other servers to customize.
no_equip	Inventory slots the race can't equip stuff to. Golems cannot wear jumpsuits, for example.
nojumpsuit	Allows the species to equip items that normally require a jumpsuit without having one equipped. Used by golems.
offset_features	Clothing offsets. If a species has a different body than other species, you can offset clothing so they look less weird.
outfit_important_for_life	A path to an outfit that is important for species life e.g. plasmaman outfit
payday_modifier	multiplier for money paid at payday
punchdamagehigh	Highest possible punch damage this species can give.
punchdamagelow	Lowest possible punch damage this species can give. If this is set to 0, punches will always miss.
punchstunthreshold	Damage at which punches from this race will stun
say_mod	Affects the speech message, for example: Motharula flutters, "My speech message is flutters!"
sexes	Whether or not the race has sexual characteristics (biological genders). At the moment this is only FALSE for skeletons and shadows
siemens_coeff	Base electrocution coefficient. Basically a multiplier for damage from electrocutions.
skinned_type	What skin the species drops when gibbed by a gibber machine.
special_step_sounds	Sounds to override barefeet walking
species_language_holder	What languages this species can understand and say. Use a language holder datum in this var.
species_traits	Species-only traits. Can be found in code/__DEFINES/DNA.dm
speedmod	Multiplier for the race's speed. Positive numbers make it move slower, negative numbers make it move faster.
stunmod	multiplier for stun durations
toxic_food	Bitfield for food types that the species absolutely hates, giving them even more disgust than disliked food. Meat is "toxic" to moths, for example.
typing_indicator_state	Our default override for typing indicator state
use_skintones	Does the species use skintones or not? As of now only used by humans.
wings_icon	Current wings icon
Procs
check_roundstart_eligible	Checks if a species is eligible to be picked at roundstart.
copy_properties_from	Copies some vars and properties over that should be kept when creating a copy of this species.
get_biological_state	The human species version of /mob/living/carbon/proc/get_biological_state. Depends on the HAS_FLESH and HAS_BONE species traits, having bones lets you have bone wounds, having flesh lets you have burn, slash, and piercing wounds
handle_digestion	LIFE
on_species_gain	Proc called when a carbon becomes this species.
random_name	Generates a random name for a carbon.
regenerate_organs	Corrects organs in a carbon, removing ones it doesn't need and adding ones it does.

Var Details

var
armor
–

Percentage modifier for overall defense of the race, or less defense, if it's negative.

var
ass_image
– /icon

For custom overrides for species ass images

var
attack_type
–

Type of damage attack does. Ethereals attack with burn damage for example.

var
attack_verb
–

Punch-specific attack verb.

var
breathid
–

What gas does this species breathe? Used by suffocation screen alerts, most of actual gas breathing is handled by mutantlungs. See [life.dm][code/modules/mob/living/carbon/human/life.dm]

var
brutemod
–

multiplier for brute damage

var
burnmod
–

multiplier for burn damage

var
cold_offset
–

moves their safe minimum temp by this value.

var
coldmod
–

multiplier for damage from cold temperature

var
damage_overlay_type
–

What kind of damage overlays (if any) appear on our species when wounded? If this is "", does not add an overlay.

var
disliked_food
–

Bitfield for food types that the species dislikes, giving them disgust. Humans hate raw food, for example.

var
exotic_blood
–

If your race bleeds something other than bog standard blood, change this to reagent id. For example, ethereals bleed liquid electricity.

var
exotic_blood_blend_mode
–

Which blend mode should this species blood use?

var
exotic_blood_color
–

Assume human as the default blood colour, override this default by species subtypes

var
exotic_bloodtype
–

If your race uses a non standard bloodtype (A+, O-, AB-, etc). For example, lizards have L type blood.

var
family_heirlooms
– /list

List of family heirlooms this species can get with the family heirloom quirk. List of types.

var
fixed_mut_color
–

To use MUTCOLOR with a fixed color that's independent of the mcolor feature in DNA.

var
fly
– /datum/action/innate/flight

The actual flying ability given to flying species

var
flying_species
–

Is this species a flying species? Used as an easy check for some things

var
grab_sound
–

Special sound for grabbing

var
grad_color
–

The gradient color used to color the gradient.

var
grad_style
–

The gradient style used for the mob's hair.

var
hair_alpha
–

The alpha used by the hair. 255 is completely solid, 0 is invisible.

var
hair_color
–

This allows races to have specific hair colors. If null, it uses the H's hair/facial hair colors. If "mutcolor", it uses the H's mutant_color. If "fixedmutcolor", it uses fixedmutcolor

var
heatmod
–

multiplier for damage from hot temperature

var
hot_offset
–

moves their safe maximum temp by this value.

var
id
–

If the game needs to manually check your race to do something not included in a proc here, it will use this.

var
inert_mutation
–

Special mutation that can be found in the genepool exclusively in this species. Dont leave empty or changing species will be a headache

var
inherent_biotypes
–

List of biotypes the mob belongs to. Used by diseases.

var
inherent_traits
– /list

Generic traits tied to having the species.

var
liked_food
–

Bitfield for food types that the species likes, giving them a mood boost. Lizards like meat, for example.

var
meat
–

What the species drops when gibbed by a gibber machine.

var
mutant_bodyparts
– /list

Visible CURRENT bodyparts that are unique to a species. DO NOT USE THIS AS A LIST OF ALL POSSIBLE BODYPARTS AS IT WILL FUCK SHIT UP! Changes to this list for non-species specific bodyparts (ie cat ears and tails) should be assigned at organ level if possible. Assoc values are defaults for given bodyparts, also modified by aforementioned organs. They also allow for faster '[]' list access versus 'in'. Other than that, they are useless right now. Layer hiding is handled by [/datum/species/proc/handle_mutant_bodyparts] below.

var
mutant_brain
– /obj/item/organ/brain

Replaces default brain with a different organ

var
mutant_heart
– /obj/item/organ/heart

Replaces default heart with a different organ

var
mutant_organs
– /list

Internal organs that are unique to this race, like a tail.

var
mutantappendix
– /obj/item/organ/appendix

Replaces default appendix with a different organ.

var
mutantears
– /obj/item/organ/ears

Replaces default ears with a different organ

var
mutanteyes
– /obj/item/organ/eyes

Replaces default lungs with a different organ Replaces default eyes with a different organ

var
mutanthands
– /obj/item

Forces an item into this species' hands. Only an honorary mutantthing because this is not an organ and not loaded in the same way, you've been warned to do your research.

var
mutantliver
– /obj/item/organ/liver

Replaces default liver with a different organ

var
mutantstomach
– /obj/item/organ/stomach

Replaces default stomach with a different organ

var
mutanttail
– /obj/item/organ/tail

CIT SPECIFIC Mutant tail

var
mutanttongue
– /obj/item/organ/tongue

Replaces default tongue with a different organ

var
name
–

This is the fluff name. They are displayed on health analyzers and in the character setup menu. Leave them generic for other servers to customize.

var
no_equip
– /list

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

var
nojumpsuit
–

Allows the species to equip items that normally require a jumpsuit without having one equipped. Used by golems.

var
offset_features
– /list

Clothing offsets. If a species has a different body than other species, you can offset clothing so they look less weird.

var
outfit_important_for_life
– /datum/outfit

A path to an outfit that is important for species life e.g. plasmaman outfit

var
payday_modifier
–

multiplier for money paid at payday

var
punchdamagehigh
–

Highest possible punch damage this species can give.

var
punchdamagelow
–

Lowest possible punch damage this species can give. If this is set to 0, punches will always miss.

var
punchstunthreshold
–

Damage at which punches from this race will stun

var
say_mod
–

Affects the speech message, for example: Motharula flutters, "My speech message is flutters!"

var
sexes
–

Whether or not the race has sexual characteristics (biological genders). At the moment this is only FALSE for skeletons and shadows

var
siemens_coeff
–

Base electrocution coefficient. Basically a multiplier for damage from electrocutions.

var
skinned_type
–

What skin the species drops when gibbed by a gibber machine.

var
special_step_sounds
– /list

Sounds to override barefeet walking

var
species_language_holder
–

What languages this species can understand and say. Use a language holder datum in this var.

var
species_traits
– /list

Species-only traits. Can be found in code/__DEFINES/DNA.dm

var
speedmod
–

Multiplier for the race's speed. Positive numbers make it move slower, negative numbers make it move faster.

var
stunmod
–

multiplier for stun durations

var
toxic_food
–

Bitfield for food types that the species absolutely hates, giving them even more disgust than disliked food. Meat is "toxic" to moths, for example.

var
typing_indicator_state
–

Our default override for typing indicator state

var
use_skintones
–

Does the species use skintones or not? As of now only used by humans.

var
wings_icon
–

Current wings icon

Proc Details

proc
check_roundstart_eligible
()

Checks if a species is eligible to be picked at roundstart.

Checks the config to see if this species is allowed to be picked in the character setup menu. Used by /proc/generate_selectable_species.

proc
copy_properties_from
(/datum/species/old_species)

Copies some vars and properties over that should be kept when creating a copy of this species.

Used by slimepeople to copy themselves, and by the DNA datum to hardset DNA to a species Arguments:

old_species - The species that the carbon used to be before copying

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

The human species version of /mob/living/carbon/proc/get_biological_state. Depends on the HAS_FLESH and HAS_BONE species traits, having bones lets you have bone wounds, having flesh lets you have burn, slash, and piercing wounds

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

LIFE

proc
on_species_gain
(/mob/living/carbon/C, /datum/species/old_species, pref_load)

Proc called when a carbon becomes this species.

This sets up and adds/changes/removes things, qualities, abilities, and traits so that the transformation is as smooth and bugfree as possible. Produces a [COMSIG_SPECIES_GAIN] signal. Arguments:

C - Carbon, this is whoever became the new species.
old_species - The species that the carbon used to be before becoming this race, used for regenerating organs.
pref_load - Preferences to be loaded from character setup, loads in preferred mutant things like bodyparts, digilegs, skin color, etc.

proc
random_name
(gender, unique, lastname)

Generates a random name for a carbon.

This generates a random unique name based on a human's species and gender. Arguments:

gender - The gender that the name should adhere to. Use MALE for male names, use anything else for female names.
unique - If true, ensures that this new name is not a duplicate of anyone else's name currently on the station.
lastname - Does this species' naming system adhere to the last name system? Set to false if it doesn't.

proc
regenerate_organs
(/mob/living/carbon/C, /datum/species/old_species, replace_current)

Corrects organs in a carbon, removing ones it doesn't need and adding ones it does.

Takes all organ slots, removes organs a species should not have, adds organs a species should have. can use replace_current to refresh all organs, creating an entirely new set.

Arguments:

C - carbon, the owner of the species datum AKA whoever we're regenerating organs in
old_species - datum, used when regenerate organs is called in a switching species to remove old mutant organs.
replace_current - boolean, forces all old organs to get deleted whether or not they pass the species' ability to keep that organ
excluded_zones - list, add zone defines to block organs inside of the zones from getting handled. see headless mutation for an example

species datum /datum/species

Vars

Procs

Var Details

var armor –

var ass_image – /icon

var attack_type –

var attack_verb –

var breathid –

var brutemod –

var burnmod –

var cold_offset –

var coldmod –

var damage_overlay_type –

var disliked_food –

var exotic_blood –

var exotic_blood_blend_mode –

var exotic_blood_color –

var exotic_bloodtype –

var family_heirlooms – /list

var fixed_mut_color –

var fly – /datum/action/innate/flight

var flying_species –

var grab_sound –

var grad_color –

var grad_style –

var hair_alpha –

var hair_color –

var heatmod –

var hot_offset –

var id –

var inert_mutation –

var inherent_biotypes –

var inherent_traits – /list

var liked_food –

var meat –

var mutant_bodyparts – /list

var mutant_brain – /obj/item/organ/brain

var mutant_heart – /obj/item/organ/heart

var mutant_organs – /list

var mutantappendix – /obj/item/organ/appendix

var mutantears – /obj/item/organ/ears

var mutanteyes – /obj/item/organ/eyes

var mutanthands – /obj/item

var mutantliver – /obj/item/organ/liver

var mutantstomach – /obj/item/organ/stomach

var mutanttail – /obj/item/organ/tail

var mutanttongue – /obj/item/organ/tongue

var name –

var no_equip – /list

var nojumpsuit –

var offset_features – /list

var outfit_important_for_life – /datum/outfit

var payday_modifier –

var punchdamagehigh –

var punchdamagelow –

var punchstunthreshold –

var say_mod –

var sexes –

var siemens_coeff –

var skinned_type –

var special_step_sounds – /list

var species_language_holder –

var species_traits – /list

var speedmod –

var stunmod –

var toxic_food –

var typing_indicator_state –

var use_skintones –

var wings_icon –