setVehicleAmmo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]2(\|.*)?\]\]" to "{{GameCategory|arma2|Scripting Commands}}")
m (Text replacement - "kju" to ".kju")
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma1 |Game name=
|game1= arma1
|version1= 1.00


|1.00|Game version=
|game2= arma2
|arg= local |Multiplayer Arguments=
|version2= 1.00


|eff= global |Multiplayer Effects=
|game3= arma2oa
|version3= 1.50


|gr1= Vehicle Inventory |GROUP1=
|game4= tkoh
____________________________________________________________________________________________
|version4= 1.00


| Sets how much ammunition (compared to a full state defined by the vehicle type) the vehicle has. Note that the ammo will be added only to [[local]] turrets. To check locality of turret use [[turretLocal]].
|game5= arma3
|version5= 0.50


The value ranges from 0 to 1. |DESCRIPTION=
|arg= local
____________________________________________________________________________________________


| vehicleName '''setVehicleAmmo''' value |SYNTAX=
|eff= global


|p1= vehicleName: [[Object]] |PARAMETER1=
|gr1= Vehicle Inventory


|p2= value: [[Number]] - 0: empty, 1: full|PARAMETER2=
|descr= Sets how much ammunition (compared to a full state defined by the vehicle type) the vehicle has. Note that the ammo will be added only to [[Multiplayer Scripting#Locality|local]] turrets. To check locality of turret use [[turretLocal]].


| [[Nothing]] |RETURNVALUE=
The value ranges from 0 to 1.
____________________________________________________________________________________________
 
|x1= <code>[[player]] [[setVehicleAmmo]] 0;</code> |EXAMPLE1=
|x2= <code>_vehicle [[setVehicleAmmo]] 1;</code> |EXAMPLE2=
____________________________________________________________________________________________


| [[setVehicleAmmoDef]], [[ammo]], [[setAmmo]], [[setAmmoCargo]], [[turretLocal]]|SEEALSO=
|s1= vehicleName [[setVehicleAmmo]] value


|p1= vehicleName: [[Object]]
|p2= value: [[Number]] - 0: empty, 1: full
|r1= [[Nothing]]
|x1= <sqf>player setVehicleAmmo 0;</sqf>
|x2= <sqf>_vehicle setVehicleAmmo 1;</sqf>
|seealso= [[setVehicleAmmoDef]] [[ammo]] [[setAmmo]] [[setAmmoCargo]] [[turretLocal]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->


<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:Ceeeb|Ceeeb]]
<dt class="note">[[User:Ceeeb|Ceeeb]]</dt>
<dd class="note">This command does not add magazines to vehicle weapons that normally start with more than one magazine. It can however, remove these magazines.
<dd class="note">This command does not add magazines to vehicle weapons that normally start with more than one magazine. It can however, remove these magazines.
 
<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:Bon_Inf*|Bon_Inf*]]
<dt class="note">[[User:Bon_Inf*|Bon_Inf*]]</dt>
<dd class="note">A2:OA v1.59 - Magazines of vehicle turrets are also refilled by this command.
<dd class="note">A2:OA v1.59 - Magazines of vehicle turrets are also refilled by this command.
 
<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:kju|kju]]
<dt class="note">[[User:.kju|.kju]]</dt>
<dd class="note">
<dd class="note">
* If you 'unit/vehicle setVehicleAmmo 0;' an unit/vehicle first, you cannot refill it with 'unit/vehicle setVehicleAmmo 1;'.
* If you 'unit/vehicle setVehicleAmmo 0;' an unit/vehicle first, you cannot refill it with 'unit/vehicle setVehicleAmmo 1;'.
* You need to execute where the unit is [[local]].
* You need to execute where the unit is [[Multiplayer Scripting#Locality|local]].
* You need to execute on the [[effectiveCommander]] of a vehicle.
* You need to execute on the [[effectiveCommander]] of a vehicle.
 
<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:Galzohar|Galzohar]]
<dt class="note">[[User:Galzohar|Galzohar]]</dt>
<dd class="note">
<dd class="note">
* In Arma 3, using this command seems correctly rearm the vehicle and its turrets in all situations (tested with beta 0.72).
* In Arma 3, using this command seems correctly rearm the vehicle and its turrets in all situations (tested with beta 0.72).
 
<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]</dt>
<dd class="note">
<dd class="note">
* In Arma 3, when using this on a player, this command can only reduce the number of magazine in relation to the current ammo quantity of the unit. For example if player has 8 magazines, [[player]] [[setVehicleAmmo]] 0.5; will leave unit with 4 mags. Executing [[player]] [[setVehicleAmmo]] 0.5; again will leave unit with 2 mags. [[player]] [[setVehicleAmmo]] 0.5; again -> 1 mag. [[player]] [[setVehicleAmmo]] 0; will remove all mags. If player had 10 mags with 30 bullets in each, [[player]] [[setVehicleAmmo]] 0.01; will leave player with loaded mag with 3 bullets in it (300 x 0.01 = 3)
* In Arma 3, when using this on a player, this command can only reduce the number of magazine in relation to the current ammo quantity of the unit. For example if player has 8 magazines, [[player]] [[setVehicleAmmo]] 0.5; will leave unit with 4 mags. Executing [[player]] [[setVehicleAmmo]] 0.5; again will leave unit with 2 mags. [[player]] [[setVehicleAmmo]] 0.5; again -> 1 mag. [[player]] [[setVehicleAmmo]] 0; will remove all mags. If player had 10 mags with 30 bullets in each, [[player]] [[setVehicleAmmo]] 0.01; will leave player with loaded mag with 3 bullets in it (300 x 0.01 = 3)




<!-- Note Section END -->
<dt></dt>
</dl>
<dd class="notedate">Posted on 2014-12-20 - 21:55 (UTC)</dd>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|SETVEHICLEAMMO]]
[[Category:Scripting Commands OFP Elite |SETVEHICLEAMMO]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on December 20, 2014 - 21:55 (UTC)</dd>
<dt class="note">[[User:Actium|Actium]]</dt>
<dt class="note">[[User:Actium|Actium]]</dt>
<dd class="note">
<dd class="note">
This command does not operate ''compared to a full state defined by the vehicle type'', but rather relative to a vehicle's current magazine loadout. To get the former behaviour use [[setVehicleAmmoDef]], which utilizes the vehicles default magazine loadout (i.e. its CfgVehicles magazines[] values).
This command does not operate ''compared to a full state defined by the vehicle type'', but rather relative to a vehicle's current magazine loadout. To get the former behaviour use [[setVehicleAmmoDef]], which utilizes the vehicles default magazine loadout (i.e. its CfgVehicles magazines[] values).
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 20:32, 3 May 2024

Hover & click on the images for description

Description

Description:
Sets how much ammunition (compared to a full state defined by the vehicle type) the vehicle has. Note that the ammo will be added only to local turrets. To check locality of turret use turretLocal. The value ranges from 0 to 1.
Groups:
Vehicle Inventory

Syntax

Syntax:
vehicleName setVehicleAmmo value
Parameters:
vehicleName: Object
value: Number - 0: empty, 1: full
Return Value:
Nothing

Examples

Example 1:
player setVehicleAmmo 0;
Example 2:
_vehicle setVehicleAmmo 1;

Additional Information

See also:
setVehicleAmmoDef ammo setAmmo setAmmoCargo turretLocal

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
Ceeeb
This command does not add magazines to vehicle weapons that normally start with more than one magazine. It can however, remove these magazines.
Bon_Inf*
A2:OA v1.59 - Magazines of vehicle turrets are also refilled by this command.
.kju
  • If you 'unit/vehicle setVehicleAmmo 0;' an unit/vehicle first, you cannot refill it with 'unit/vehicle setVehicleAmmo 1;'.
  • You need to execute where the unit is local.
  • You need to execute on the effectiveCommander of a vehicle.
Galzohar
  • In Arma 3, using this command seems correctly rearm the vehicle and its turrets in all situations (tested with beta 0.72).
Killzone_Kid
  • In Arma 3, when using this on a player, this command can only reduce the number of magazine in relation to the current ammo quantity of the unit. For example if player has 8 magazines, player setVehicleAmmo 0.5; will leave unit with 4 mags. Executing player setVehicleAmmo 0.5; again will leave unit with 2 mags. player setVehicleAmmo 0.5; again -> 1 mag. player setVehicleAmmo 0; will remove all mags. If player had 10 mags with 30 bullets in each, player setVehicleAmmo 0.01; will leave player with loaded mag with 3 bullets in it (300 x 0.01 = 3)
Posted on 2014-12-20 - 21:55 (UTC)
Actium
This command does not operate compared to a full state defined by the vehicle type, but rather relative to a vehicle's current magazine loadout. To get the former behaviour use setVehicleAmmoDef, which utilizes the vehicles default magazine loadout (i.e. its CfgVehicles magazines[] values).