Artificial Intelligence functions. More...

#include "g_local.h"

Include dependency graph for g_ai.h:

This graph shows which files directly or indirectly include this file:

Data Structures
class	AiAreaSearch
	AiAreaSearch class, used to get an area of the map around a certain position for the AI to check possible moving positions. More...
class	AiAreaSearch::LQueue
	A simple queue class. More...
struct	AiAreaSearch::LQueue::qnode_s

Functions
void	AI_Init (void)
void	AI_CheckRespawn (int team)
	If the cvar g_endlessaliens is set we will endlessly respawn aliens.
void	G_AddToWayPointList (Edict *ent)
void	AI_Run (void)
	Every server frame one single actor is handled - always in the same order.
void	AI_ActorRun (Player &player, Actor *actor)
Player *	AI_CreatePlayer (int team)
	Spawn civilians and aliens.
bool	AI_CheckUsingDoor (const Edict ent, const Edict door)
	Checks whether the AI controlled actor wants to use a door.
bool	AI_HasLineOfFire (const Actor actor, const Edict target)
	Check if `actor` has a line of fire to the `target` given.
void	AI_TurnIntoDirection (Actor *actor, const pos3_t pos)
	This function will turn the AI actor into the direction that is needed to walk to the given location.
bool	AI_FindHidingLocation (int team, Actor *actor, const pos3_t from, int tuLeft)
	Tries to search a hiding spot.
bool	AI_FindHerdLocation (Actor *actor, const pos3_t from, const vec3_t target, int tu, bool inverse)
	Tries to search a spot where actor will be more closer to the target and behind the target from enemy (ie hide behind target).
int	AI_GetHidingTeam (const Edict *ent)
	Returns the value for the vis check whenever an ai actor tries to hide. For aliens this is the inverse team - see the vis check code for the inverse team rules to see how this works. For civilians we have to specify the alien team and can't use the inverse team rules. This is needed because the inverse team rules aren't working for the civilian team - see `TEAM_CIVILIAN`.
const Item *	AI_GetItemForShootType (shoot_types_t shootType, const Edict *ent)
bool	AI_FighterCheckShoot (const Actor actor, const Edict check, const fireDef_t *fd, float dist)
	Check whether the fighter should perform the shoot.
bool	AI_CheckLineOfFire (const Actor shooter, const Edict target, const fireDef_t *fd, int shots)
float	AI_CalcShotDamage (Actor actor, const Actor target, const fireDef_t *fd, shoot_types_t shotType)
	Calculate estimated damage per single shoot.
bool	AI_TryToReloadWeapon (Actor *actor, containerIndex_t containerID)
	if a weapon can be reloaded we attempt to do so if TUs permit, otherwise drop it
bool	AI_IsHostile (const Actor actor, const Edict target)
	Check if `actor` perceives `target` as hostile.
const invDef_t *	AI_SearchGrenade (const Actor actor, Item *ip)
	Search the edict's inventory for a grenade or other one-use weapon.
bool	AI_FindMissionLocation (Actor *actor, const pos3_t to, int tus, int radius=0)
	Try to go close to a mission edict.
bool	AI_CheckPosition (const Actor *const ent, const pos3_t pos)
	Checks if the given position is safe to stand on.
bool	AI_HideNeeded (const Actor *actor)
	Checks whether the given alien should try to hide because there are enemies close enough to shoot the alien.
bool	AIL_TeamThink (Player &player)
	The team think function for the ai controlled players.
void	AIL_ActorThink (Player &player, Actor *actor)
	The think function for the ai controlled players.
int	AIL_InitActor (Actor *actor)
	Initializes the lua AI for an actor.
void	AIL_Cleanup (void)
	Closes the LUA AI.
void	AIL_Init (void)
void	AIL_Shutdown (void)

Variables
Edict *	ai_waypointList

Detailed Description

Artificial Intelligence functions.

Definition in file g_ai.h.

Function Documentation

◆ AI_ActorRun()

void AI_ActorRun	(	Player &	player,
		Actor *	actor )

Definition at line 1655 of file g_ai.cpp.

References AI_ActorThink(), AIL_ActorThink(), and g_ailua.

Referenced by AI_PlayerRun(), G_MoralePanic(), and G_MoraleRage().

◆ AI_CalcShotDamage()

float AI_CalcShotDamage	(	Actor *	actor,
		const Actor *	target,
		const fireDef_t *	fd,
		shoot_types_t	shotType )

Calculate estimated damage per single shoot.

Definition at line 811 of file g_ai.cpp.

References CALC_DAMAGE_SAMPLES, shot_mock_t::civilian, shot_mock_t::damage, shot_mock_t::enemyCount, fireDef_t::fdIdx, shot_mock_t::friendCount, G_ClientShoot(), G_IsAlien, Edict::getPlayer(), fireDef_t::gravity, GROUND_DELTA, i, Actor::isInsane(), Actor::isStunned(), Edict::pos, fireDef_t::shots, and fireDef_t::splrad.

Referenced by AI_FindBestFiredef(), and AIL_GetBestShot().

◆ AI_CheckLineOfFire()

bool AI_CheckLineOfFire	(	const Actor *	shooter,
		const Edict *	target,
		const fireDef_t *	fd,
		int	shots )

Definition at line 763 of file g_ai.cpp.

References fireDef_t::bounce, fireDef_t::damage, trace_t::entNum, trace_t::fraction, G_EdictsGetByNum(), G_IsBreakable, G_IsBrushModel, G_Trace(), fireDef_t::getShotOrigin(), gi, GRAVITY, fireDef_t::gravity, GROUND_DELTA, Edict::HP, i, Actor::isCrouched(), fireDef_t::launched, LOF_CHECK_PARTITIONS, MASK_SHOT, Edict::origin, Edict::pos, fireDef_t::range, fireDef_t::rolled, fireDef_t::shots, fireDef_t::splrad, v, VectorAdd, VectorCompare, VectorCopy, VectorScale, and VectorSubtract.

Referenced by actorL_throwgrenade(), AI_FindBestFiredef(), AI_HasLineOfFire(), and AIL_GetBestShot().

◆ AI_CheckPosition()

bool AI_CheckPosition	(	const Actor *const	actor,
		const pos3_t	pos )

Checks if the given position is safe to stand on.

Returns: true if the actor's position is deemed safe.

Definition at line 581 of file g_ai.cpp.

References Edict::dmg, Edict::dmgtype, G_ApplyProtection(), G_EdictsGetNextInUse(), Actor::isInsane(), and Edict::isSamePosAs().

Referenced by AI_CivilianCalcActionScore(), AI_FighterCalcActionScore(), AI_FindHerdLocation(), AI_FindHidingLocation(), AI_FindMissionLocation(), AI_PanicCalcActionScore(), AIL_findweapons(), AIL_positionapproach(), AIL_positionflee(), AIL_positionshoot(), and AIL_positionwander().

◆ AI_CheckRespawn()

void AI_CheckRespawn ( int team )

If the cvar g_endlessaliens is set we will endlessly respawn aliens.

Note: This can be used for rescue or collect missions where it is enough to do something, and then leave the map (rescue zone)

Definition at line 1908 of file g_ai.cpp.

References G_AppearPerishEvent(), g_endlessaliens, G_EventActorAdd(), G_GetEquipmentForAISpawn(), G_GetPlayerForTeam(), G_SpawnAIPlayer(), G_VisToPM(), level, PM_ALL, TEAM_ALIEN, and Edict::visflags.

Referenced by G_ClientEndRound().

◆ AI_CheckUsingDoor()

bool AI_CheckUsingDoor	(	const Edict *	ent,
		const Edict *	door )

Checks whether the AI controlled actor wants to use a door.

Parameters

[in]	ent	The AI controlled actor
[in]	door	The door edict

Returns: true if the AI wants to use (open/close) that door, false otherwise

Note: Don't start any new events in here, don't change the actor state

See also: Touch_DoorTrigger

Todo: Finish implementation

Definition at line 396 of file g_ai.cpp.

References ACTOR_VIS_0, Edict::doorState, frand(), G_ActorVis(), G_EdictsGetNextLivingActor(), G_FrustumVis(), G_VisCheckDist(), Edict::getTeam(), gi, Edict::hiding, Edict::isSameTeamAs(), Edict::origin, STATE_OPENED, TEAM_ALIEN, TEAM_CIVILIAN, Edict::type, and VectorDist.

Referenced by Touch_DoorTrigger().

◆ AI_CreatePlayer()

Player * AI_CreatePlayer ( int team )

Spawn civilians and aliens.

Parameters

[in] team

See also: G_SpawnAIPlayer

Returns: Player pointer

Note: see cvars ai_singleplayeraliens, ai_numcivilians, ai_multiplayeraliens

Definition at line 1944 of file g_ai.cpp.

References ai_multiplayeraliens, ai_numcivilians, ai_singleplayeraliens, G_IsSinglePlayer, G_PlayerGetNextAI(), G_SetTeamForPlayer(), G_SpawnAIPlayers(), game, gi, level, sv_ai, and TEAM_CIVILIAN.

Referenced by G_SpawnEntities(), and SVCmd_AI_Add_f().

◆ AI_FighterCheckShoot()

bool AI_FighterCheckShoot	(	const Actor *	actor,
		const Edict *	check,
		const fireDef_t *	fd,
		float	dist )

Check whether the fighter should perform the shoot.

Todo

Check whether radius and power of fd are to to big for dist

Check whether the alien will die when shooting

Definition at line 364 of file g_ai.cpp.

References AI_CheckFF(), G_CalcEffectiveSpread(), Actor::isInsane(), Edict::origin, fireDef_t::range, and fireDef_t::splrad.

Referenced by actorL_throwgrenade(), AI_FindBestFiredef(), AI_SearchDestroyableObject(), and AIL_GetBestShot().

◆ AI_FindHerdLocation()

bool AI_FindHerdLocation	(	Actor *	actor,
		const pos3_t	from,
		const vec3_t	target,
		int	tu,
		bool	inverse )

Tries to search a spot where actor will be more closer to the target and behind the target from enemy (ie hide behind target).

Parameters

[in]	actor	The actor edict.
[in]	from	The grid position the actor is (theoretically) standing at and searching the nearest location from
[in]	target	Tries to find the nearest position to this location
[in]	tu	The available TUs of the actor
[in]	inverse	Try to shield the target instead of using target as shield

Definition at line 659 of file g_ai.cpp.

References AI_CheckPosition(), AI_GetHidingTeam(), Edict::calcOrigin(), DotProduct, G_ActorMoveLength(), G_EdictsGetNextLivingActor(), G_MoveCalcLocal(), G_TagMalloc, AiAreaSearch::getNext(), Edict::getTeam(), HERD_DIST, HERD_THRESHOLD, herdPathingTable, length, Edict::origin, PATHFINDING_HEIGHT, Edict::pos, ROUTING_NOT_REACHABLE, TAG_LEVEL, TU_MOVE_STRAIGHT, VectorCopy, VectorDistSqr, VectorNormalizeFast(), and VectorSubtract.

Referenced by AIL_positionherd().

◆ AI_FindHidingLocation()

bool AI_FindHidingLocation	(	int	team,
		Actor *	actor,
		const pos3_t	from,
		int	tuLeft )

Tries to search a hiding spot.

Parameters

[out]	actor	The actor edict. The position of the actor is updated here to perform visibility checks
[in]	from	The grid position the actor is (theoretically) standing at and searching a hiding location from
[in,out]	tuLeft	The amount of left TUs to find a hiding spot. The TUs needed to walk to the grid position is subtracted. May not be `nullptr`.
[in]	team	The team from which actor tries to hide

Returns: true if hiding is possible, false otherwise

Definition at line 606 of file g_ai.cpp.

References AI_ACTION_NOTHING_FOUND, AI_CheckPosition(), AI_IsExposed(), Edict::calcOrigin(), G_ActorMoveLength(), G_MoveCalcLocal(), G_TagMalloc, AiAreaSearch::getNext(), HIDE_DIST, hidePathingTable, PATHFINDING_HEIGHT, Edict::pos, ROUTING_NOT_REACHABLE, TAG_LEVEL, TU_MOVE_STRAIGHT, and VectorCopy.

Referenced by AI_FighterCalcActionScore(), and AIL_positionhide().

◆ AI_FindMissionLocation()

bool AI_FindMissionLocation	(	Actor *	actor,
		const pos3_t	to,
		int	tus,
		int	radius )

Try to go close to a mission edict.

Parameters

[in,out]	actor	The actor edict.
[in]	to	The target position.
[in]	tus	Available Time Units
[in]	radius	Radius of the area to search

Returns: true if found a suitable position, false otherwise

Definition at line 1423 of file g_ai.cpp.

References AI_CheckPosition(), G_ActorMoveLength(), AiAreaSearch::getNext(), length, level, Edict::pos, ROUTING_NOT_REACHABLE, VectorCompare, and VectorCopy.

Referenced by AIL_positionmission().

◆ AI_GetHidingTeam()

int AI_GetHidingTeam ( const Edict * ent )

Returns the value for the vis check whenever an ai actor tries to hide. For aliens this is the inverse team - see the vis check code for the inverse team rules to see how this works. For civilians we have to specify the alien team and can't use the inverse team rules. This is needed because the inverse team rules aren't working for the civilian team - see TEAM_CIVILIAN.

Returns: A negative team number means "every other team" as the one from the given ent. See the vis check functions for the inverse team rules for more information.

Definition at line 570 of file g_ai.cpp.

References G_IsCivilian, Edict::getTeam(), and TEAM_ALIEN.

Referenced by AI_FighterCalcActionScore(), AI_FindHerdLocation(), AI_HideNeeded(), AIL_positionapproach(), AIL_positionflee(), and AIL_positionhide().