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
atmos_requirements	Leaving something at 0 means it's off - has no maximum.
attack_verb_continuous	Basic mob's own attacks verbs, Attacking verb in present continuous tense.
attack_verb_simple	Attacking verb in present simple tense.
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
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.
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
minimum_survivable_temperature	Minimal body temperature without receiving damage
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.
speed	Higher speed is slower, negative speed is faster
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
atmos_requirements
– /list

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

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

Minimal body temperature without receiving damage

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

Higher speed is slower, negative speed is faster

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

var attack_verb_continuous –

var attack_verb_simple –

var damage_coeff – /list

var death_message –

var death_sound –

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 master_commander – /mob/living/carbon/human

var maximum_survivable_temperature –

var minimum_survivable_temperature –

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

var unintelligble_phrases – /list

var unsuitable_atmos_damage –

var unsuitable_cold_damage –

var unsuitable_heat_damage –