{"name":"needReload","operator":null,"title":"needReload","type":"command","url":"https://community.bistudio.com/wiki/needReload","revid":376453,"updated":"2025-10-14T11:29:23Z","groups":["Weapons"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Returns how much vehicle wants to reload its weapons.","syntaxes":[{"syntax":"needReload entity","since":null,"effect":null,"exec":null,"params":[{"name":"entity","type":"Object","optional":false,"default":null,"description":"unit or vehicle","types":["Object"],"since":null,"text":"entity: Object - unit or vehicle"}],"returns":{"type":"Number","types":["Number"],"description":"range: 0-1, 0: full mag, 1: empty mag","text":"Number - range: 0-1, 0: full mag, 1: empty mag"},"form":"unary","operator":null,"left":null,"right":{"text":"entity","types":["Object"]}},{"syntax":"entity needReload muzzle","since":"arma3 2.22","effect":null,"exec":null,"params":[{"name":"entity","type":"Object","optional":false,"default":null,"description":"unit or vehicle","types":["Object"],"since":null,"text":"entity: Object - unit or vehicle"},{"name":"muzzle","type":"String","optional":false,"default":null,"description":"muzzle to check. \"\" to check all muzzles","types":["String"],"since":null,"text":"muzzle: String - muzzle to check. \"\" to check all muzzles"}],"returns":{"type":"Number","types":["Number"],"description":"range: 0-1, 0: full mag, 1: empty mag","text":"Number - range: 0-1, 0: full mag, 1: empty mag"},"form":"binary","operator":null,"left":{"text":"entity","types":["Object"]},"right":{"text":"muzzle","types":["String"]}}],"examples":[{"text":"```sqf\n_seriousness = needReload _vehicle;\n```","code":["_seriousness = needReload _vehicle;"]},{"text":"```sqf\nif (needReload player == 1) then { reload player };\n```","code":["if (needReload player == 1) then { reload player };"]},{"text":"```sqf\nplayer needReload currentMuzzle player;\n```","code":["player needReload currentMuzzle player;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["needService","reload","reloadEnabled","enableReload"],"notes":[],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Weapons","Introduced with Armed Assault version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}