createTrigger: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "v1\.97\.[0-9]{6}" to "v1.98")
m (Text replacement - "v1\.43\.[0-9]{6}" to "v1.44")
Line 9: Line 9:
| 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 <nowiki>=</nowiki> detector. An array containing all units that have activated the trigger is available via [[list]] ''triggerobj''. Created triggers can be deleted using [[deleteVehicle]].<br><br>
| 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 <nowiki>=</nowiki> detector. An array containing all units that have activated the trigger is available via [[list]] ''triggerobj''. Created triggers can be deleted using [[deleteVehicle]].<br><br>


{{Feature | Informative | Since Arma 3 v1.43.129935 triggers can be created locally on clients setting optional param ''makeGlobal'' to [[false]]}}
{{Feature | Informative | Since Arma 3 v1.44 triggers can be created locally on clients setting optional param ''makeGlobal'' to [[false]]}}
{{Feature | Informative | Since Arma 3 v1.53.132440 triggers can be disabled/enabled using [[enableSimulation]] command}}<br>
{{Feature | Informative | Since Arma 3 v1.53.132440 triggers can be disabled/enabled using [[enableSimulation]] command}}<br>


Line 39: Line 39:
|p2= type: [[String]] - usually "EmptyDetector"
|p2= type: [[String]] - usually "EmptyDetector"
|p3= position: [[Position2D]], [[Position3D]] or [[Object]]
|p3= position: [[Position2D]], [[Position3D]] or [[Object]]
|p4= makeGlobal (Optional): [[Boolean]] - locality flag  ''(available since Arma 3 v1.43.129935)''
|p4= makeGlobal (Optional): [[Boolean]] - locality flag  ''(available since Arma 3 v1.44)''
* [[true]] (Default) - trigger is global {{Icon|globalEffect|32}}
* [[true]] (Default) - trigger is global {{Icon|globalEffect|32}}
* [[false]] - trigger is local {{Icon|localEffect|32}}
* [[false]] - trigger is local {{Icon|localEffect|32}}

Revision as of 10:21, 3 April 2021

Hover & click on the images for description

Description

Description:
Description needed
Groups:
Triggers

Syntax

Syntax:
Syntax needed
Parameters:
[type, position, makeGlobal]: Array
type: String - usually "EmptyDetector"
position: Position2D, Position3D or Object
makeGlobal (Optional): Boolean - locality flag (available since Arma 3 v1.44)
Return Value:
Return value needed

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'"];
Example 2:
Open/close Bar Gate automatically: //--- init of the Bar Gate if (isServer) then { _gateTrigger = createTrigger ["EmptyDetector", getPosWorld this, false]; _gateTrigger setVariable ["BarGateObj", this]; _gateTrigger setTriggerActivation ["ANYPLAYER", "PRESENT", true]; _gateTrigger setTriggerArea [5, 25, getDir this, true]; _gateTrigger setTriggerStatements [ "this", "thisTrigger getVariable ""BarGateObj""; animateSource [""Door_1_sound_source"", 1]", "thisTrigger getVariable ""BarGateObj""; animateSource [""Door_1_sound_source"", 0]" ]; };

Additional Information

See also:
setTriggerActivationsetTriggerAreasetTriggerStatementssetTriggerTextsetTriggerTimeoutsetTriggerTypesetEffectConditionsetSoundEffectsetMusicEffectsetTitleEffectdeleteVehiclesynchronizeWaypointsynchronizeTriggercreateGuardedPointtriggerIntervalsetTriggerIntervalenableSimulationsimulationEnabled

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
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.