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: @@
 {{RV|type=command
-| arma2oa
+|game1= arma2oa
+|version1= 1.57
-|1.57
+|game2= tkoh
+|version2= 1.00
+|game3= arma3
+|version3= 0.50
 |gr1= Object Detection
-| Returns all mission objects (created by or during a mission) with given type (or its subtype). In some cases [[allMissionObjects]] could be substituted with [[entities]], which would be much much faster alternative. Some of the unusual mission objects that can be detected with this command (as well as with [[nearestObject]]):
+|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>
-* <tt>"#slop"</tt> - blood drop
+Some of the special types that can be detected with this command (and with [[nearestObject]]):
-* <tt>"#mark"</tt> - unit footprints
+* {{hl|""}} - returns everything, e.g. agents, bees, mosquitoes, footprints, armed mines, ...
-* <tt>"#track"</tt> - vehicle tracks
+* {{hl|"all"}} - more restrictive than {{hl|""}}: no ambient insects, only agents such as rabbits and snakes, no footprints, tracks, no armed mines
-* <tt>"#crater"</tt> - explosion crater on the ground
+* {{hl|"#slop"}} - blood drops
-* <tt>"#crateronvehicle"</tt> - bullet marks on vehicle
+* {{hl|"#mark"}} - unit footprints
-* <tt>"#explosion"</tt> - an explosion
+* {{hl|"#track"}} - vehicle tracks
-* <tt>"#objectdestructed"</tt> - building, tree or bush destruction
+* {{hl|"#crater"}} - explosion craters on the ground
-* <tt>"#soundonvehicle"</tt> - sound created with [[say3D]] for example
+* {{hl|"#crateronvehicle"}} - bullet marks on vehicles
-* <tt>"#dynamicsound"</tt> - sound source created using [[createSoundSource]]
+* {{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!}}
-| '''allMissionObjects''' type
+|mp= {{Feature|arma3|This command is ~5 times faster on a dedicated server than on a client. Reason unknown.}}
-|p1 = type: [[String]]
+|s1= [[allMissionObjects]] type
-| [[Array]] of [[Object|Objects]]
+|p1= type: [[String]]
-|x1= <code>_airObjects = [[allMissionObjects]] "Air";</code>
+|r1= [[Array]] of [[Object]]s
-|x2= <code>{ [[deleteVehicle]] _x } [[forEach]] ([[allMissionObjects]] "");</code>
+|x1= <sqf>_airObjects = allMissionObjects "Air";</sqf>
-|x3= <code>_allMObjects =[[ allMissionObjects]] "All";</code>
+|x2= <sqf>{ deleteVehicle _x; } forEach (allMissionObjects "");</sqf>
-|  [[allDead]], [[allGroups]], [[allUnits]], [[entities]], [[vehicles]], [[allMines]], [[allSimpleObjects]]
+|x3= <sqf>_allMObjects = allMissionObjects "All";</sqf>
+|seealso= [[allObjects]] [[allDead]] [[allGroups]] [[allUnits]] [[entities]] [[vehicles]] [[allMines]] [[allSimpleObjects]]
 }}
-<dl class='command_description'>
-<!-- Note Section BEGIN -->
-<dd class="notedate">Posted on June 22, 2012
-<dt class="note">[[User:Rocket|Rocket]]
-<dd class="note">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.
-<dd class="notedate">Posted on Decembere 15, 2013
-<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
-<dd class="note">For some reason in Arma 3 this command is up to 5 times faster on the dedicated server than on a connected client. In my experiments it took on average 5 ms for the command to complete on a client while under 1 ms on the server.
-<!-- Note Section END -->
-</dl>
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
-{{GameCategory|arma2|Scripting Commands}}
-{{GameCategory|arma3|Scripting Commands}}
-{{GameCategory|tkoh|Scripting Commands}}
-[[Category:Arma 2: Operation Arrowhead: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]