View source for HPL3/Amnesia: Rebirth/Scripting/Agents/Ghouls

{{wip}}


{{ConstructionNotice| Basic overview of agent}}

= Basic Overview =

== Modes vs Commands ==

Each mode contains a subset of behaviors. They define what the 'default' action for the agent should be and can be used to give different agents of the same type unique behaviors.

A command is an order issued to the agent independent of the current mode. They can be used to override the agents current action.

Unlike previous HPL titles, agents should only be controlled through modes and commands,  NOT through changing the agent state.

== General Functions ==

{{CodeDocDetailTop|Ghoul_Mode_Set}}
<syntaxhighlight lang="c++">void Ghoul_Mode_Set(const tString &in asAgentName, eGhoulMode aMode, bool abForce = false)</syntaxhighlight>
{{CodeDocDetailBody|Puts the ghoul into a mode, which determines its behavior when it's not reacting to the player's presence.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|aMode|[[../../tString|tString]]|Which mode to put the ghoul in.}}
{{CodeDocDetailParam|abForce|bool|If true the ghoul will switch the behavior instantly regardless of state, otherwise it will do so more naturally on the next best opportunity.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

= Modes =

== eGhoulMode_Idle ==

This is the ghouls default mode. In this mode the ghoul will remain stationary when not reacting to the player.

TODO - Verify there are no idle specific functions.

== eGhoulMode_Patrol ==

A ghoul in patrol mode will move to specified patrol path nodes when not reacting to the player.

{{CodeDocDetailTop|Ghoul_ModePatrol_Setup}}
<syntaxhighlight lang="c++">void Ghoul_ModePatrol_Setup(const tString &in asAgentName, bool abRandom = false, eGhoulSpeed aSpeed = eGhoulSpeed_Walk)</syntaxhighlight>
{{CodeDocDetailBody|Sets up the basic parameters for the ghoul's patrol mode.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|abRandom|bool|If nodes should be picked randomly, otherwise they will be picked in the order added.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_ModePatrol_AddNode}}
<syntaxhighlight lang="c++">void Ghoul_ModePatrol_AddNode(const tString &in asAgentName, const tString&in asNodeName, float afMinWaitTime = 0, float afMaxWaitTime= - 1,
								const tString &in asAnimName = "", bool abLoopAnim = false)</syntaxhighlight>
{{CodeDocDetailBody|Adds a node to the list of nodes to patrol in patrol mode.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asNodeName|[[../../tString|tString]]|Name of the node.}}
{{CodeDocDetailParam|afMinWaitTime|float|The minimum amount of time how long the ghoul should wait at this node.}}
{{CodeDocDetailParam|afMaxWaitTime|float|The maximum amount of time how long the ghoul should wait at this node.}}
{{CodeDocDetailParam|asAnimName|[[../../tString|tString]]|Name of the animation that should play when the ghoul reaches this node.}}
{{CodeDocDetailParam|abLoopAnim|bool|If the animation should loop.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_ModePatrol_ClearNodes}}
<syntaxhighlight lang="c++">void Ghoul_ModePatrol_ClearNodes(const tString &in asAgentName)</syntaxhighlight>
{{CodeDocDetailBody|Removes all the nodes from the patrol mode list.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_ModePatrol_SetSpeed}}
<syntaxhighlight lang="c++">void Ghoul_ModePatrol_SetSpeed(const tString &in asAgentName, eGhoulSpeed aSpeed = eGhoulSpeed_Walk)</syntaxhighlight>
{{CodeDocDetailBody|Sets the speed of movement for the current patrol mode.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|eGhoulSpeed|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== eGhoulMode_RandomWanderArea ==

A ghoul in the random wander area will move to random nodes within a specified area when not reacting to the player.

{{CodeDocDetailTop|Ghoul_ModeRandomWanderArea_Setup}}
<syntaxhighlight lang="c++">void Ghoul_ModeRandomWanderArea_Setup(const tString &in asAgentName, const cVector3f &in avAreaCenter, float afMinRadius, float afMaxRadius)</syntaxhighlight>
{{CodeDocDetailBody|Makes the ghoul randomly wander inside a specified area.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|avAreaCenter|[[../../cVector3f|cVector3f]]|The center of the area.}}
{{CodeDocDetailParam|afMinRadius|float|The closest distance the nodes can be picked from.}}
{{CodeDocDetailParam|afMaxRadius|float|The furthest distance the nodes can be picked from.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== eGhoulMode_Guard ==

TODO - Guard mode overview
TODO - Guard vs Enthralled

{{CodeDocDetailTop|Ghoul_ModeGuard_Setup}}
<syntaxhighlight lang="c++">void Ghoul_ModeGuard_Setup(const tString &in asAgentName, const tString &in asLookAtEntity, const tString &in asStandPosEntity, const tString &in asIdleAnim,
						   const tString &in asIdleSound, const tString &in asDisturbAnim, eGhoulSpeed aSpeedState = eGhoulSpeed_FastWalk)</syntaxhighlight>
{{CodeDocDetailBody|Makes the ghoul enter the Guard state.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asLookAtEntity|[[../../tString|tString]]|Name of the entity to be turned toward.}}
{{CodeDocDetailParam|asStandPosEntity|[[../../tString|tString]]|Name of the entity to stand at.}}
{{CodeDocDetailParam|asIdleAnim|[[../../tString|tString]]|Name of the idle animation.}}
{{CodeDocDetailParam|asIdleSound|[[../../tString|tString]]|Name of the sound entity placed in the map that will be played when guarding.}}
{{CodeDocDetailParam|asDisturbAnim|[[../../tString|tString]]|Name of the disturbed animation.}}
{{CodeDocDetailParam|aSpeedState|eGhoulSpeed|Speed state of the ghoul when moving to the stand pos.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== eGhoulMode_Enthralled ==

A ghoul in enthralled mode will move to a specified location when not reacting to the player.

{{CodeDocDetailTop|Ghoul_ModeEnthralled_Setup}}
<syntaxhighlight lang="c++">void Ghoul_ModeEnthralled_Setup(const tString &in asAgentName, const tString &in asLookAtEntity, const tString &in asStandPosEntity, const tString &in asIdleAnim)</syntaxhighlight>
{{CodeDocDetailBody|Puts the ghoul in the enthralled state.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asLookAtEntity|[[../../tString|tString]]|Name of the entity to be turned toward.}}
{{CodeDocDetailParam|asStandPosEntity|[[../../tString|tString]]|Name of the entity to stand at.}}
{{CodeDocDetailParam|asIdleAnim|[[../../tString|tString]]|Name of the idle animation.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== eGhoulMode_Hunt ==

A ghoul in hunt mode will be always hunting the player.

TODO - Verify no hunt specific funcs

== eGhoulMode_StalkThroughHoles ==

Mode behavior and functionality currently unknown.

{{CodeDocDetailTop|Ghoul_ModeStalkThroughHoles_Setup}}
<syntaxhighlight lang="c++">void Ghoul_ModeStalkThroughHoles_Setup(const tString &in asAgentName, const tString &in asHoleNetwork, const tString &in asPlayerPath = "", const tString &in asHoleConnections = "", bool abHideUntilDisturbed = false)</syntaxhighlight>
{{CodeDocDetailBody|Sets up the basic parameters for the StalkThroughHoles mode.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asHoleNetwork|[[../../tString|tString]]|The name of the group of ghoul holes the ghoul should move between, use wildcard *.}}
{{CodeDocDetailParam|asPlayerPath|[[../../tString|tString]]|The name of the group of nodes that represent the general path the player will take, used to determine if a hole is ahead or behind the player, use wildcard *.}}
{{CodeDocDetailParam|asHoleConnections|[[../../tString|tString]]|The name of a group of areas that represent the connections between holes, the ghoul will move along these areas and make noise, use wildcard *.}}
{{CodeDocDetailParam|abHideUntilDisturbed|bool|If the ghoul shouldn't emerge unless the player makes noise.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== eGhoulMode_Trapped ==

TODO - Verify that this mode does nothing.

= Command Functions =

== General ==

{{CodeDocDetailTop|Ghoul_Command_Remove}}
<syntaxhighlight lang="c++">void Ghoul_Command_Remove(const tString &in asAgentName, bool abForce = true)</syntaxhighlight>
{{CodeDocDetailBody|Removes the current command that is set for the ghoul to execute.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|abForce|bool|If the ghoul should abandond the command immediately, or wait to finish what it's doing.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandRetreat_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandRetreat_Execute(const tString &in asAgentName, bool abForce = false, bool abAutomaticRetreat = true, const cVector3f &in avPos = cVector3f_Zero, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the retreat command.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|abAutomaticRetreat|bool|If the ghoul should pick an appropriate node to retreat to, otherwise a position needs to be provided with the <code>avPos</code> argument.}}
{{CodeDocDetailParam|avPos|[[../../cVector3f|cVector3f]]|The position the ghoul should retreat to, will only be considered when <code>abAutomaticRetreat</code> is true.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandUseDoor_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandUseDoor_Execute(const tString &in asAgentName, const tString &in asDoorName, bool abBreak = false, bool abForce = false, eGhoulSpeed aSpeed = eGhoulSpeed_Walk, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the command that makes the ghoul move to and interact with a door.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asDoorName|[[../../tString|tString]]|The name of the door the ghoul should interact with.}}
{{CodeDocDetailParam|abBreak|bool|If the ghoul should break the door, otherwise it will attempt to open it.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== Patrol Commands ==

{{CodeDocDetailTop|Ghoul_CommandPatrol_AddNode}}
<syntaxhighlight lang="c++">void Ghoul_CommandPatrol_AddNode(const tString &in asAgentName, const tString&in asNodeName, float afMinWaitTime = 0, float afMaxWaitTime= - 1,
								const tString &in asAnimName = "", bool abLoopAnim = false)</syntaxhighlight>
{{CodeDocDetailBody|Adds a node to the list of patrol nodes for a patrol command.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asNodeName|[[../../tString|tString]]|Name of the node.}}
{{CodeDocDetailParam|afMinWaitTime|float|The minimum amount of time how long the ghoul should wait at this node.}}
{{CodeDocDetailParam|afMaxWaitTime|float|The maximum amount of time how long the ghoul should wait at this node.}}
{{CodeDocDetailParam|asAnimName|[[../../tString|tString]]|Name of the animation that should play when the ghoul reaches this node.}}
{{CodeDocDetailParam|abLoopAnim|bool|If the animation should loop.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandPatrol_ClearNodes}}
<syntaxhighlight lang="c++">void Ghoul_CommandPatrol_ClearNodes(const tString &in asAgentName)</syntaxhighlight>
{{CodeDocDetailBody|Removes all the nodes from the patrol command list.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandPatrol_SetSpeed}}
<syntaxhighlight lang="c++">void Ghoul_CommandPatrol_SetSpeed(const tString &in asAgentName, eGhoulSpeed aSpeed = eGhoulSpeed_Walk)</syntaxhighlight>
{{CodeDocDetailBody|Sets the speed of movement for the current patrol command.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandPatrol_SetSpeed}}
<syntaxhighlight lang="c++">void Ghoul_CommandPatrol_SetSpeed(const tString &in asAgentName, eGhoulSpeed aSpeed = eGhoulSpeed_Walk)</syntaxhighlight>
{{CodeDocDetailBody|Sets the speed of movement for the current patrol command.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandPatrol_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandPatrol_Execute(const tString &in asAgentName, bool abForce = false, int alLoopCount = 1, bool abRandom = false, eGhoulSpeed aSpeed = eGhoulSpeed_Walk, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the patrol command.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|alLoopCount|int|How many times the ghoul should patrol the node set, only positive values are allowed, use the patrol mode for infinite loops.}}
{{CodeDocDetailParam|abRandom|bool|If nodes should be picked randomly, otherwise they will be picked in the order added.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandSmellPatrol_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandSmellPatrol_Execute(const tString &in asAgentName, bool abForce = false, int alLoopCount = 1, bool abRandom = false, eGhoulSpeed aSpeed = eGhoulSpeed_Walk, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the smell patrol command, where the ghoul will patrol while sniffing. If the ghoul actually catches the player's scent and begins tracking them down, the smell patrol becomes a normal patrol.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|alLoopCount|int|How many times the ghoul should patrol the node set, only positive values are allowed, use the patrol mode for infinite loops.}}
{{CodeDocDetailParam|abRandom|bool|If nodes should be picked randomly, otherwise they will be picked in the order added.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

== Ghoul Hole Commands ==

{{CodeDocDetailTop|Ghoul_CommandGoToSpecificHole_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandGoToSpecificHole_Execute(const tString &in asAgentName, const tString &in asHole, bool abForce = false, bool abInstant = false, bool abDeactivateAfter = false, eGhoulSpeed aSpeed = eGhoulSpeed_Walk, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the command that makes the ghoul move to and enter a specified ghoul hole.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asHole|[[../../tString|tString]]|The name of the hole the ghoul should retreat to.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|abInstant|bool|If the ghoul should start hiding in a hole instantly, being teleported then and hidden.}}
{{CodeDocDetailParam|abDeactivateAfter|bool|?}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandGoToHole_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandGoToHole_Execute(const tString &in asAgentName, const cVector3f &in avPos, bool abForce = false, bool abInstant = false, bool abDeactivateAfter = false,
									bool abClosest = true, eGhoulSpeed aSpeed = eGhoulSpeed_Walk, float afMinRadius = -1.0f, float afMaxRadius = -1.0f, bool abOnlyFree = false,
									bool abOnlyOutOfPlayerSight = false, const tString &in asCompletedCallback = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the command that makes the ghoul move to and enter a hole based on certain parameters.}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|avPos|[[../../cVector3f|cVector3f]]|The position to which distances will be calculated.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|abInstant|bool|If the ghoul should start hiding in a hole instantly, being teleported then and hidden.}}
{{CodeDocDetailParam|abDeactivateAfter|bool|?}}
{{CodeDocDetailParam|abClosest|bool|If the closest node to <code>avPos</code> should be picked, otherwise a random node that fits the other parameters will be chosen.}}
{{CodeDocDetailParam|aSpeed|eGhoulSpeed|The speed with which the ghoul will move.}}
{{CodeDocDetailParam|afMinRadius|float|The minimum distance from avPos that a ghoul hole can be at.}}
{{CodeDocDetailParam|afMaxRadius|float|The maximum distance from avPos that a ghoul hole can be at.}}
{{CodeDocDetailParam|abOnlyFree|bool|If only free holes (that aren't occupied by other ghouls) should be chosen.}}
{{CodeDocDetailParam|abOnlyOutOfPlayerSight|bool|If only holes that are out of the player's sight should be chosen.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

{{CodeDocDetailTop|Ghoul_CommandEmergeFromHole_Execute}}
<syntaxhighlight lang="c++">void Ghoul_CommandEmergeFromHole_Execute(const tString &in asAgentName, const tString &in asHole, bool abForce = false, const tString &in asCompletedCallback = "", const tString &in asCustomAnim = "", const tString &in asCustomAnimEntity = "")</syntaxhighlight>
{{CodeDocDetailBody|Executes the command that makes the ghoul emerge from a hole. If the ghoul is not hiding, it will be teleported to the hole and play the emerge animation..}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asAgentName|[[../../tString|tString]]|Name of the agent.}}
{{CodeDocDetailParam|asHole|[[../../tString|tString]]|The name of the hole the ghoul should retreat to.}}
{{CodeDocDetailParam|abForce|bool|If the command should be executed immediately, or at a more appropriate time.}}
{{CodeDocDetailParam|asCompletedCallback|[[../../tString|tString]]|The function that will be called after the command is completed, syntax: <code>void Func(const tString &in asEntity)</code>.}}
{{CodeDocDetailParam|asCustomAnim|[[../../tString|tString]]|Name of the custom animation.}}
{{CodeDocDetailParam|asCustomAnimEntity|[[../../tString|tString]]|Entity to play the custom anim at.}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}

= unsorted funcs =
{{ConstructionNotice| Temporary}}

<nowiki>/**
 * Puts a ghoul in the EatMeat state and destroys the specified meat.
 * 
 * @param asAgentName, name of the agent
 * @param asMeatEntity, name of the meat to be destroyed
 **/
void Ghoul_EatMeat(const tString &in asAgentName, const tString &in asMeatEntity)</nowiki>

PLACEHOLDER
{{CodeDocSummaryTop}}
{{CodeDocSummaryItem|void|[[#Button_Blink|Button_Blink]](const [[../../tString|tString]] &in asName)|Makes the button blink in accordance to how it is set up in the ent file}}
{{CodeDocSummaryBottom}}

PLACEHOLDER
{{CodeDocDetailTop|Billboard_SetBrightness}}
<syntaxhighlight lang="c++">void Billboard_SetBrightness(const tString &in asBillboardName,
                             float afBrightness)</syntaxhighlight>
{{CodeDocDetailBody|Sets the brightness of a billboard}}
{{CodeDocDetailParamStart}}
{{CodeDocDetailParam|asBillboardName|[[../../tString|tString]]|name of billboard. Can contain wildcards.}}
{{CodeDocDetailParam|afBrightness|float|new brightness}}
{{CodeDocDetailReturn|void|}}
{{CodeDocDetailBottom}}