allMissionObjects: Difference between revisions

Latest revision as of 08:52, 24 September 2024

1.57

1.00

0.50

Hover & click on the images for description

Description

Description:

Returns all objects of the given type that are currently present in the mission. In some cases, the entities and allObjects commands are much faster alternatives to this command.
Some of the special types that can be detected with this command (and with nearestObject):

"" - returns everything, e.g. agents, bees, mosquitoes, footprints, armed mines, ...
"all" - more restrictive than "": no ambient insects, only agents such as rabbits and snakes, no footprints, tracks, no armed mines
"#slop" - blood drops
"#mark" - unit footprints
"#track" - vehicle tracks
"#crater" - explosion craters on the ground
"#crateronvehicle" - bullet marks on vehicles
"#explosion" - explosions
"#objectdestructed" - building, tree or bush destruction
"#soundonvehicle" - sounds created with say3D for example
"#dynamicsound" - sound sources created using createSoundSource
"EmptyDetector" - all Triggers
"Logic" - all game logics

⚠

This command is quite performance heavy. Use with caution!

Multiplayer:

This command is ~5 times faster on a dedicated server than on a client. Reason unknown.

Groups:

Object Detection

Syntax

Syntax:: allMissionObjects type
Parameters:: type: String
Return Value:: Array of Objects

Examples

Example 1:: _airObjects = allMissionObjects "Air";
Example 2:: { deleteVehicle _x; } forEach (allMissionObjects "");
Example 3:: _allMObjects = allMissionObjects "All";

Additional Information

See also:: allObjects allDead allGroups allUnits entities vehicles allMines allSimpleObjects

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

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma2oa |= Game name
+|game1= arma2oa
+|version1= 1.57
-|1.57|= Game version
+|game2= tkoh
-____________________________________________________________________________________________
+|version2= 1.00
-| Returns all mission objects with given type (or its subtype). |= Description
+|game3= arma3
-____________________________________________________________________________________________
+|version3= 0.50
-| '''allMissionObjects''' type |= Syntax
+|gr1= Object Detection
-|p1 = type: [[String]] |= Parameter 1
+|descr= Returns all objects of the given type that are currently present in the mission. In some cases, the [[entities]] and [[allObjects]] commands are much faster alternatives to this command.<br>
+Some of the special types that can be detected with this command (and with [[nearestObject]]):
+* {{hl|""}} - returns everything, e.g. agents, bees, mosquitoes, footprints, armed mines, ...
+* {{hl|"all"}} - more restrictive than {{hl|""}}: no ambient insects, only agents such as rabbits and snakes, no footprints, tracks, no armed mines
+* {{hl|"#slop"}} - blood drops
+* {{hl|"#mark"}} - unit footprints
+* {{hl|"#track"}} - vehicle tracks
+* {{hl|"#crater"}} - explosion craters on the ground
+* {{hl|"#crateronvehicle"}} - bullet marks on vehicles
+* {{hl|"#explosion"}} - explosions
+* {{hl|"#objectdestructed"}} - building, tree or bush destruction
+* {{hl|"#soundonvehicle"}} - sounds created with [[say3D]] for example
+* {{hl|"#dynamicsound"}} - sound sources created using [[createSoundSource]]
+* {{hl|"EmptyDetector"}} - all [[Trigger]]s
+* {{hl|"Logic"}} - all game logics
+{{Feature|important|This command is quite performance heavy. Use with caution!}}
-| [[Array]] of [[Object|Objects]]|= RETURNVALUE
+|mp= {{Feature|arma3|This command is ~5 times faster on a dedicated server than on a client. Reason unknown.}}
+|s1= [[allMissionObjects]] type
-|x1= <code>_airObjects <nowiki>=</nowiki> allMissionObjects "Air";</code>|= EXAMPLE1
+|p1= type: [[String]]
-|x2= <code>{ deleteVehicle _x } forEach (allMissionObjects "");</code>|= EXAMPLE2
+|r1= [[Array]] of [[Object]]s
-|x3= <code>_allMObjects <nowiki>=</nowiki> allMissionObjects "All";</code>|= EXAMPLE3
+|x1= <sqf>_airObjects = allMissionObjects "Air";</sqf>
-____________________________________________________________________________________________
+|x2= <sqf>{ deleteVehicle _x; } forEach (allMissionObjects "");</sqf>
-|  [[allDead]], [[allGroups]], [[allUnits]], [[vehicles]] |= SEEALSO
+|x3= <sqf>_allMObjects = allMissionObjects "All";</sqf>
-|  |= MPBEHAVIOUR
+|seealso= [[allObjects]] [[allDead]] [[allGroups]] [[allUnits]] [[entities]] [[vehicles]] [[allMines]] [[allSimpleObjects]]
-____________________________________________________________________________________________
 }}
-<h3 style='display:none'>Notes</h3>
-<dl class='command_description'>
-<!-- Note Section BEGIN -->
-'''Rocket''' Be VERY careful with the use of this command. It is very demanding as it must iterate through all mission created objects. Particular care should be taken exercising this often on dedicated servers.
-<!-- Note Section END -->
-</dl>
-<h3 style='display:none'>Bottom Section</h3>
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
-[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]