hostile

Vars
aggro_vision_range	If a mob is aggro, we search in this radius. Defaults to 9 to keep in line with original simple mob aggro radius
approaching_target	We should dodge now
attack_all_objects	if true, equivalent to having a wanted_objects list containing ALL objects.
attack_same	Set us to TRUE to allow us to attack our own faction
casingtype	set ONLY it and NULLIFY projectiletype, if we have projectile IN CASING
check_friendly_fire	Should the ranged mob check for friendlies when shooting
dodge_prob	Probability that we dodge
dodging	Are we dodging?
emote_taunt	List of emotes this mob can do when it taunts
friends	List of mobs this mob is friendly towards
in_melee	We should sidestep now
lose_patience_timeout	30 seconds by default, so there's no major changes to AI behaviour, beyond actually bailing if stuck forever
lose_patience_timer_id	id for a timer to call LoseTarget(), used to stop mobs fixating on a target they can't reach
melee_queue_distance	If target is close enough start preparing to hit them if we have rapid_melee enabled
minimum_distance	Minimum approach distance, so ranged mobs chase targets down, but still keep their distance set in tiles to the target, set higher to make mobs keep distance
move_to_delay	delay for the automated movement.
projectilesound	Sound our projectile makes when fired
projectiletype	set ONLY it and NULLIFY casingtype var, if we have ONLY projectile
ranged	Does this mob use ranged attacks?
ranged_cooldown	What the current cooldown on ranged attacks is, generally world.time + ranged_cooldown_time
ranged_cooldown_time	How long, in deciseconds, the cooldown of ranged attacks is
ranged_ignores_vision	if it'll fire ranged attacks even if it lacks vision on its target, only works with environment smash
ranged_message	Fluff text for ranged mobs
rapid	How many shots per volley.
rapid_fire_delay	Time between rapid fire shots
rapid_melee	Number of melee attacks between each npc pool tick. Spread evenly.
retreat_distance	If our mob runs from players when they're too close, set in tile distance. By default, mobs do not retreat.
robust_searching	By default, mobs have a simple searching method, set this to TRUE for the more scrutinous searching (stat_attack, stat_exclusive, etc), should be disabled on most mobs
search_objects	If we want to consider objects when searching around, set this to 1. If you want to search for objects while also ignoring mobs until hurt, set it to 2. To completely ignore mobs, even when attacked, set it to 3
search_objects_regain_time	The delay between being attacked and gaining our old search_objects value back
search_objects_timer_id	Timer for regaining our old search_objects value after being attacked
sidestep_per_cycle	How many sidesteps per npcpool cycle when in melee
stat_attack	Mobs ignore mob/living targets with a stat lower than that of stat_attack. If set to DEAD, then they'll include corpses in their targets, if to HARD_CRIT they'll keep attacking until they kill, and so on.
stat_exclusive	Mobs with this set to TRUE will exclusively attack things defined by stat_attack, stat_attack DEAD means they will only attack corpses
target	The current target of our attacks, use GiveTarget and LoseTarget to set this var
targets_from	all range/attack/etc. calculations should be done from the atom this weakrefs, useful for Vehicles and such.
taunt_chance	Probability that the mob will taunt
vision_range	How big of an area to search for targets in, a vision of 9 attempts to find targets as soon as they walk into screen view
wanted_objects	A typecache of objects types that will be checked against to attack, should we have search_objects enabled
Procs
AICanContinue	AI Status
ListTargets	HOSTILE MOB TARGETING AND AGGRESSION
death	END HOSTILE MOB TARGETING AND AGGRESSION

Var Details

var
aggro_vision_range
–

If a mob is aggro, we search in this radius. Defaults to 9 to keep in line with original simple mob aggro radius

var
approaching_target
–

We should dodge now

var
attack_all_objects
–

if true, equivalent to having a wanted_objects list containing ALL objects.

var
attack_same
–

Set us to TRUE to allow us to attack our own faction

var
casingtype
–

set ONLY it and NULLIFY projectiletype, if we have projectile IN CASING

var
check_friendly_fire
–

Should the ranged mob check for friendlies when shooting

var
dodge_prob
–

Probability that we dodge

var
dodging
–

Are we dodging?

var
emote_taunt
– /list

List of emotes this mob can do when it taunts

var
friends
– /list

List of mobs this mob is friendly towards

var
in_melee
–

We should sidestep now

var
lose_patience_timeout
–

30 seconds by default, so there's no major changes to AI behaviour, beyond actually bailing if stuck forever

var
lose_patience_timer_id
–

id for a timer to call LoseTarget(), used to stop mobs fixating on a target they can't reach

var
melee_queue_distance
–

If target is close enough start preparing to hit them if we have rapid_melee enabled

var
minimum_distance
–

Minimum approach distance, so ranged mobs chase targets down, but still keep their distance set in tiles to the target, set higher to make mobs keep distance

var
move_to_delay
–

delay for the automated movement.

var
projectilesound
–

Sound our projectile makes when fired

var
projectiletype
–

set ONLY it and NULLIFY casingtype var, if we have ONLY projectile

var
ranged
–

Does this mob use ranged attacks?

var
ranged_cooldown
–

What the current cooldown on ranged attacks is, generally world.time + ranged_cooldown_time

var
ranged_cooldown_time
–

How long, in deciseconds, the cooldown of ranged attacks is

var
ranged_ignores_vision
–

if it'll fire ranged attacks even if it lacks vision on its target, only works with environment smash

var
ranged_message
–

Fluff text for ranged mobs

var
rapid
–

How many shots per volley.

var
rapid_fire_delay
–

Time between rapid fire shots

var
rapid_melee
–

Number of melee attacks between each npc pool tick. Spread evenly.

var
retreat_distance
–

If our mob runs from players when they're too close, set in tile distance. By default, mobs do not retreat.

var
robust_searching
–

By default, mobs have a simple searching method, set this to TRUE for the more scrutinous searching (stat_attack, stat_exclusive, etc), should be disabled on most mobs

var
search_objects
–

If we want to consider objects when searching around, set this to 1. If you want to search for objects while also ignoring mobs until hurt, set it to 2. To completely ignore mobs, even when attacked, set it to 3

var
search_objects_regain_time
–

The delay between being attacked and gaining our old search_objects value back

var
search_objects_timer_id
–

Timer for regaining our old search_objects value after being attacked

var
sidestep_per_cycle
–

How many sidesteps per npcpool cycle when in melee

var
stat_attack
–

Mobs ignore mob/living targets with a stat lower than that of stat_attack. If set to DEAD, then they'll include corpses in their targets, if to HARD_CRIT they'll keep attacking until they kill, and so on.

var
stat_exclusive
–

Mobs with this set to TRUE will exclusively attack things defined by stat_attack, stat_attack DEAD means they will only attack corpses

var
target
– /atom

The current target of our attacks, use GiveTarget and LoseTarget to set this var

var
targets_from
– /datum/weakref

all range/attack/etc. calculations should be done from the atom this weakrefs, useful for Vehicles and such.

var
taunt_chance
–

Probability that the mob will taunt

var
vision_range
–

How big of an area to search for targets in, a vision of 9 attempts to find targets as soon as they walk into screen view

var
wanted_objects
– /list

A typecache of objects types that will be checked against to attack, should we have search_objects enabled

Proc Details

proc
AICanContinue
(/list/possible_targets)

AI Status

proc
ListTargets
()

HOSTILE MOB TARGETING AND AGGRESSION

death
(gibbed)

END HOSTILE MOB TARGETING AND AGGRESSION

hostile /mob/living/simple_animal/hostile

Vars

Procs

Var Details

var aggro_vision_range –

var approaching_target –

var attack_all_objects –

var attack_same –

var casingtype –

var check_friendly_fire –

var dodge_prob –

var dodging –

var emote_taunt – /list

var friends – /list

var in_melee –

var lose_patience_timeout –

var lose_patience_timer_id –

var melee_queue_distance –

var minimum_distance –

var move_to_delay –

var projectilesound –

var projectiletype –

var ranged –

var ranged_cooldown –

var ranged_cooldown_time –

var ranged_ignores_vision –

var ranged_message –

var rapid –

var rapid_fire_delay –

var rapid_melee –

var retreat_distance –

var robust_searching –

var search_objects –

var search_objects_regain_time –

var search_objects_timer_id –

var sidestep_per_cycle –

var stat_attack –

var stat_exclusive –

var target – /atom

var targets_from – /datum/weakref

var taunt_chance –

var vision_range –

var wanted_objects – /list