setMagazineTurretAmmo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(47 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 1.34


|1.34|= Game version
|gr2= Turrets


____________________________________________________________________________________________
|descr= Sets ammo count to given amount for given turret magazine.
{{Feature|informative|
Since {{arma3}} v2.18 the magazine is first checked if it is loaded into the turret weapon, if not, the command falls back to old behaviour of selecting the first magazine from the list of available magazines.
In most cases this will be the loaded magazine anyway.
}}
{{Feature|important|The turret itself '''must''' be local (see [[turretLocal]], [[turretOwner]]).}}


| Sets ammo count to given amount for given turret.
|s1= vehicle [[setMagazineTurretAmmo]] [magazineClass, ammoCount, turretPath]
{{warning | Broken when vehicle has multiple magazines of the same type}} |= Description
____________________________________________________________________________________________


| vehicle [[setMagazineTurretAmmo]] [magazineClass, ammoCount, turretPath] |= Syntax
|p1= vehicle: [[Object]]


|p1= vehicle: [[Object]] |= PARAMETER1
|p2= magazineClass: [[String]]


|p2= [magazineClass, ammoCount, turretPath]: [[Array]] |= PARAMETER2
|p3= ammoCount: [[Number]]


| [[Number]] |= RETURNVALUE
|p4= turretPath: [[Array]] format [[Turret Path]] - [-1] for driver turret is supported


|r1= [[Nothing]]


|x1= |= EXAMPLE1
|x1= <sqf>myMRAP setMagazineTurretAmmo ["200Rnd_127x99_mag_Tracer_Red", 30, [0]];</sqf>
____________________________________________________________________________________________


| |= SEEALSO
|x2= Set ammo count on commander turret from server:
<sqf>
_tank = tank;
_turret = [0,0];
_magazine = "200Rnd_127x99_mag_Tracer_Red";
_ammo = 10;
[_tank, [_magazine, _ammo, _turret]] remoteExec ["setMagazineTurretAmmo", _tank turretOwner _turret];
</sqf>


| |= MPBEHAVIOUR
|seealso= [[magazineTurretAmmo]] [[setAmmoOnPylon]] [[turretLocal]] [[turretOwner]]
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Broken Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 17:45, 3 April 2024

Hover & click on the images for description

Description

Description:
Sets ammo count to given amount for given turret magazine.
Since Arma 3 v2.18 the magazine is first checked if it is loaded into the turret weapon, if not, the command falls back to old behaviour of selecting the first magazine from the list of available magazines. In most cases this will be the loaded magazine anyway.
The turret itself must be local (see turretLocal, turretOwner).
Groups:
Turrets

Syntax

Syntax:
vehicle setMagazineTurretAmmo [magazineClass, ammoCount, turretPath]
Parameters:
vehicle: Object
magazineClass: String
ammoCount: Number
turretPath: Array format Turret Path - [-1] for driver turret is supported
Return Value:
Nothing

Examples

Example 1:
myMRAP setMagazineTurretAmmo ["200Rnd_127x99_mag_Tracer_Red", 30, [0]];
Example 2:
Set ammo count on commander turret from server:
_tank = tank; _turret = [0,0]; _magazine = "200Rnd_127x99_mag_Tracer_Red"; _ammo = 10; [_tank, [_magazine, _ammo, _turret]] remoteExec ["setMagazineTurretAmmo", _tank turretOwner _turret];

Additional Information

See also:
magazineTurretAmmo setAmmoOnPylon turretLocal turretOwner

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