Ambush Package
The ambush package tells an actor to wait to attack enemies until they come within a specified location (or attack the actor directly). The actor will have much higher detection against actors in the ambush location, but will have lower detection against anything outside the ambush location.
Contents
Package Specific Data
Ambush Location:
Ambush location is where an enemy has to be for the actor to aggro on it. Until the enemy reaches the ambush location, the actor will remain at the Wait Location.
This can be a Linked Ref (like the Patrol Package) -- if Linked Ref is selected but there is no linked ref, the package is invalid and is removed from the package list (again, same as Patrol).
Wait Location:
Location is where the actor stands while running the ambush package. If it has a radius, the actor will wander within that radius.
Ambush Target:
Optional. If specified, the actor will wait to aggro until an enemy matching the target enters the ambush location. Note that this will not force an actor to attack a friend/ally.
Package Flags:
- Hide while ambushing: (checked by default) If checked, the actor will seek cover within the Wait Location radius while waiting for a detected enemy to reach the Ambush Location.
Flags:
- Must reach location: Once ambush package is started, actor must reach the Wait Location before the package can be reevaluated.
- Must Complete: Invalid
- Continue During Combat: If this is checked, actor will attempt to remain within the Wait Location during combat (similar to a guard package). If this is not checked, the actor is free to behave normally during combat, without regard to the Wait Location. When combat ends, the actor will return to the Wait Location.
Behavior
The ambushing actor will move to the Wait Location when the package starts. If a detected enemy (someone the ambushing actor wants to aggro on) enters the Ambush Location, OR the actor detects someone aggroing on them, the actor will immediately go into combat.
NOTE: Since the player cannot "aggro" on the actor, if the actor is aggressive towards the player, they are allowed to aggro on the player when they detect the player within a (fAmbushOverRideRadiusforPlayerDetection = 1000) radius of their wait location.