magazinesAllTurrets: Difference between revisions

Latest revision as of 05:00, 27 November 2023

1.52

GAGlobal

Hover & click on the images for description

Description

Description:: Returns all magazines (including empty) from all vehicle turrets (including driver turret [-1]) and their ammo counts. Since Arma 3 v2.08.148327 it is possible to exclude person turrets from returned results.
Groups:: Turrets

Syntax

Syntax:

magazinesAllTurrets vehicle

Parameters:

vehicle: Object - vehicle with turrets

Return Value:

Array - in the following format: [[className, turretPath, ammoCount, id, creator],...] where:

className: String - magazine class name
turretPath: Array format Turret Path
ammoCount: Number - how many rounds left in the magazine
id: Number - id of the magazine object. The number starts at 10,000,000. This gives it about 6,700,000 possible ids before the number starts losing precision and cannot be used in scripts.
creator: Number - owner / clientOwner of the PC that created the object

2.08

Alternative Syntax

Syntax:

magazinesAllTurrets [vehicle, excludePersonTurrets]

Parameters:

vehicle: Object - vehicle with turrets

excludePersonTurrets: Boolean - when true only vehicle's turrets are queried

Return Value:

Array - in the following format: [[className, turretPath, ammoCount, id, creator],...] where:

className: String - magazine class name
turretPath: Array format Turret Path
ammoCount: Number - how many rounds left in the magazine
id: Number - id of the magazine object. The number starts at 10,000,000. This gives it about 6,700,000 possible ids before the number starts losing precision and cannot be used in scripts.
creator: Number - owner / clientOwner of the PC that created the object

Examples

Example 1:: _mags = magazinesAllTurrets vehicle player;
Example 2:: _mags = magazinesAllTurrets [vehicle player, true];

Additional Information

See also:: magazinesTurret allTurrets addMagazineTurret removeMagazinesTurret removeMagazineTurret weaponsTurret loadMagazine magazines magazinesDetail magazinesAmmo magazinesAmmoFull addWeaponTurret removeWeaponTurret turretLocal getPylonMagazines ammoOnPylon

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
-| arma3
+|game1= arma3
-|1.52
+|version1= 1.52
 |arg= global
@@ Line 8: / Line 8: @@
 |gr1= Turrets
-| Returns all magazines (including empty) from all vehicle turrets (including driver turret [-1]) and their ammo counts.
+|descr= Returns all magazines (including empty) from all vehicle turrets (including driver turret [-1]) and their ammo counts. Since Arma 3 v2.08.148327 it is possible to exclude person turrets from returned results.
-| '''magazinesAllTurrets''' vehicle
+|s1= [[magazinesAllTurrets]] vehicle
 |p1= vehicle: [[Object]] - vehicle with turrets
-| [[Array]] - in the following format: [<nowiki/>[className, turretPath, ammoCount, id, creator],...]  where:
+|r1= [[Array]] - in the following format: [<nowiki/>[className, turretPath, ammoCount, id, creator],...]  where:
 * className: [[String]] - magazine class name
-* turretPath: [[Array]] - turret path
+* turretPath: [[Array]] format [[Turret Path]]
 * ammoCount: [[Number]] - how many rounds left in the magazine
-* id: [[Number]] - id of the magazine object. The number starts at 10,000,000. This gives it about 7,600,000 possible ids before the number starts losing precision and cannot be used in scripts.
+* id: [[Number]] - id of the magazine object. The number starts at 10,000,000. This gives it about 6,700,000 possible ids before the number starts losing precision and cannot be used in scripts.
 * creator: [[Number]] - [[owner]] / [[clientOwner]] of the PC that created the object
+|s2= [[magazinesAllTurrets]] [vehicle, excludePersonTurrets]
-|x1= <code>_mags = [[magazinesAllTurrets]] [[vehicle]] [[player]];</code>
-| [[magazinesTurret]], [[allTurrets]], [[addMagazineTurret]], [[removeMagazinesTurret]], [[removeMagazineTurret]], [[weaponsTurret]], [[loadMagazine]], [[magazines]], [[magazinesDetail]], [[magazinesAmmo]], [[magazinesAmmoFull]], [[addWeaponTurret]], [[removeWeaponTurret]], [[turretLocal]], [[getPylonMagazines]], [[ammoOnPylon]]
+|s2since= arma3 2.08
-}}
+|p21= vehicle: [[Object]] - vehicle with turrets
+|p22= excludePersonTurrets: [[Boolean]] - when [[true]] only vehicle's turrets are queried
+|r2= [[Array]] - in the following format: [<nowiki/>[className, turretPath, ammoCount, id, creator],...]  where:
+* className: [[String]] - magazine class name
+* turretPath: [[Array]] format [[Turret Path]]
+* ammoCount: [[Number]] - how many rounds left in the magazine
+* id: [[Number]] - id of the magazine object. The number starts at 10,000,000. This gives it about 6,700,000 possible ids before the number starts losing precision and cannot be used in scripts.
+* creator: [[Number]] - [[owner]] / [[clientOwner]] of the PC that created the object
+|x1= <sqf>_mags = magazinesAllTurrets vehicle player;</sqf>
+|x2= <sqf>_mags = magazinesAllTurrets [vehicle player, true];</sqf>
-{{GameCategory|arma3|New Scripting Commands}}
+|seealso= [[magazinesTurret]] [[allTurrets]] [[addMagazineTurret]] [[removeMagazinesTurret]] [[removeMagazineTurret]] [[weaponsTurret]] [[loadMagazine]] [[magazines]] [[magazinesDetail]] [[magazinesAmmo]] [[magazinesAmmoFull]] [[addWeaponTurret]] [[removeWeaponTurret]] [[turretLocal]] [[getPylonMagazines]] [[ammoOnPylon]]
-{{GameCategory|arma3|Scripting Commands}}
+}}
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]