createTrigger

From Bohemia Interactive Community
Jump to: navigation, search
Introduced with Armed Assault version 1.00
  Effects of this scripting command are broadcasted over the network and happen on every computer in the network

Click on the images for descriptions

Introduced in

Game:
Armed Assault
Version:
1.00

Description

Description:
Creates a sensor (trigger) of the given type and at the given position. The type must be a class name in CfgNonAIVehicles or CfgVehicles with simulation = detector. An array containing all units that have activated the trigger is available via list triggerobj. Created triggers can be deleted using deleteVehicle.

NOTE1: Since Arma 3 v1.43.129935 triggers can be created locally on clients using the alternative syntax.
NOTE2: Since Arma 3 v1.53.132440 triggers can be disabled/enabled using enableSimulation command.

Triggers are created with default params, which are:
  • a - 50.0
  • b - 50.0
  • angle - 0
  • rectangular - false
  • activationBy - None
  • activationType - Present
  • repeating - false
  • timeoutMin - 0
  • timeoutMid - 0
  • timeoutMax - 0
  • interruptable - true
  • type - None
  • text - ""
  • name - ""
  • expCond - "this"
  • expActiv - ""
  • expDesactiv - ""

Syntax

Syntax:
createTrigger [type, position, makeGlobal]
Parameters:
[type, position, makeGlobal]: Array
type: String
position: Position2D, Position3D or Object
makeGlobal (optional): Boolean - locality flag, true - trigger is global Effects of this scripting command are broadcasted over the network and happen on every computer in the network, false - trigger is local Effects of this scripting command are not broadcasted over the network and remain local to the client the command is executed on (available since Arma 3 v1.43.129935)
Return Value:
Object

Examples

Example 1:
_trg = createTrigger ["EmptyDetector", getPos player]; _trg setTriggerArea [5, 5, 0, false]; _trg setTriggerActivation ["CIV", "PRESENT", true]; _trg setTriggerStatements ["this", "hint 'Civilian near player'", "hint 'no civilian near'"];

Additional Information

Multiplayer:
Triggers are global and will be present on all machine(s) when this command is run.
See also:
setTriggerActivationsetTriggerAreasetTriggerStatementssetTriggerTextsetTriggerTimeoutsetTriggerTypesetEffectConditionsetSoundEffectsetMusicEffectsetTitleEffectdeleteVehiclesynchronizeWaypointsynchronizeTriggercreateGuardedPoint

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Posted on March 6, 2013 - 14:15 (CEST)
teaCup
Calling list immediately after creating a trigger this way (and setting up activation, area, statements, timeout, etc..), will return <null> instead of an array. It seems the trigger needs about 1 second to initialise, after which it will behave as expected: returning an array of all the objects inside the trigger (the ones matching the criteria), or an empty array.

Bottom Section