addWeaponWithAttachmentsCargoGlobal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{Command|= ____________________________________________________________________________________________ | arma3dev |Game= |1.93|Game Version= |arg= global |= Arguments in...")
 
m (Changed parameter format)
(39 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|=
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |Game=
|game1= arma3
|version1= 1.94


|1.93|Game Version=
|arg= global
|eff= global


|arg= global |= Arguments in MP
|gr1= Vehicle Inventory


|eff= global |= Effects in MP
|descr= Adds a weapon into the cargo space of a vehicle / box with given attachments / magazines. Ignores available cargo space. If the weapon class has any pre-attached items (LinkedItems), they are removed and new items, supplied via command arguments, are added.
____________________________________________________________________________________________


|  
|s1= container [[addWeaponWithAttachmentsCargoGlobal]] [weaponConfiguration, weaponsCount]
Add a weapon into cargo space of vehicles, but with pre-attached attachments/magazines. Ignores available cargo space.
|Description=
____________________________________________________________________________________________


| container addWeaponWithAttachmentsCargoGlobal [weapon, muzzleAttachment, sideAttachment, topAttachment, bipodAttachment, [(primaryMagazine), (primaryAmmoCount), (secondaryMagazine), (secondaryAmmoCount)], (count)] |SYNTAX=
|p1= container: [[Object]] - Container to add the weapon to. Might be a backpack, ammobox or vehicle.


|p1= container: [[Object]] - container to add the weapon to, might be backpack, ammobox or vehicle. |Parameter 1=
|p2= weaponConfiguration: [[Array]] in format [weapon, muzzle, flashlight, optics, primaryMuzzle, secondaryMuzzle, bipod]
* weapon: [[String]] - Weapon class name from [[:Category:CfgWeapons|CfgWeapons]]
* muzzle: [[String]] - Muzzle attachment class name. Use "" if not needed.
* flashlight: [[String]] - Side rail attachment class name. Use "" if not needed.
* optics: [[String]] - Top rail attachment class name. Use "" if not needed.
* primaryMuzzle: [[Array]] in format [primaryMuzzleMagazine, primaryAmmoCount] - Use [] if not needed
** primaryMuzzleMagazine: [[String]] - Magazine class name
** primaryAmmoCount: [[Number]] - Ammo count in magazine (will be clipped to values between 0 and the maximum capacity of the magazine class)
* secondaryMuzzle: [[Array]] in format [secondaryMuzzleMagazine, secondaryAmmoCount] - Use [] if not needed
** secondaryMuzzleMagazine: [[String]] - Magazine class name
** secondaryAmmoCount: [[Number]] - Ammo count in magazine (will be clipped to values between 0 and the maximum capacity of the magazine class)
* bipod: [[String]] - Underbarrel rail attachment class name. Use "" if not needed.
This array has the same format as the array returned by the [[weaponsItems]] command.


|p2= weapon: [[String]] - weapon classname. See the topic [[:Category:Weapons]] for reference about possible values. |Parameter 2=
|p3= weaponsCount: [[Number]] - Number of weapons to add


|p3= muzzleAttachment: [[String]] - Muzzle attachment classname. If you don't want any just supply empty string. |Parameter 3=
|r1= [[Nothing]]


|p4= sideAttachment: [[String]] - Side rail attachment classname. If you don't want any just supply empty string. |Parameter 4=
|x1= <code>[[cursorObject]] [[addWeaponWithAttachmentsCargoGlobal]] [<nowiki/>["arifle_MX_GL_F", "muzzle_snds_H", "", "optic_aco", ["30Rnd_65x39_caseless_mag", 15], ["3Rnd_HE_Grenade_shell", 2], ""], 2];
</code>


|p5= topAttachment: [[String]] - Top rail attachment classname. If you don't want any just supply empty string. |Parameter 5=
|x2= Add five MX GL rifles, each with flashlight side attachment, a full 30 rounds magazine loaded into the gun and a full 3Rnd HE grenade magazine loaded into the grenade launcher:
<code>[[cursorObject]] [[addWeaponWithAttachmentsCargoGlobal]] [<nowiki/>["arifle_MX_GL_F", "", "acc_flashlight", "", ["30Rnd_65x39_caseless_mag", 30], ["3Rnd_HE_Grenade_shell", 2], ""], 5]</code>


|p6= bipodAttachment: [[String]] - Underbarrel rail attachment classname. If you don't want any just supply empty string. |Parameter 6=
|x3= Add one MX rifle without any attachments or magazines event though the class has linked items:
<code>[[cursorObject]] [[addWeaponWithAttachmentsCargoGlobal]] [<nowiki/>["arifle_MX_Holo_pointer_F", "", "", "", [], [], ""], 1];</code>


|p7= primaryMagazine (Optional): [[String]] - Primary magazine classname. If you don't want any just supply empty string or leave the whole magazine array empty. |Parameter 7=
|x4= Add all weapons on player with attachments:
<code>{ [[cursorObject]] [[addWeaponWithAttachmentsCargoGlobal]] [_x, 1] } [[forEach]] [[weaponsItems]] [[player]];</code>


|p8= primaryAmmoCount (Optional): [[Number]] - Ammo count in primary magazine if you want default you can just omit this parameter. <br>
|seealso= [[addWeaponWithAttachmentsCargo]] [[weaponsItems]] [[addWeaponCargo]] [[addWeaponCargoGlobal]] [[clearWeaponCargo]] [[getWeaponCargo]]
But you have to supply a correct value if you want a secondary magazine. (Might change before release out of dev branch) |Parameter 8=
}}


|p9= secondaryMagazine (Optional): [[String]] - Secondary magazine classname. If you don't want any just supply empty string or leave the whole magazine array empty. |Parameter 9=


|p10= secondaryAmmoCount (Optional): [[Number]] - Ammo count in secondary magazine if you want default you can just omit this parameter. |Parameter 10=
<dl class="command_description">
 
|p11= count (Optional): [[Number]] - Number of weapons to add. Default is 1. |Parameter 11=
 
| [[Nothing]] |Return Value=
 
____________________________________________________________________________________________
 
|x1= <code>cursorTarget addWeaponWithAttachmentsCargoGlobal ["arifle_MX_GL_F", "muzzle_snds_H", "acc_flashlight", "optic_aco", "", ["30Rnd_65x39_caseless_mag", 15, "3Rnd_HE_Grenade_shell", 2], 2]
</code> |Example 1=
____________________________________________________________________________________________


|x2= <code>cursorTarget addWeaponWithAttachmentsCargoGlobal ["arifle_MX_GL_F", "", "acc_flashlight", "", "", ["30Rnd_65x39_caseless_mag", 30, "3Rnd_HE_Grenade_shell"], 2] </code> Add's two MX GL rifles with flashlight side attachment and a full 30 round magazine loaded into the gun, and 3Rnd HE grenade magazine loaded into the grenade launcher |Example 2=
<dt></dt>
____________________________________________________________________________________________
<dd class="notedate">Posted on October 28, 2020 - 20:57 (UTC)</dd>
<dt class="note">[[User:Andrew_S90|Andrew_S90]]</dt>
<dd class="note">


|x3= <code>cursorTarget addWeaponWithAttachmentsCargoGlobal ["arifle_MX_GL_F", "", "", "", "", []]</code> Same as a simple [[addWeaponCargo]]. This is the minimum number of arguments you need to supply. |Example 3=
This command also allows you to add a weapon with attachments directly to the players backpack.
____________________________________________________________________________________________
<code>(backpackContainer player) addWeaponWithAttachmentsCargoGlobal [ ["arifle_MX_F","muzzle_snds_H","acc_pointer_IR","optic_Hamr",["30Rnd_65x39_caseless_mag",30],[],"bipod_03_F_blk"], 1];</code>


| [[addWeaponWithAttachmentsCargo]], [[addWeaponCargo]], [[addWeaponCargoGlobal]], [[clearWeaponCargo]], [[getWeaponCargo]], |See Also=
</dd>
}}


<dl class="command_description">
<!-- BEGIN Note Section -->
<!-- For example:
<dd class="notedate">Posted on Month Day, Year - Time (UTC)</dd>
<dt class="note">'''[[User:User Name|User Name]]'''</dt>
<dd class="note">This is an example note. It is true and verifiable, and contains a little code snippet.
<code>[[if]] ([[_this]] == anExample) [[then]] { [[hint]] "Leave it here for others to read"; };</code></dd>
-->
<!-- END Note Section -->
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
<!-- Appropriate categories go here -->
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 19:11, 12 October 2021

Hover & click on the images for description

Description

Description:
Adds a weapon into the cargo space of a vehicle / box with given attachments / magazines. Ignores available cargo space. If the weapon class has any pre-attached items (LinkedItems), they are removed and new items, supplied via command arguments, are added.
Groups:
Vehicle Inventory

Syntax

Syntax:
container addWeaponWithAttachmentsCargoGlobal [weaponConfiguration, weaponsCount]
Parameters:
container: Object - Container to add the weapon to. Might be a backpack, ammobox or vehicle.
weaponConfiguration: Array in format [weapon, muzzle, flashlight, optics, primaryMuzzle, secondaryMuzzle, bipod]
  • weapon: String - Weapon class name from CfgWeapons
  • muzzle: String - Muzzle attachment class name. Use "" if not needed.
  • flashlight: String - Side rail attachment class name. Use "" if not needed.
  • optics: String - Top rail attachment class name. Use "" if not needed.
  • primaryMuzzle: Array in format [primaryMuzzleMagazine, primaryAmmoCount] - Use [] if not needed
    • primaryMuzzleMagazine: String - Magazine class name
    • primaryAmmoCount: Number - Ammo count in magazine (will be clipped to values between 0 and the maximum capacity of the magazine class)
  • secondaryMuzzle: Array in format [secondaryMuzzleMagazine, secondaryAmmoCount] - Use [] if not needed
    • secondaryMuzzleMagazine: String - Magazine class name
    • secondaryAmmoCount: Number - Ammo count in magazine (will be clipped to values between 0 and the maximum capacity of the magazine class)
  • bipod: String - Underbarrel rail attachment class name. Use "" if not needed.
This array has the same format as the array returned by the weaponsItems command.
weaponsCount: Number - Number of weapons to add
Return Value:
Nothing

Examples

Example 1:
cursorObject addWeaponWithAttachmentsCargoGlobal [["arifle_MX_GL_F", "muzzle_snds_H", "", "optic_aco", ["30Rnd_65x39_caseless_mag", 15], ["3Rnd_HE_Grenade_shell", 2], ""], 2];
Example 2:
Add five MX GL rifles, each with flashlight side attachment, a full 30 rounds magazine loaded into the gun and a full 3Rnd HE grenade magazine loaded into the grenade launcher: cursorObject addWeaponWithAttachmentsCargoGlobal [["arifle_MX_GL_F", "", "acc_flashlight", "", ["30Rnd_65x39_caseless_mag", 30], ["3Rnd_HE_Grenade_shell", 2], ""], 5]
Example 3:
Add one MX rifle without any attachments or magazines event though the class has linked items: cursorObject addWeaponWithAttachmentsCargoGlobal [["arifle_MX_Holo_pointer_F", "", "", "", [], [], ""], 1];
Example 4:
Add all weapons on player with attachments: { cursorObject addWeaponWithAttachmentsCargoGlobal [_x, 1] } forEach weaponsItems player;

Additional Information

See also:
addWeaponWithAttachmentsCargo weaponsItems addWeaponCargo addWeaponCargoGlobal clearWeaponCargo getWeaponCargo

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


Posted on October 28, 2020 - 20:57 (UTC)
Andrew_S90
This command also allows you to add a weapon with attachments directly to the players backpack. (backpackContainer player) addWeaponWithAttachmentsCargoGlobal [ ["arifle_MX_F","muzzle_snds_H","acc_pointer_IR","optic_Hamr",["30Rnd_65x39_caseless_mag",30],[],"bipod_03_F_blk"], 1];