basic

Basic mobs are a modern replacement for the simple_animal/"simple mob" system. Rather than deep type trees with overrides for AI, basic mobs rely on their AI controllers for the majority of their behavior.

It is also intended that as little implementation as possible be part of the basic mob definition directly; rather, as much behavior as possible should be delegated to components and elements, such as /datum/element/atmos_requirements for handling reacting to atmosphere, and /datum/element/body_temperature for handling changes in body temperature.

Migrating simple mobs to basic mobs is an incremental effort; and refactors should be considered before making large changes to existing simple mob code.

Vars
armor_penetration_flat	Flat armour reduction, occurs after percentage armour penetration.
armor_penetration_percentage	Percentage armour reduction, happens before flat armour reduction.
atmos_requirements	Leaving something at 0 means it's off - has no maximum.
attack_sound	Sound played when the critter attacks.
attack_verb_continuous	Basic mob's own attacks verbs, Attacking verb in present continuous tense.
attack_verb_simple	Attacking verb in present simple tense.
attacked_sound	Sound played when the critter is attacked.
can_be_on_fire	Can this mob ignite?
casing_type	What casing type is the projectile?
damage_coeff	1 for full damage, 0 for none, -1 for 1:1 heal from that source.
death_message	The message displayed on death
death_sound	The sound played on death
environment_smash	What can this mob break?
fire_damage	How much fire damage does a mob take?
force_threshold	Minimum force required to deal any damage
friendly_verb_continuous	Attacking, but without damage, verb in present continuous tense.
friendly_verb_simple	Attacking, but without damage, verb in present simple tense.
gold_core_spawnable	If the mob can be spawned with a gold slime core. HOSTILE_SPAWN are spawned with plasma, FRIENDLY_SPAWN are spawned with blood
harm_intent_damage	The amount of damage done to the mob when hand-attacked on harm intent.
icon_dead	Icon when the animal is dead.
icon_gib	We only try to show a gibbing animation if this exists.
icon_living	Icon to use when the animal is alive.
icon_resting	Icon when the animal is resting
is_ranged	Does this type do range attacks?
loot	Loot this mob drops on death.
master_commander	Holding var for determining who own/controls a sentient simple animal (for sentience potions).
maximum_survivable_temperature	Maximal body temperature without receiving damage
melee_attack_cooldown_max	Upper bound for melee attack cooldown
melee_attack_cooldown_min	Lower bound for melee attack cooldown
melee_damage_lower	Lower bound of damage done by unarmed melee attacks.
melee_damage_type	Damage type of a simple mob's melee attack, should it do damage.
melee_damage_upper	Upper bound of damage done by unarmed melee attacks.
minimum_survivable_temperature	Minimal body temperature without receiving damage
nest	Compatibility with mob spawners
obj_damage	How much damage this simple animal does to objects, if any
projectile_sound	What sound does it make when firing?
projectile_type	What projectile do we shoot?
ranged_burst_count	How many shots in a burst?
ranged_burst_interval	How fast do we fire between shots in a burst?
ranged_cooldown	Time between bursts
response_disarm_continuous	Disarm-intent verb in present continuous tense.
response_disarm_simple	Disarm-intent verb in present simple tense.
response_harm_continuous	Harm-intent verb in present continuous tense.
response_harm_simple	Harm-intent verb in present simple tense.
response_help_continuous	When someone interacts with the simple animal. Help-intent verb in present continuous tense.
response_help_simple	Help-intent verb in present simple tense.
sentience_type	Sentience type, for slime potions
speed	Higher speed is slower, negative speed is faster
step_type	Footsteps
unintelligble_phrases	What is heard by mobs who cannot understand this one when speaking. This doesn't feel like it belongs here but say code and language code is a mess to untangle so maybe it can move somewhere later.
unsuitable_atmos_damage	This damage is taken when atmos doesn't fit all the requirements above. Set to 0 to avoid adding the atmos_requirements element.
unsuitable_cold_damage	This damage is taken when the body temp is too cold. Set both this and unsuitable_heat_damage to 0 to avoid adding the body_temp_sensitive element.
unsuitable_heat_damage	This damage is taken when the body temp is too hot. Set both this and unsuitable_cold_damage to 0 to avoid adding the body_temp_sensitive element.
Procs
valid_respawn_target_for	Return whether or not ghosts can take over this mob via "Respawn as NPC"

Var Details

var
armor_penetration_flat

Flat armour reduction, occurs after percentage armour penetration.

var
armor_penetration_percentage

Percentage armour reduction, happens before flat armour reduction.

var
atmos_requirements
– /list

Leaving something at 0 means it's off - has no maximum.

var
attack_sound

Sound played when the critter attacks.

var
attack_verb_continuous

Basic mob's own attacks verbs, Attacking verb in present continuous tense.

var
attack_verb_simple

Attacking verb in present simple tense.

var
attacked_sound

Sound played when the critter is attacked.

var
can_be_on_fire

Can this mob ignite?

var
casing_type

What casing type is the projectile?

var
damage_coeff
– /list

1 for full damage, 0 for none, -1 for 1:1 heal from that source.

var
death_message

The message displayed on death

var
death_sound

The sound played on death

var
environment_smash

What can this mob break?

var
fire_damage

How much fire damage does a mob take?

var
force_threshold

Minimum force required to deal any damage

var
friendly_verb_continuous

Attacking, but without damage, verb in present continuous tense.

var
friendly_verb_simple

Attacking, but without damage, verb in present simple tense.

var
gold_core_spawnable

If the mob can be spawned with a gold slime core. HOSTILE_SPAWN are spawned with plasma, FRIENDLY_SPAWN are spawned with blood

var
harm_intent_damage

The amount of damage done to the mob when hand-attacked on harm intent.

var
icon_dead

Icon when the animal is dead.

var
icon_gib

We only try to show a gibbing animation if this exists.

var
icon_living

Icon to use when the animal is alive.

var
icon_resting

Icon when the animal is resting

var
is_ranged

Does this type do range attacks?

var
loot
– /list

Loot this mob drops on death.

var
master_commander
– /mob/living/carbon/human

Holding var for determining who own/controls a sentient simple animal (for sentience potions).

var
maximum_survivable_temperature

Maximal body temperature without receiving damage

var
melee_attack_cooldown_max

Upper bound for melee attack cooldown

var
melee_attack_cooldown_min

Lower bound for melee attack cooldown

var
melee_damage_lower

Lower bound of damage done by unarmed melee attacks.

var
melee_damage_type

Damage type of a simple mob's melee attack, should it do damage.

var
melee_damage_upper

Upper bound of damage done by unarmed melee attacks.

var
minimum_survivable_temperature

Minimal body temperature without receiving damage

var
nest
– /datum/component/spawner

Compatibility with mob spawners

var
obj_damage

How much damage this simple animal does to objects, if any

var
projectile_sound

What sound does it make when firing?

var
projectile_type

What projectile do we shoot?

var
ranged_burst_count

How many shots in a burst?

var
ranged_burst_interval

How fast do we fire between shots in a burst?

var
ranged_cooldown

Time between bursts

var
response_disarm_continuous

Disarm-intent verb in present continuous tense.

var
response_disarm_simple

Disarm-intent verb in present simple tense.

var
response_harm_continuous

Harm-intent verb in present continuous tense.

var
response_harm_simple

Harm-intent verb in present simple tense.

var
response_help_continuous

When someone interacts with the simple animal. Help-intent verb in present continuous tense.

var
response_help_simple

Help-intent verb in present simple tense.

var
sentience_type

Sentience type, for slime potions

var
speed

Higher speed is slower, negative speed is faster

var
step_type

Footsteps

var
unintelligble_phrases
– /list

What is heard by mobs who cannot understand this one when speaking. This doesn't feel like it belongs here but say code and language code is a mess to untangle so maybe it can move somewhere later.

var
unsuitable_atmos_damage

This damage is taken when atmos doesn't fit all the requirements above. Set to 0 to avoid adding the atmos_requirements element.

var
unsuitable_cold_damage

This damage is taken when the body temp is too cold. Set both this and unsuitable_heat_damage to 0 to avoid adding the body_temp_sensitive element.

var
unsuitable_heat_damage

This damage is taken when the body temp is too hot. Set both this and unsuitable_cold_damage to 0 to avoid adding the body_temp_sensitive element.

Proc Details

proc
valid_respawn_target_for
(/mob/user)

Return whether or not ghosts can take over this mob via "Respawn as NPC"

Basic Mob /mob/living/basic

Vars

Procs

Var Details

var armor_penetration_flat

var armor_penetration_percentage

var atmos_requirements – /list

var attack_sound

var attack_verb_continuous

var attack_verb_simple

var attacked_sound

var can_be_on_fire

var casing_type

var damage_coeff – /list

var death_message

var death_sound

var environment_smash

var fire_damage

var force_threshold

var friendly_verb_continuous

var friendly_verb_simple

var gold_core_spawnable

var harm_intent_damage

var icon_dead

var icon_gib

var icon_living

var icon_resting

var is_ranged

var loot – /list

var master_commander – /mob/living/carbon/human

var maximum_survivable_temperature

var melee_attack_cooldown_max

var melee_attack_cooldown_min

var melee_damage_lower

var melee_damage_type

var melee_damage_upper

var minimum_survivable_temperature

var nest – /datum/component/spawner

var obj_damage

var projectile_sound

var projectile_type

var ranged_burst_count

var ranged_burst_interval

var ranged_cooldown

var response_disarm_continuous

var response_disarm_simple

var response_harm_continuous

var response_harm_simple

var response_help_continuous

var response_help_simple

var sentience_type

var speed

var step_type

var unintelligble_phrases – /list

var unsuitable_atmos_damage

var unsuitable_cold_damage

var unsuitable_heat_damage