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
allow_numbers_in_name	Can this species use numbers in its name?
armor	Percentage modifier for overall defense of the race, or less defense, if it's negative.
attack_type	Type of damage attack does. Ethereals attack with burn damage for example.
attack_verb	Punch-specific attack verb.
bodytemp_autorecovery_min	Minimum amount of kelvin moved toward normal body temperature per tick.
bodytemp_cold_damage_limit	The body temperature limit the body can take before it starts taking damage from cold.
bodytemp_heat_damage_limit	The body temperature limit the body can take before it starts taking damage from heat.
bodytemp_normal	The natural temperature for a body
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
changesource_flags	Bitflag that controls what in game ways something can select this species as a spawnable source, such as magic mirrors. See [mob defines][code/_DEFINES/mobs.dm] for possible sources.
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.
deathsound	Used to set the mob's deathsound upon species change
default_features	Default mutant bodyparts for this species, like horns. Don't forget to set one for every mutant bodypart you allow this species to have.
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_bloodtype	If your race uses a non standard bloodtype (A+, O-, AB-, etc). For example, lizards have L type blood.
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
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
has_innate_wings	Used to determine what description to give when using a potion of flight, if false it will describe them as growing new wings
heatmod	multiplier for damage from hot temperature
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_factions	List of factions the mob gain upon gaining this species.
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. Layer hiding is handled by datum/species/handle_mutant_bodyparts() below.
mutant_organs	Internal organs that are unique to this race, like a tail.
mutantappendix	Replaces default appendix with a different organ.
mutantbrain	Replaces default brain with a different organ
mutantears	Replaces default ears with a different organ
mutanteyes	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.
mutantheart	Replaces default heart with a different organ
mutantliver	Replaces default liver with a different organ
mutantlungs	Replaces default lungs with a different organ
mutantstomach	Replaces default stomach with a different organ
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
override_float	Allows the species to not give a single F about gravity. Used by wings.
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
reagent_tag	Used for metabolizing reagents. We're going to assume you're a meatbag unless you say otherwise.
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_gibs	Does this mob have special gibs?
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.
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
give_important_for_life	Equip the outfit required for life. Replaces items currently worn.
handle_body	Handles the body of a human
handle_body_temperature	Handle the body temperature status effects for the species Traits for resitance to heat or cold are handled here.
handle_environment	Enviroment handler for species
handle_environment_pressure	Handle the air pressure of the environment
handle_hair	Handles hair icons and dynamic hair.
handle_mutant_bodyparts	Handles the mutant bodyparts of a human
harm	This proc handles punching damage. IMPORTANT: Our owner is the TARGET and not the USER in this proc. For whatever reason...
natural_bodytemperature_stabilization	Used to stabilize the body temperature back to normal on living mobs
on_species_gain	Proc called when a carbon becomes this species.
on_species_loss	Proc called when a carbon is no longer this species.
qualifies_for_rank	Checks if this carbon is allowed to be a certain job or rank.
random_name	Generates a random name for a carbon.
regenerate_organs

Var Details

var
allow_numbers_in_name
–

Can this species use numbers in its name?

var
armor
–

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

var
attack_type
–

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

var
attack_verb
–

Punch-specific attack verb.

var
bodytemp_autorecovery_min
–

Minimum amount of kelvin moved toward normal body temperature per tick.

var
bodytemp_cold_damage_limit
–

The body temperature limit the body can take before it starts taking damage from cold.

var
bodytemp_heat_damage_limit
–

The body temperature limit the body can take before it starts taking damage from heat.

var
bodytemp_normal
–

The natural temperature for a body

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
changesource_flags
–

Bitflag that controls what in game ways something can select this species as a spawnable source, such as magic mirrors. See [mob defines][code/_DEFINES/mobs.dm] for possible sources.

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
deathsound
–

Used to set the mob's deathsound upon species change

var
default_features
– /list

Default mutant bodyparts for this species, like horns. Don't forget to set one for every mutant bodypart you allow this species to have.

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_bloodtype
–

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

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
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
has_innate_wings
–

Used to determine what description to give when using a potion of flight, if false it will describe them as growing new wings

var
heatmod
–

multiplier for damage from hot temperature

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_factions
– /list

List of factions the mob gain upon gaining this species.

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. Layer hiding is handled by datum/species/handle_mutant_bodyparts() below.

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
mutantbrain
– /obj/item/organ/brain

Replaces default brain 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 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
mutantheart
– /obj/item/organ/heart

Replaces default heart with a different organ

var
mutantliver
– /obj/item/organ/liver

Replaces default liver with a different organ

var
mutantlungs
– /obj/item/organ/lungs

Replaces default lungs with a different organ

var
mutantstomach
– /obj/item/organ/stomach

Replaces default stomach with a different organ

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
override_float
–

Allows the species to not give a single F about gravity. Used by wings.

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
reagent_tag
–

Used for metabolizing reagents. We're going to assume you're a meatbag unless you say otherwise.

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_gibs
–

Does this mob have special gibs?

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
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
give_important_for_life
(/mob/living/carbon/human/human_to_equip)

Equip the outfit required for life. Replaces items currently worn.

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

Handles the body of a human

Handles lipstick, having no eyes, eye color, undergarnments like underwear, undershirts, and socks, and body layers. Calls handle_mutant_bodyparts Arguments:

H - Human, whoever we're handling the body for

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

Handle the body temperature status effects for the species Traits for resitance to heat or cold are handled here.

proc
handle_environment
(/datum/gas_mixture/environment, /mob/living/carbon/human/H)

Enviroment handler for species

vars:

environment The environment gas mix
H The mob we will stabilize

proc
handle_environment_pressure
(/datum/gas_mixture/environment, /mob/living/carbon/human/H)

Handle the air pressure of the environment

proc
handle_hair
(/mob/living/carbon/human/H, forced_colour)

Handles hair icons and dynamic hair.

Handles hiding hair with clothing, hair layers, losing hair due to husking or augmented heads, facial hair, head hair, and hair styles. Arguments:

H - Human, whoever we're handling the hair for
forced_colour - The colour of hair we're forcing on this human. Leave null to not change. Mind the british spelling!

proc
handle_mutant_bodyparts
(/mob/living/carbon/human/H, forced_colour)

Handles the mutant bodyparts of a human

Handles the adding and displaying of, layers, colors, and overlays of mutant bodyparts and accessories. Handles digitigrade leg displaying and squishing. Arguments:

H - Human, whoever we're handling the body for
forced_colour - The forced color of an accessory. Leave null to use mutant color.

proc
harm
(/mob/living/carbon/human/user, /mob/living/carbon/human/target, /datum/martial_art/attacker_style)

This proc handles punching damage. IMPORTANT: Our owner is the TARGET and not the USER in this proc. For whatever reason...

proc
natural_bodytemperature_stabilization
(/datum/gas_mixture/environment, /mob/living/carbon/human/H)

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

vars:

environment The environment gas mix
H The mob we will stabilize

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
on_species_loss
(/mob/living/carbon/human/C, /datum/species/new_species, pref_load)

Proc called when a carbon is no longer 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_LOSS] signal. Arguments:

C - Carbon, this is whoever lost this species.
new_species - The new species that the carbon became, used for genetics mutations.
pref_load - Preferences to be loaded from character setup, loads in preferred mutant things like bodyparts, digilegs, skin color, etc.

proc
qualifies_for_rank
(rank, /list/features)

Checks if this carbon is allowed to be a certain job or rank.

Override this locally if you want to define when this species qualifies for what rank if human authority is enforced. Arguments:

rank - Rank to be tested.
features - Features of a species that factors into rank qualifications, like a human with cat ears being unable to join command positions.

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, /list/excluded_zones)

regenerate_organs
- 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 allow_numbers_in_name –

var armor –

var attack_type –

var attack_verb –

var bodytemp_autorecovery_min –

var bodytemp_cold_damage_limit –

var bodytemp_heat_damage_limit –

var bodytemp_normal –

var breathid –

var brutemod –

var burnmod –

var changesource_flags –

var coldmod –

var damage_overlay_type –

var deathsound –

var default_features – /list

var disliked_food –

var exotic_blood –

var exotic_bloodtype –

var fixed_mut_color –

var fly – /datum/action/innate/flight

var flying_species –

var grab_sound –

var hair_alpha –

var hair_color –

var has_innate_wings –

var heatmod –

var id –

var inert_mutation –

var inherent_biotypes –

var inherent_factions – /list

var inherent_traits – /list

var liked_food –

var meat –

var mutant_bodyparts – /list

var mutant_organs – /list

var mutantappendix – /obj/item/organ/appendix

var mutantbrain – /obj/item/organ/brain

var mutantears – /obj/item/organ/ears

var mutanteyes – /obj/item/organ/eyes

var mutanthands – /obj/item

var mutantheart – /obj/item/organ/heart

var mutantliver – /obj/item/organ/liver

var mutantlungs – /obj/item/organ/lungs

var mutantstomach – /obj/item/organ/stomach

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 override_float –

var punchdamagehigh –

var punchdamagelow –

var punchstunthreshold –

var reagent_tag –

var say_mod –

var sexes –

var siemens_coeff –

var skinned_type –

var special_step_sounds – /list

var species_gibs –

var species_language_holder –

var species_traits – /list

var speedmod –

var stunmod –

var toxic_food –

var use_skintones –

var wings_icon –