setPylonLoadout

From Bohemia Interactive Community
Revision as of 09:59, 1 February 2024 by POLPOX (talk | contribs) (MP update)
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Adds/overrides loadout to a vehicle pylon. TransportPylonsComponent in vehicle config and pylonWeapon in the magazine config are required to run.
This command also adds the corresponded weapon if the vehicle does not have one, but will not remove one that is no longer used.
In Multiplayer, this command should run locally to the vehicle itself or will cause desync issue! (especially upon the locality change eg get in the vehicle) See Example 4 for MP-compatible usage.
Groups:
Vehicle Loadouts

Syntax

Syntax:
vehicle setPylonLoadout [pylon, magazine, forced, turret]
Parameters:
vehicle: Object
pylon: Number or String - pylon index (index starts from 1) or pylon name (see getCompatiblePylonMagazines Example 4)
magazine: String - magazine name
forced: Boolean - (Optional, default false) true to force incompatible magazine
turret: Array - (Optional, default []) turret path
Return Value:
Boolean - true on success

Examples

Example 1:
vehicle player setPylonLoadout ["pylon1", ""];
Example 2:
Make all of your pylon weapons Twin Cannon 30 mm:
for "_i" from 1 to 100 do { vehicle player setPylonLoadout [_i, "PylonWeapon_300Rnd_20mm_shells", true]; };
Example 3:
Showcase all possible magazines:
[] spawn { { for "_i" from 1 to 100 do { vehicle player setPylonLoadout [_i, configName _x, true]; }; hint configName _x; sleep 1.5; } forEach ("getText (_x >> 'pylonWeapon') != ''" configClasses (configFile >> "CfgMagazines")); };
Example 4:
MP compatible usage:
[myPlane, [1, "PylonWeapon_300Rnd_20mm_shells", true]] remoteExecCall ["setPylonLoadout", myPlane];

Additional Information

See also:
Arma 3: Vehicle Loadouts getCompatiblePylonMagazines getPylonMagazines setAmmoOnPylon ammoOnPylon animatePylon animateBay setPylonsPriority

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
POLPOX - c
Posted on Apr 30, 2020 - 13:01 (UTC)
turret must be [] if you wanted to equip the magazine to the pilot. [-1] will return false and fails unlike other turret related commands.