Unit Loadout Array: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Add items order note (thanks to MKNavaG) and array description)
m (Add binoculars link)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{| class="wikitable" style="float: right; margin: 0 0 0.5em 1.5em"
{| class="wikitable"
! #
! Index
! Element
! Element
! Description
! Description
|- style="vertical-align: top"
|- style="vertical-align: top"
| 1
| 0
| [[primaryWeapon|Primary Weapon]]
| [[primaryWeapon|Primary Weapon]]
|
| style="font-size: .95em" |
* classname
* classname
* suppressor
* suppressor
Line 15: Line 15:
* bipod
* bipod
|- style="vertical-align: top"
|- style="vertical-align: top"
| 2
| 1
| [[secondaryWeapon|Secondary Weapon]]
| [[secondaryWeapon|Secondary Weapon]]
|
| style="font-size: .95em" |
* classname
* classname
* suppressor
* suppressor
Line 26: Line 26:
* bipod
* bipod
|- style="vertical-align: top"
|- style="vertical-align: top"
| 3
| 2
| [[handgunWeapon|Handgun Weapon]]
| [[handgunWeapon|Handgun Weapon]]
|
| style="font-size: .95em" |
* classname
* classname
* suppressor
* suppressor
Line 37: Line 37:
* bipod
* bipod
|- style="vertical-align: top"
|- style="vertical-align: top"
| 4
| 3
| [[uniform|Uniform]]
| [[uniform|Uniform]]
|
|
* classname
* classname
* items list and count
* Array of:
** If item: items name and count
** If magazine: magazines name, count, and their ammo count
** If weapon: weapon detail (see the {{hl|Primary Weapon}}) and count
** If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in {{hl|CfgVehicles}}, and vests and uniforms in {{hl|CfgWeapons}})
|- style="vertical-align: top"
|- style="vertical-align: top"
| 5
| 4
| [[vest|Vest]]
| [[vest|Vest]]
|
|
* classname
* classname
* items list and count
* Array of:
** If item: items name and count
** If magazine: magazines name, count, and their ammo count
** If weapon: weapon detail (see the {{hl|Primary Weapon}}) and count
** If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in {{hl|CfgVehicles}}, and vests and uniforms in {{hl|CfgWeapons}})
|- style="vertical-align: top"
|- style="vertical-align: top"
| 6
| 5
| [[backpack|Backpack]]
| [[backpack|Backpack]]
|
|
* classname
* classname
* items list and count
* Array of:
** If item: items name and count
** If magazine: magazines name, count, and their ammo count
** If weapon: weapon detail (see the {{hl|Primary Weapon}}) and count
** If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in {{hl|CfgVehicles}}, and vests and uniforms in {{hl|CfgWeapons}})
|- style="vertical-align: top"
|- style="vertical-align: top"
| 7
| 6
| [[headgear|Headgear]]
| [[headgear|Headgear]]
| {{n/a}}
| classname ([[String]])
|- style="vertical-align: top"
|- style="vertical-align: top"
| 8
| 7
| [[goggles|Goggles/Facewear]]
| [[goggles|Goggles/Facewear]]
| {{n/a}}
| classname ([[String]])
|- style="vertical-align: top"
|- style="vertical-align: top"
| 9
| 8
| '''Binoculars'''
| [[binocular|Binoculars]]
|
| style="font-size: .95em" |
* classname
* classname
* suppressor
* suppressor
Line 74: Line 86:
* bipod
* bipod
|- style="vertical-align: top"
|- style="vertical-align: top"
| 10
| 9
| [[assignedItems|Assigned Items]]<br>(without Binoculars)
| [[assignedItems|Assigned Items]]
|
* in a different order<br>than [[assignedItems]]
* no binoculars
| style="font-size: .95em" |
* Map
* Map
* GPS/UAV terminal
* Radio
* Compass
* Compass
* Watch
* Watch
* Radio
* GPS/UAV terminal
* [[hmd|NVG]]
* [[hmd|NVG]]
|}
|}


This array format is used with [[getUnitLoadout]] and [[setUnitLoadout]] commands. Its format is described in the side table.
This array format is used with [[getUnitLoadout]] and [[setUnitLoadout]] commands. Its format is described in the side table.
{{Feature|informative|items listed in uniform/vest/backpack (including other containers) are listed in the reverse order - the topmost item is located at the end of the container items' array.}}
{{Feature|informative|'''Weapons''' listed as storage items are always listed at the end of the array, but are displayed at the top of the list in the UI.}}




Line 104: Line 118:
/* backpack */ ["B_AssaultPack_mcamo_AT",[["Titan_AT", 2, 1]]],
/* backpack */ ["B_AssaultPack_mcamo_AT",[["Titan_AT", 2, 1]]],
/* items */ "H_HelmetB_light_desert", "G_Bandanna_tan",[],
/* items */ "H_HelmetB_light_desert", "G_Bandanna_tan",[],
/* items */ ["ItemMap","","ItemRadio","ItemCompass","ItemWatch","NVGoggles"]
/* items */ ["ItemMap", "", "ItemRadio", "ItemCompass", "ItemWatch", "NVGoggles"]
]
]
</syntaxhighlight>
</syntaxhighlight>
Line 129: Line 143:
[ // Uniform Items
[ // Uniform Items
["FirstAidKit", 1], // Type, count
["FirstAidKit", 1], // Type, count
["30Rnd_65x39_caseless_mag", 30, 2]
["30Rnd_65x39_caseless_mag", 2, 30] // Magazines are: Type, count, ammo
] // Magazines are Type, ammo, count - Arma version 1.64> is Type, count, ammo
]
],
],
[ // Vest Info
[ // Vest Info
"V_PlateCarrierGL_rgr", // Vest Type
"V_PlateCarrierGL_rgr", // Vest Type
[ // Vest Items
[ // Vest Items
["30Rnd_65x39_caseless_mag", 30, 3]
["30Rnd_65x39_caseless_mag", 3, 30]
]
]
],
],
[], // Backpack Info (follows same layout as above for Uniform and Vest)
[   // Backpack Info
        "B_Carryall_ocamo",                    // Backpack type
[ // Backpack Items
["B_Carryall_khk", true],          // A backpack inside the backpack (isBackpack is true, so item is defined in CfgVehicles)
            ["U_B_CombatUniform_mcam", false], // A uniform inside the backpack (isBackpack is false, so item is defined in CfgWeapons)
            // A weapon inside the backpack
            [["arifle_MX_ACO_pointer_F", "", "acc_pointer_IR", "optic_Aco", [], [], ""], 1]
]
    ],
"H_HelmetSpecB_blk", // Helmet
"H_HelmetSpecB_blk", // Helmet
"G_Tactical_Clear", //Facewear glasses/bandanna etc
"G_Tactical_Clear", //Facewear glasses/bandanna etc

Latest revision as of 06:44, 20 June 2022

Index Element Description
0 Primary Weapon
  • classname
  • suppressor
  • pointer
  • optics
  • muzzle 1's magazine and ammunition
  • muzzle 2's magazine and ammunition
  • bipod
1 Secondary Weapon
  • classname
  • suppressor
  • pointer
  • optics
  • muzzle 1's magazine and ammunition
  • muzzle 2's magazine and ammunition
  • bipod
2 Handgun Weapon
  • classname
  • suppressor
  • pointer
  • optics
  • muzzle 1's magazine and ammunition
  • muzzle 2's magazine and ammunition
  • bipod
3 Uniform
  • classname
  • Array of:
    • If item: items name and count
    • If magazine: magazines name, count, and their ammo count
    • If weapon: weapon detail (see the Primary Weapon) and count
    • If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in CfgVehicles, and vests and uniforms in CfgWeapons)
4 Vest
  • classname
  • Array of:
    • If item: items name and count
    • If magazine: magazines name, count, and their ammo count
    • If weapon: weapon detail (see the Primary Weapon) and count
    • If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in CfgVehicles, and vests and uniforms in CfgWeapons)
5 Backpack
  • classname
  • Array of:
    • If item: items name and count
    • If magazine: magazines name, count, and their ammo count
    • If weapon: weapon detail (see the Primary Weapon) and count
    • If container (backpack/vest/uniform): container name and whether it's a backpack (backpacks are defined in CfgVehicles, and vests and uniforms in CfgWeapons)
6 Headgear classname (String)
7 Goggles/Facewear classname (String)
8 Binoculars
  • classname
  • suppressor
  • pointer
  • optics
  • muzzle 1's magazine and ammunition
  • muzzle 2's magazine and ammunition
  • bipod
9 Assigned Items
  • Map
  • GPS/UAV terminal
  • Radio
  • Compass
  • Watch
  • NVG

This array format is used with getUnitLoadout and setUnitLoadout commands. Its format is described in the side table.

Weapons listed as storage items are always listed at the end of the array, but are displayed at the top of the list in the UI.


Examples

These are examples of Unit Loadout Array structures (see getUnitLoadout, setUnitLoadout).

B_soldier_AT_F

[
	/* primary weapon */	["arifle_MXC_Holo_pointer_F", "", "acc_pointer_IR", "optic_Holosight", ["30Rnd_65x39_caseless_mag", 30], [], ""],
	/* secondary weapon */	["launch_B_Titan_short_F", "", "", "", ["Titan_AT", 1], [], ""],
	/* handgun weapon */	["hgun_P07_F", "", "", "", ["16Rnd_9x21_Mag", 16], [], ""],
	/* uniform */			["U_B_CombatUniform_mcam", [["FirstAidKit", 1], ["30Rnd_65x39_caseless_mag", 2, 30], ["Chemlight_green", 1, 1]]],
	/* vest */				["V_PlateCarrier1_rgr", [["30Rnd_65x39_caseless_mag", 3, 30], ["16Rnd_9x21_Mag", 2, 16], ["SmokeShell", 1 ,1], ["SmokeShellGreen", 1, 1], ["Chemlight_green", 1, 1]]],
	/* backpack */			["B_AssaultPack_mcamo_AT",[["Titan_AT", 2, 1]]],
	/* items */				"H_HelmetB_light_desert", "G_Bandanna_tan",[],
	/* items */				["ItemMap", "", "ItemRadio", "ItemCompass", "ItemWatch", "NVGoggles"]
]

Misc

[
	[
		"arifle_MX_GL_F","muzzle_snds_H", "acc_pointer_IR", "optic_Aco",	// Primary weapon, (weapon items) silencer, pointer, optic
		["30Rnd_65x39_caseless_mag", 30],									// Loaded mag in primary muzzle, ammo count
		["1Rnd_HE_Grenade_shell", 1],										// Loaded mag in secondary muzzle, ammo count
		""	// Bipod
	],
	[],	// Secondary weapon info (see primary above)
	[	// handGun info (see primary above)
		"hgun_P07_F", "", "", "",
		["16Rnd_9x21_Mag", 16],
		[],
		""
	],
	[	// Uniform
		"U_B_CombatUniform_mcam", // Uniform Type
		[	// Uniform Items
			["FirstAidKit", 1],	// Type, count
			["30Rnd_65x39_caseless_mag", 2, 30] // Magazines are: Type, count, ammo
		]
	],
	[	// Vest Info
		"V_PlateCarrierGL_rgr",	// Vest Type
		[	// Vest Items
			["30Rnd_65x39_caseless_mag", 3, 30]
		]
	],
	[   // Backpack Info
        "B_Carryall_ocamo",                    // Backpack type
		[	// Backpack Items
			["B_Carryall_khk", true],          // A backpack inside the backpack (isBackpack is true, so item is defined in CfgVehicles)
            ["U_B_CombatUniform_mcam", false], // A uniform inside the backpack (isBackpack is false, so item is defined in CfgWeapons)
            // A weapon inside the backpack
            [["arifle_MX_ACO_pointer_F", "", "acc_pointer_IR", "optic_Aco", [], [], ""], 1]
		]
    ],
	"H_HelmetSpecB_blk",					// Helmet
	"G_Tactical_Clear",						//Facewear glasses/bandanna etc
	["Binocular", "", "", "", [], [], ""],	// Weapon Binocular (follows same layout as other weapons above)
	["ItemMap", "ItemGPS", "ItemRadio", "ItemCompass", "ItemWatch", "NVGoggles"]	// AssignedItems ItemGPS can also be a UAV Terminal
]