addWeaponWithAttachmentsCargo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Changed parameter format)
Line 10: Line 10:
|gr1= Vehicle Inventory
|gr1= Vehicle Inventory


|descr= Adds a weapon into 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.
|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.
{{Feature | important | This command has [[Multiplayer Scripting#Locality|local]] effect; for a global variant, see [[addWeaponWithAttachmentsCargoGlobal]].}}


|s1= container [[addWeaponWithAttachmentsCargo]] [<nowiki/>[weapon, muzzle, flashlight, optics, [primaryMuzzleMagazine, primaryAmmoCount], [secondaryMuzzleMagazine, secondaryAmmoCount], bipod], weaponsCount]
|s1= container [[addWeaponWithAttachmentsCargo]] [weaponConfiguration, weaponsCount]


|p1= container: [[Object]] - Container to add the weapon to, might be backpack, ammobox or vehicle
|p1= container: [[Object]] - Container to add the weapon to. Might be a backpack, ammobox or vehicle.


|p2= [<nowiki/>[weapon, muzzle, flashlight, optics, [primaryMuzzleMagazine, primaryAmmoCount], [secondaryMuzzleMagazine, secondaryAmmoCount], bipod], weaponsCount]: [[Array]]
|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.


|p3= [weapon, muzzle, flashlight, optics, [primaryMuzzleMagazine, primaryAmmoCount], [secondaryMuzzleMagazine, secondaryAmmoCount], bipod]: [[Array]] in format [[weaponsItems]]
|p3= weaponsCount: [[Number]] - Number of weapons to add
 
|p4= weapon: [[String]] - Weapon class name. See the topic [[:Category:Weapons]] for reference about possible values
 
|p5= muzzle: [[String]] - Muzzle attachment class name or "" if not needed
 
|p6= flashlight: [[String]] - Side rail attachment class name or "" if not needed
 
|p7= optics: [[String]] - Top rail attachment class name or "" if not needed
 
|p8= [primaryMuzzleMagazine, primaryAmmoCount]: [[Array]] - Primary muzzle magazine info or [] if not needed
 
|p9= primaryMuzzleMagazine: [[String]] - Magazine class name
 
|p10= primaryAmmoCount: [[Number]] - Ammo count in magazine (will be clipped in 0 and max mag capacity range)
 
|p11= [secondaryMuzzleMagazine, secondaryAmmoCount]: [[Array]] - Secondary muzzle magazine info or [] if not needed
 
|p12= secondaryMuzzleMagazine: [[String]] - Magazine class name
 
|p13= secondaryAmmoCount: [[Number]] - Ammo count in magazine (will be clipped in 0 and max mag capacity range)
 
|p14= bipod: [[String]] - Underbarrel rail attachment class name or "" if not needed
 
|p15= weaponsCount: [[Number]] - Number of weapons to add


|r1= [[Nothing]]
|r1= [[Nothing]]
Line 50: Line 37:
</code>
</code>


|x2= Add five MX GL rifles with flashlight side attachment and a full 30 rounds magazine loaded into the gun, and full 3Rnd HE grenade magazine loaded into the grenade launcher:
|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]] [[addWeaponWithAttachmentsCargo]] [<nowiki/>["arifle_MX_GL_F", "", "acc_flashlight", "", ["30Rnd_65x39_caseless_mag", 30], ["3Rnd_HE_Grenade_shell", 2], ""], 5]</code>
<code>[[cursorObject]] [[addWeaponWithAttachmentsCargo]] [<nowiki/>["arifle_MX_GL_F", "", "acc_flashlight", "", ["30Rnd_65x39_caseless_mag", 30], ["3Rnd_HE_Grenade_shell", 2], ""], 5]</code>


Line 59: Line 46:
<code>{ [[cursorObject]] [[addWeaponWithAttachmentsCargo]] [_x, 1] } [[forEach]] [[weaponsItems]] [[player]];</code>
<code>{ [[cursorObject]] [[addWeaponWithAttachmentsCargo]] [_x, 1] } [[forEach]] [[weaponsItems]] [[player]];</code>


|seealso= [[weaponsItems]], [[addWeaponCargo]], [[addWeaponCargoGlobal]], [[clearWeaponCargo]], [[getWeaponCargo]], [[addWeaponWithAttachmentsCargoGlobal]]
|seealso= [[addWeaponWithAttachmentsCargoGlobal]] [[weaponsItems]] [[addWeaponCargo]] [[addWeaponCargoGlobal]] [[clearWeaponCargo]] [[getWeaponCargo]]
}}
}}



Revision as of 18:05, 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 addWeaponWithAttachmentsCargo [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 addWeaponWithAttachmentsCargo [["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 addWeaponWithAttachmentsCargo [["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 addWeaponWithAttachmentsCargo [["arifle_MX_Holo_pointer_F", "", "", "", [], [], ""], 1];
Example 4:
Add all weapons on player with attachments: { cursorObject addWeaponWithAttachmentsCargo [_x, 1] } forEach weaponsItems player;

Additional Information

See also:
addWeaponWithAttachmentsCargoGlobal 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 - 21:03 (UTC)
Andrew_S90
This command also allows you to add a weapon with attachments directly to the players backpack. (backpackContainer player) addWeaponWithAttachmentsCargo [ ["arifle_MX_F","muzzle_snds_H","acc_pointer_IR","optic_Hamr",["30Rnd_65x39_caseless_mag",30],[],"bipod_03_F_blk"], 1];