Ai script conditions

From Valve Developer Community

The title given to this article is incorrect due to technical limitations. The correct title is ai_script_conditions.

Table of contents
1 Entity Description
2 Keyvalues
3 Flags
4 Inputs
5 Outputs
[edit]

Entity Description

The keyvalues for this entity allow a mapper to define a list of conditions relating to the player, an NPC and a target (optional), to trigger events when these conditions are fulfilled.

For an example of its use, see d2_coast_03 (when Odessa gives Gordon the rocket launcher).

[edit]

Keyvalues

Defines the name that other entities refer to this entity by.
  • hammerid [Episode Two Update]
<integer readonly> This id is used for debugging purposes in Hammer.
  • StartDisabled
<boolean>
  • Actor
<target_destination> NPC Target
  • MinimumState
<choices>
Literal Value Description
1 Idle
2 Alert
3 Combat
  • MaximumState
<choices>
Literal Value Description
1 Idle
2 Alert
3 Combat
  • ScriptStatus
<boolean> Actor is running a script?
  • RequiredTime
<float> Duration of time that all the conditions must be true.
  • MinTimeout
<float> Minimum time before OnConditionsTimeout is fired. 0 = never expire.
  • MaxTimeout
<float> Maximum time before OnConditionsTimeout is fired. 0 = ignore.
  • ActorSeePlayer
<boolean>
  • PlayerActorProximity
<float> The distance the player must/must not be to the actor. Negative values for NOT, 0 for ignore.
  • PlayerActorFOV
<float> Specify angle of View Cone in degrees. Negative value = NOT.
  • PlayerActorFOVTrueCone
<choices> Player's View Cone is evaluated as a true cone, not pie slice.
  • PlayerActorLOS
<boolean> Checks that the player has clear Line of Sight to the Actor.
  • target
<target_destination> Optional entity to include in conditions.
  • ActorSeeTarget
<boolean>
  • ActorTargetProximity
<float> The distance the actor must/must not be to the Target. Negative values for NOT, 0 for ignore.
  • PlayerTargetProximity
<float> The distance the player must/must not be to the Target. Negative values for NOT, 0 for ignore.
  • PlayerTargetFOV
<float> Specify angle of View Cone in degrees. Negative value = NOT.
  • PlayerTargetFOVTrueCone
<boolean> Player's View Cone is evaluated as a true cone, not pie slice.
  • PlayerTargetLOS
<boolean> Checks that the player has clear Line of Sight to the Target.
  • PlayerBlockingActor
<boolean> Checks that the player is blocking the Actor's path.
  • ActorInPVS [Episode One Update]
<choices> Checks that the actor is in the player's PVS.
Literal Value Description
0 No
1 Yes
2 Don't care
[edit]

Flags

  • 1 : Fire outputs with the Actor as Activator [Episode One Update]
[edit]

Inputs

  • Kill
Removes this entity from the world.
Removes this entity and all its children from the world.
  • AddOutput <string>
Evaluates a keyvalue/output on this entity. It can be potentially very dangerous, use with care.
Format: <key> <value>
Format: <output name> <targetname>:<inputname>:<parameter>:<delay>:<max times to fire (-1 == infinite)>
Causes this entity's OnUser1-4 outputs to be fired. See User Inputs and Outputs.
  • Enable
Enable this entity.
  • Disable
Disable this entity.
[edit]

Outputs

Fired in response to FireUser1-4 inputs. See User Inputs and Outputs.
!activator = activator
  • OnConditionsSatisfied
Fires when AI conditions satisfied
  • OnConditionsTimeout
Fires when AI conditions timed out
  • NoValidActor [Episode One Update]
Fires if/when there are no matching actors in the map.
Retrieved from "http://developer.valvesoftware.com/wiki/Ai_script_conditions"