reload

From Bohemia Interactive Community
Revision as of 15:28, 14 May 2022 by JasperRab (talk | contribs) (Replaced <code> with <sqf>)
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
  • Old syntax: Reload first found muzzle that needs reloading (with some inconsistencies).
  • Alternative syntax (Since Arma 3 v2.08.148609): This syntax allows to reload given muzzle with given magazine while playing proper animation. If param is omitted or is empty string, default value is used. The default behaviour is to find best matching magazine for given muzzle from the pool of available magazines. If specific magazine is requested, the reload will fail if unit has run out of this type of magazines. If empty array [] is given, the behaviour is similar to player pressing "Reload" key. The command reloads the given muzzle but doesn't select it. In case of throwable muzzles, each throwable has own muzzle, they are autoreloaded after throw. Using reload on the trowable muzzle will just swap throwable for another one of the same type from inventory.
Groups:
Weapons

Syntax

Syntax:
reload unitName
Parameters:
unitName: Object
Return Value:
Nothing

Alternative Syntax

Syntax:
unit reload [muzzle, magazine]
Parameters:
unit: Object - person
muzzle (Optional): String - muzzle name or "" for current muzzle. Default: currentMuzzle
magazine (Optional): String - magazine name or "" for given muzzle magazine. Default: given muzzle magazine. If given muzzle is currentMuzzle then currentMagazine
Return Value:
Boolean - true on success

Examples

Example 1:
if (needReload player == 1) then { reload player };
Example 2:
player reload ["GL_3GL_F", "1Rnd_HE_Grenade_shell"];
Example 3:
Reload current muzzle:
player reload [];

Additional Information

See also:
reloadEnabled needReload enableReload setWeaponReloadingTime

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