ai_controller

Vars
ai_movement	Reference to the movement datum we use. Is a type on initialize but becomes a ref afterwards.
ai_status	Current status of AI (OFF/ON)
ai_traits	Bitfield of traits for this AI to handle extra behavior
behavior_args	Stored arguments for behaviors given during their initial creation
behavior_cooldowns	Current actions and their respective last time ran as an assoc list.
blackboard	This is a list of variables the AI uses and can be mutated by actions. When an action is performed you pass this list and any relevant keys for the variables it can mutate.
continue_processing_when_client	Can the AI remain in control if there is a client?
current_behaviors	Current actions being performed by the AI.
current_movement_target	Current movement target of the AI, generally set by decision making.
failed_planning_cooldown	Cooldown for new plans, to prevent AI from going nuts if it can't think of new plans and looping on end
idle_behavior	The idle behavior this AI performs when it has no actions.
max_target_distance	distance to give up on target
movement_cooldown	Cooldown until next movement
movement_delay	Delay between movements. This is on the controller so we can keep the movement datum singleton
movement_target_source	Identifier for what last touched our movement target, so it can be cleared conditionally
pathing_attempts	Tracks recent pathing attempts, if we fail too many in a row we fail our current plans.
paused_until	AI paused time
pawn	The atom this controller is controlling
planned_behaviors	Current actions planned to be performed by the AI in the upcoming plan
planning_subtrees	All subtrees this AI has available, will run them in order, so make sure they're in the order you want them to run. On initialization of this type, it will start as a typepath(s) and get converted to references of ai_subtrees found in SSai_controllers when init_subtrees() is called
Procs
PossessPawn	Proc to move from one pawn to another, this will destroy the target's existing controller.
ProcessBehavior	It's still in the plan, don't add it again to current_behaviors but do keep it in the planned behavior list so its not cancelled
SelectBehaviors	This is where you decide what actions are taken by the AI.
TryPossessPawn	Abstract proc for initializing the pawn to the new controller
UnpossessPawn	Proc for deinitializing the pawn to the old controller
able_to_plan	Are we close enough to engage? Determines whether the AI can currently make a new plan
able_to_run	Returns TRUE if the ai controller can actually run at the moment.
change_ai_movement_type	Overrides the current ai_movement of this controller with a new one
get_access	Use this proc to define how your controller defines what access the pawn has for the sake of pathfinding, likely pointing to whatever ID slot is relevant
get_human_examine_text	If this controller is applied to a human subtype, this proc will be called to generate examine text
get_minimum_distance	Returns the minimum required distance to preform one of our current behaviors. Honestly this should just be cached or something but fuck you
get_setup_mob_ai_status	Mobs have more complicated factors about whether their AI should be on or not
init_subtrees	Loops over the subtrees in planning_subtrees and looks at the ai_controllers to grab a reference, ENSURE planning_subtrees ARE TYPEPATHS AND NOT INSTANCES/REFERENCES BEFORE EXECUTING THIS
on_stat_changed	Turn the controller on or off based on if you're alive, we only register to this if the flag is present so don't need to check again
process	Runs any actions that are currently running
queue_behavior	Call this to add a behavior to the stack.
replace_planning_subtrees	Completely replaces the planning_subtrees with a new set based on argument provided, list provided must contain specifically typepaths
set_ai_status	This proc handles changing ai status, and starts/stops processing if required.
set_movement_target	Sets the current movement target, with an optional param to override the movement behavior

Var Details

var
ai_movement
– /datum/ai_movement

Reference to the movement datum we use. Is a type on initialize but becomes a ref afterwards.

var
ai_status
–

Current status of AI (OFF/ON)

var
ai_traits
–

Bitfield of traits for this AI to handle extra behavior

var
behavior_args
– /list

Stored arguments for behaviors given during their initial creation

var
behavior_cooldowns
– /list

Current actions and their respective last time ran as an assoc list.

var
blackboard
– /list

This is a list of variables the AI uses and can be mutated by actions. When an action is performed you pass this list and any relevant keys for the variables it can mutate.

var
continue_processing_when_client
–

Can the AI remain in control if there is a client?

var
current_behaviors
– /list

Current actions being performed by the AI.

var
current_movement_target
– /atom

Current movement target of the AI, generally set by decision making.

var
failed_planning_cooldown
–

Cooldown for new plans, to prevent AI from going nuts if it can't think of new plans and looping on end

var
idle_behavior
– /datum/idle_behavior

The idle behavior this AI performs when it has no actions.

var
max_target_distance
–

distance to give up on target

var
movement_cooldown
–

Cooldown until next movement

var
movement_delay
–

Delay between movements. This is on the controller so we can keep the movement datum singleton

var
movement_target_source
–

Identifier for what last touched our movement target, so it can be cleared conditionally

var
pathing_attempts
–

Tracks recent pathing attempts, if we fail too many in a row we fail our current plans.

var
paused_until
–

AI paused time

var
pawn
– /atom

The atom this controller is controlling

var
planned_behaviors
– /list

Current actions planned to be performed by the AI in the upcoming plan

var
planning_subtrees
– /list

All subtrees this AI has available, will run them in order, so make sure they're in the order you want them to run. On initialization of this type, it will start as a typepath(s) and get converted to references of ai_subtrees found in SSai_controllers when init_subtrees() is called

Proc Details

proc
PossessPawn
(/atom/new_pawn)

Proc to move from one pawn to another, this will destroy the target's existing controller.

proc
ProcessBehavior
(delta_time, /datum/ai_behavior/behavior)

It's still in the plan, don't add it again to current_behaviors but do keep it in the planned behavior list so its not cancelled

proc
SelectBehaviors
(delta_time)

This is where you decide what actions are taken by the AI.

proc
TryPossessPawn
(/atom/new_pawn)

Abstract proc for initializing the pawn to the new controller

proc
UnpossessPawn
(destroy)

Proc for deinitializing the pawn to the old controller

proc
able_to_plan
()

Are we close enough to engage? Determines whether the AI can currently make a new plan

proc
able_to_run
()

Returns TRUE if the ai controller can actually run at the moment.

proc
change_ai_movement_type
(/datum/ai_movement/new_movement)

Overrides the current ai_movement of this controller with a new one

proc
get_access
()

Use this proc to define how your controller defines what access the pawn has for the sake of pathfinding, likely pointing to whatever ID slot is relevant

proc
get_human_examine_text
()

If this controller is applied to a human subtype, this proc will be called to generate examine text

proc
get_minimum_distance
()

Returns the minimum required distance to preform one of our current behaviors. Honestly this should just be cached or something but fuck you

proc
get_setup_mob_ai_status
(/mob/mob_pawn)

Mobs have more complicated factors about whether their AI should be on or not

proc
init_subtrees
()

Loops over the subtrees in planning_subtrees and looks at the ai_controllers to grab a reference, ENSURE planning_subtrees ARE TYPEPATHS AND NOT INSTANCES/REFERENCES BEFORE EXECUTING THIS

proc
on_stat_changed
(/mob/living/source, new_stat)

Turn the controller on or off based on if you're alive, we only register to this if the flag is present so don't need to check again

↑
process
(delta_time)

Runs any actions that are currently running

proc
queue_behavior
(behavior_type, ...)

Call this to add a behavior to the stack.

proc
replace_planning_subtrees
(/list/typepaths_of_new_subtrees)

Completely replaces the planning_subtrees with a new set based on argument provided, list provided must contain specifically typepaths

proc
set_ai_status
(new_ai_status)

This proc handles changing ai status, and starts/stops processing if required.

proc
set_movement_target
(source, /atom/target, /datum/ai_movement/new_movement)

Sets the current movement target, with an optional param to override the movement behavior

ai_controller /datum/ai_controller

Vars

Procs

Var Details

var ai_movement – /datum/ai_movement

var ai_status –

var ai_traits –

var behavior_args – /list

var behavior_cooldowns – /list

var blackboard – /list

var continue_processing_when_client –

var current_behaviors – /list

var current_movement_target – /atom

var failed_planning_cooldown –

var idle_behavior – /datum/idle_behavior

var max_target_distance –

var movement_cooldown –

var movement_delay –

var movement_target_source –

var pathing_attempts –

var paused_until –

var pawn – /atom

var planned_behaviors – /list

var planning_subtrees – /list

Proc Details

proc PossessPawn(/atom/new_pawn)

proc ProcessBehavior(delta_time, /datum/ai_behavior/behavior)

proc SelectBehaviors(delta_time)

proc TryPossessPawn(/atom/new_pawn)

proc UnpossessPawn(destroy)

proc able_to_plan()

proc able_to_run()

proc change_ai_movement_type(/datum/ai_movement/new_movement)

proc get_access()

proc get_human_examine_text()

proc get_minimum_distance()

proc get_setup_mob_ai_status(/mob/mob_pawn)

proc init_subtrees()

proc on_stat_changed(/mob/living/source, new_stat)

↑process(delta_time)

proc queue_behavior(behavior_type, ...)

proc replace_planning_subtrees(/list/typepaths_of_new_subtrees)

proc set_ai_status(new_ai_status)

proc set_movement_target(source, /atom/target, /datum/ai_movement/new_movement)