/datum/species

BODYPARTS

Vars
acidmod	multiplier for acid damage // yogs - Old Plant People
action_speed_coefficient	base action speed coefficient
aiminginaccuracy	values of inaccuracy that adds to the spread of any ranged weapon
allow_numbers_in_name	Can this species use numbers in its name?
armor	overall defense for the race... or less defense, if it's negative.
attack_effect	The visual effect of the attack.
attack_sound	the melee attack sound
attack_type	Type of damage attack does
attack_verbs	punch-specific attack verbs
barefoot_step_sound	Barefoot step sound
breathid	what type of gas is breathed
brutemod	multiplier for brute damage
bubble_icon	Special typing indicators
burnmod	multiplier for burn damage
changesource_flags	Bitflag that controls what in game ways can select this species as a spawnable source. Think magic mirror and pride mirror, slime extract, ERT etc, see defines in __DEFINES/mobs.dm, defaults to NONE, so people actually have to think about it
clonemod	multiplier for cloneloss
coldmod	multiplier for cold damage
damage_overlay_type	what kind of damage overlays (if any) appear on our species when wounded?
deathsound	used to set the mobs deathsound on species change
default_color	if alien colors are disabled, this is the color that will be used by that race
default_features	Default mutant bodyparts for this species. Don't forget to set one for every mutant bodypart you allow this species to have.
disliked_food	What kind of foods the species dislikes!
emp_mod	multiplier for EMP severity
exotic_blood	If your race wants to bleed something other than bog standard blood, change this to reagent id.
exotic_bloodtype	If your race uses a non standard bloodtype (A+, O-, AB-, etc)
extra_no_equip	slots the race can't equip stuff to that have been added externally that should be inherited on species change
eyes_icon	Icon containing eye sprites, this is copied to the head upon updating the head
fire_overlay	The icon_state of the fire overlay added when sufficently ablaze and standing. see onfire.dmi
fixed_mut_color	to use MUTCOLOR with a fixed color that's independent of dna.feature["mcolor"]
fly	the actual flying ability given to flying species
flying_species	is a flying species, just a check for some things
generate_husk_icon	Should we use the same static husk sprite or create a husk sprite on-the-fly by recoloring bodyparts
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 transparent.
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
heatmod	multiplier for heat damage
id	if the game needs to manually check your race to do something not included in a proc here, it will use this
ignored_by	list of mobs that will ignore this species
inert_mutation	special mutation that can be found in the genepool. Dont leave empty or changing species will be a headache
inherent_biotypes	biotypes, used for viruses and the like
inherent_traits	generic traits tied to having the species
instantiated_abilities	List of the created abilities, stored for the purpose of removal later, please do not touch this if you don't need to
is_dimorphic	Does this species have different sprites according to sex? A species may have sexes, but only one kind of bodypart sprite like chests
liked_food	What kind of foods the species loves
limbs_id	this is used if you want to use a different species limb sprites. Mainly used for angels as they look like humans.
meat	What the species drops on gibbing
miss_sound	the swing and miss sound
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 handle_mutant_bodyparts() below.
mutant_organs	Internal organs that are unique to this race.
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
mutanttail	Forces a species tail
mutanttongue	Replaces default tongue with a different organ
name	this is the fluff name. these will be left generic (such as 'Lizardperson' for the lizard race) so servers can change them to whatever
no_equip	slots the race can't equip stuff to
nojumpsuit	this is sorta... weird. it basically lets you equip stuff that usually needs jumpsuits without one, like belts and pockets and ids
offset_features	A list that contains pixel offsets for various clothing features, if your species is a different shape
oxymod	multiplier for oxyloss
plural_form	The formatting of the name of the species in plural context. Defaults to "[name]\s" if unset. Ex "[Plasmamen] are weak", "[Mothmen] are strong", "[Lizardpeople] don't like", "[Golems] hate"
possible_genders	What genders can this race be?
pressuremod	multiplier for pressure damage
prevent_perspective_change	Do we try to prevent reset_perspective() from working? Useful for Dullahans to stop perspective changes when they're looking through their head.
punchdamagehigh	highest possible punch damage
punchdamagelow	lowest possible punch damage. if this is set to 0, punches will always miss
punchstunthreshold	damage at which punches from this race will stun //yes it should be to the attacked race but it's not useful that way even if it's logical
rare_say_mod	Weighted list. NOTE: Picks one of the list component and then does a prob() on it, since we can't do a proper weighted pick, since we need to take into account the regular say_mod.
say_mod	affects the speech message
screamsound	yogs - audio of a species' scream
siemens_coeff	base electrocution coefficient
skinned_type	What, if any, leather will be dropped
special_step_sounds	Sounds to override barefeet walking
special_step_volume	How loud to play the step override
special_walk_sounds	Sounds to play while walking regardless of wearing shoes
species_abilities	List of the type path of every ability innate to this species
species_gibs	What kind of gibs to spawn
species_language_holder	Used if you want to give your species thier own language
species_traits	species-only traits. Can be found in DNA.dm
speedmod	this affects the race's speed. positive numbers make it move slower, negative numbers make it move faster
staminamod	multiplier for stun duration
static_part_body_zones	Which body zones contain "static" sprite parts, which are independent of the rest of the sprite
stunmod	multiplier for stun duration
suicide_messages	Species specific suicide messages, these are added to the global list of human suicide messages
survival_box_replacements	Items to add to and remove from the survival box in backpacks
tempmod	multiplier for temperature adjustment
toxic_food	What kind of foods cause harm to the species
toxmod	multiplier for toxloss
use_damage_color	Does our species have colors for its' damage overlays?
use_skintones	does it use skintones or not? (spoiler alert this is only used by humans)
wings_icon	the icon used for the wings + details icon of a different source colour
Procs
check_roundstart_eligible	Checks if a species is eligible to be picked at roundstart.
create_pref_biotypes_perks	Adds adds any perks related to the species' inherent_biotypes flags.
create_pref_blood_perks	Adds adds any perks related to the species' blood (or lack thereof).
create_pref_combat_perks	Adds adds any perks related to combat. For example, the damage type of their punches.
create_pref_damage_perks	Adds adds any perks related to sustaining damage. For example, brute damage vulnerability, or fire damage resistance.
create_pref_language_perk	Adds in a language perk based on all the languages the species can speak by default (according to their language holder).
create_pref_temperature_perks	Adds adds any perks related to how the species deals with temperature.
create_pref_traits_perks	Adds adds any perks related to the species' inherent_traits list.
create_pref_unique_perks	Used to add any species specific perks to the perk list.
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
get_butt_sprite	Sprite to show for photocopying mob butts
get_cough_sound	Returns the species' cough sound.
get_cry_sound	Returns the species' cry sound.
get_eyes_static	Species with eyes bigger than 1px may have an independent part of the eye sprite
get_features	Returns a list of strings representing features this species has. Used by the preferences UI to know what buttons to show.
get_laugh_sound	Returns the species' laugh sound
get_scream_sound	Returns the species' scream sound.
get_sneeze_sound	Returns the species' sneeze sound.
get_special_statics	Species with static sprite parts in their bodyparts, may have variant static parts. Example is the Mossy Vox skin tone, which looks much scruffier than the others
get_species_description	Gets a short description for the specices. Should be relatively succinct. Used in the preference menu.
get_species_diet	Translate the species liked foods from bitfields into strings and returns it in the form of an associated list.
get_species_lore	Gets the lore behind the type of species. Can be long. Used in the preference menu.
get_species_perks	Generates a list of "perks" related to this species (Postives, neutrals, and negatives) in the format of a list of lists. Used in the preference menu.
prepare_human_for_preview	Given a human, will adjust it before taking a picture for the preferences UI. This should create a CONSISTENT result, so the icons don't randomly change.
regenerate_organs	Corrects organs in a carbon, removing ones it doesn't need and adding ones it does.
survival_box_replacement	Proc to swap out contents of survival boxes for species with different contents, examples are Plasmamen and Vox

Var Details

var
acidmod
–

multiplier for acid damage // yogs - Old Plant People

var
action_speed_coefficient
–

base action speed coefficient

var
aiminginaccuracy
–

values of inaccuracy that adds to the spread of any ranged weapon

var
allow_numbers_in_name
–

Can this species use numbers in its name?

var
armor
–

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

var
attack_effect
–

The visual effect of the attack.

var
attack_sound
– /sound

the melee attack sound

var
attack_type
–

Type of damage attack does

var
attack_verbs
– /list

punch-specific attack verbs

var
barefoot_step_sound
–

Barefoot step sound

var
breathid
–

what type of gas is breathed

var
brutemod
–

multiplier for brute damage

var
bubble_icon
–

Special typing indicators

var
burnmod
–

multiplier for burn damage

var
changesource_flags
–

Bitflag that controls what in game ways can select this species as a spawnable source. Think magic mirror and pride mirror, slime extract, ERT etc, see defines in __DEFINES/mobs.dm, defaults to NONE, so people actually have to think about it

var
clonemod
–

multiplier for cloneloss

var
coldmod
–

multiplier for cold damage

var
damage_overlay_type
–

what kind of damage overlays (if any) appear on our species when wounded?

var
deathsound
–

used to set the mobs deathsound on species change

var
default_color
–

if alien colors are disabled, this is the color that will be used by that race

var
default_features
– /list

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

var
disliked_food
–

What kind of foods the species dislikes!

var
emp_mod
–

multiplier for EMP severity

var
exotic_blood
– /datum/reagent

If your race wants to bleed something other than bog standard blood, change this to reagent id.

var
exotic_bloodtype
–

If your race uses a non standard bloodtype (A+, O-, AB-, etc)

var
extra_no_equip
– /list

slots the race can't equip stuff to that have been added externally that should be inherited on species change

var
eyes_icon
–

Icon containing eye sprites, this is copied to the head upon updating the head

var
fire_overlay
–

The icon_state of the fire overlay added when sufficently ablaze and standing. see onfire.dmi

var
fixed_mut_color
–

to use MUTCOLOR with a fixed color that's independent of dna.feature["mcolor"]

var
fly
– /datum/action/innate/flight

the actual flying ability given to flying species

var
flying_species
–

is a flying species, just a check for some things

var
generate_husk_icon
–

Should we use the same static husk sprite or create a husk sprite on-the-fly by recoloring bodyparts

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

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

var
heatmod
–

multiplier for heat damage

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
ignored_by
– /list/mob/living

list of mobs that will ignore this species

var
inert_mutation
–

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

var
inherent_biotypes
– /list

biotypes, used for viruses and the like

var
inherent_traits
– /list

generic traits tied to having the species

var
instantiated_abilities
– /list/datum/action

List of the created abilities, stored for the purpose of removal later, please do not touch this if you don't need to

var
is_dimorphic
–

Does this species have different sprites according to sex? A species may have sexes, but only one kind of bodypart sprite like chests

var
liked_food
–

What kind of foods the species loves

var
limbs_id
–

this is used if you want to use a different species limb sprites. Mainly used for angels as they look like humans.

var
meat
–

What the species drops on gibbing

var
miss_sound
– /sound

the swing and miss sound

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 handle_mutant_bodyparts() below.

var
mutant_organs
– /list

Internal organs that are unique to this race.

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
mutanttail
– /obj/item/organ/tail

Forces a species tail

var
mutanttongue
– /obj/item/organ/tongue

Replaces default tongue with a different organ

var
name
–

this is the fluff name. these will be left generic (such as 'Lizardperson' for the lizard race) so servers can change them to whatever

var
no_equip
– /list

slots the race can't equip stuff to

var
nojumpsuit
–

this is sorta... weird. it basically lets you equip stuff that usually needs jumpsuits without one, like belts and pockets and ids

var
offset_features
– /list

A list that contains pixel offsets for various clothing features, if your species is a different shape

var
oxymod
–

multiplier for oxyloss

var
plural_form
–

The formatting of the name of the species in plural context. Defaults to "[name]\s" if unset. Ex "[Plasmamen] are weak", "[Mothmen] are strong", "[Lizardpeople] don't like", "[Golems] hate"

var
possible_genders
– /list

What genders can this race be?

var
pressuremod
–

multiplier for pressure damage

var
prevent_perspective_change
–

Do we try to prevent reset_perspective() from working? Useful for Dullahans to stop perspective changes when they're looking through their head.

var
punchdamagehigh
–

highest possible punch damage

var
punchdamagelow
–

lowest possible punch damage. if this is set to 0, punches will always miss

var
punchstunthreshold
–

damage at which punches from this race will stun //yes it should be to the attacked race but it's not useful that way even if it's logical

var
rare_say_mod
– /list

Weighted list. NOTE: Picks one of the list component and then does a prob() on it, since we can't do a proper weighted pick, since we need to take into account the regular say_mod.

var
say_mod
–

affects the speech message

var
screamsound
–

yogs - audio of a species' scream

var
siemens_coeff
–

base electrocution coefficient

var
skinned_type
–

What, if any, leather will be dropped

var
special_step_sounds
– /list

Sounds to override barefeet walking

var
special_step_volume
–

How loud to play the step override

var
special_walk_sounds
– /list

Sounds to play while walking regardless of wearing shoes

var
species_abilities
– /list

List of the type path of every ability innate to this species

var
species_gibs
–

What kind of gibs to spawn

var
species_language_holder
–

Used if you want to give your species thier own language

var
species_traits
– /list

species-only traits. Can be found in DNA.dm

var
speedmod
–

this affects the race's speed. positive numbers make it move slower, negative numbers make it move faster

var
staminamod
–

multiplier for stun duration

var
static_part_body_zones
– /list

Which body zones contain "static" sprite parts, which are independent of the rest of the sprite

var
stunmod
–

multiplier for stun duration

var
suicide_messages
– /list

Species specific suicide messages, these are added to the global list of human suicide messages

var
survival_box_replacements
– /list

Items to add to and remove from the survival box in backpacks

var
tempmod
–

multiplier for temperature adjustment

var
toxic_food
–

What kind of foods cause harm to the species

var
toxmod
–

multiplier for toxloss

var
use_damage_color
–

Does our species have colors for its' damage overlays?

var
use_skintones
–

does it use skintones or not? (spoiler alert this is only used by humans)

var
wings_icon
–

the icon used for the wings + details icon of a different source colour

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.