getUnitLoadout: Difference between revisions
Jump to navigation
Jump to search
m (template:command argument fix) |
Killzone Kid (talk | contribs) (empty loadout) |
||
Line 1: | Line 1: | ||
{{Command|= | {{Command|Comments= | ||
|arma3|= Game name | |arma3|name= Game name | ||
|1.58|= Game version | |1.58|version= Game version | ||
| Returns a [[Unit Loadout Array]] with all assigned items, weapons, containers and their stored items. When [[String]] for class name is supplied, the command will search <tt>CfgVehicles</tt> for the given class in order to extract the loadout from config. If [[Config]] is given, it will search given config (including [[missionConfigFile | mission config]]) for the loadout information. In either case, the config should contain the following entries, which is standard for any unit class, for example: | | Returns a [[Unit Loadout Array]] with all assigned items, weapons, containers and their stored items. When [[String]] for class name is supplied, the command will search <tt>CfgVehicles</tt> for the given class in order to extract the loadout from config. If [[Config]] is given, it will search given config (including [[missionConfigFile | mission config]]) for the loadout information. In either case, the config should contain the following entries, which is standard for any unit class, for example: | ||
<syntaxhighlight lang=cpp> | <syntaxhighlight lang=cpp> | ||
Line 13: | Line 13: | ||
magazines[] = {"30Rnd_65x39_caseless_mag","16Rnd_9x21_Mag","SmokeShell","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade"}; | magazines[] = {"30Rnd_65x39_caseless_mag","16Rnd_9x21_Mag","SmokeShell","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade"}; | ||
};</syntaxhighlight> | };</syntaxhighlight> | ||
{{Informative | Since Arma 3 v1.92 an empty loadout could be obtained with <tt>[[getUnitLoadout]] ([[configFile]] >> "EmptyLoadout")</tt>}} | |||
|DESCRIPTION= | |DESCRIPTION= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| [[getUnitLoadout]] unit | | | [[getUnitLoadout]] unit |SYNTAX1= | ||
|p1= unit: [[Object]] |PARAMETER1= | |p1= unit: [[Object]] |PARAMETER1= | ||
| [[Array]] - [[Unit Loadout Array]] | | | [[Array]] - [[Unit Loadout Array]] |RETURNVALUE1= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|s2= [[getUnitLoadout]] [unit, fullMagazines] | | |s2= [[getUnitLoadout]] [unit, fullMagazines] |SYNTAX2= | ||
|p21 = [unit, fullMagazines]: [[Array]] | | |p21 = [unit, fullMagazines]: [[Array]] |PARAMETER21= | ||
|p22= unit: [[Object]] | | |p22= unit: [[Object]] |PARAMETER22= | ||
|p23= fullMagazines: [[Boolean]] - [[true]] to top up used magazines| | |p23= fullMagazines: [[Boolean]] - [[true]] to top up used magazines|PARAMETER23= | ||
|r2= [[Array]] - [[Unit Loadout Array]] | | |r2= [[Array]] - [[Unit Loadout Array]] |RETURNVALUE2= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|s3= [[getUnitLoadout]] name | | |s3= [[getUnitLoadout]] name |SYNTAX3= | ||
|p41= name: [[String]] - class name (see description)| | |p41= name: [[String]] - class name (see description)|PARAMETER41= | ||
|r3= [[Array]] - [[Unit Loadout Array]] | | |r3= [[Array]] - [[Unit Loadout Array]] |RETURNVALUE3= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|s4= [[getUnitLoadout]] config | | |s4= [[getUnitLoadout]] config |SYNTAX4= | ||
|p61= config: [[Config]] - config class (see description) | | |p61= config: [[Config]] - config class (see description) |PARAMETER61= | ||
|r4= [[Array]] - [[Unit Loadout Array]] | | |r4= [[Array]] - [[Unit Loadout Array]] |RETURNVALUE4= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|x1= <code>[[getUnitLoadout]] [[player]];</code>|= | |x1= <code>[[getUnitLoadout]] [[player]];</code>|EXAMPLE1= | ||
|x2= <code>[[getUnitLoadout]] <nowiki>[</nowiki>[[player]], [[true]]];</code>|= | |x2= <code>[[getUnitLoadout]] <nowiki>[</nowiki>[[player]], [[true]]];</code>|EXAMPLE2= | ||
|x3= <code>[[getUnitLoadout]] "B_Soldier_F";</code>|= | |x3= <code>[[getUnitLoadout]] "B_Soldier_F";</code>|EXAMPLE3= | ||
|x4= <code>[[getUnitLoadout]] ([[configFile]] >> "CfgVehicles" >> "B_Soldier_F");</code>|= | |x4= <code>[[getUnitLoadout]] ([[configFile]] >> "CfgVehicles" >> "B_Soldier_F");</code>|EXAMPLE4= | ||
|x5= <code>[[getUnitLoadout]] ([[missionConfigFile]] >> "MyLoadout");</code>|= | |x5= <code>[[getUnitLoadout]] ([[missionConfigFile]] >> "MyLoadout");</code>|EXAMPLE5= | ||
| [[setUnitLoadout]]|SEEALSO= | | [[setUnitLoadout]]|SEEALSO= |
Revision as of 20:59, 9 April 2019
Description
- Description:
- Returns a Unit Loadout Array with all assigned items, weapons, containers and their stored items. When String for class name is supplied, the command will search CfgVehicles for the given class in order to extract the loadout from config. If Config is given, it will search given config (including mission config) for the loadout information. In either case, the config should contain the following entries, which is standard for any unit class, for example:
class MyLoadout { uniformClass = "U_B_CombatUniform_mcam"; backpack = "B_AssaultPack_mcamo"; linkedItems[] = {"V_PlateCarrier1_rgr","H_HelmetB","ItemCompass","ItemWatch","ItemRadio","NVGoggles"}; weapons[] = {"arifle_MX_ACO_pointer_F","hgun_P07_F"}; items[] = {"FirstAidKit","FirstAidKit","FirstAidKit"}; magazines[] = {"30Rnd_65x39_caseless_mag","16Rnd_9x21_Mag","SmokeShell","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade","HandGrenade"}; };
- Groups:
- Uncategorised
Syntax 1
- Syntax:
- getUnitLoadout unit
- Parameters:
- unit: Object
- Return Value:
- Array - Unit Loadout Array
Syntax 2
- Syntax:
- getUnitLoadout [unit, fullMagazines]
- Parameters:
- [unit, fullMagazines]: Array
- unit: Object
- fullMagazines: Boolean - true to top up used magazines
- Return Value:
- Array - Unit Loadout Array
Syntax 3
- Syntax:
- getUnitLoadout name
- Parameters:
- name: String - class name (see description)
- Return Value:
- Array - Unit Loadout Array
Syntax 4
- Syntax:
- getUnitLoadout config
- Parameters:
- config: Config - config class (see description)
- Return Value:
- Array - Unit Loadout Array
Examples
- Example 1:
getUnitLoadout player;
- Example 2:
getUnitLoadout [player, true];
- Example 3:
getUnitLoadout "B_Soldier_F";
- Example 4:
getUnitLoadout (configFile >> "CfgVehicles" >> "B_Soldier_F");
- Example 5:
getUnitLoadout (missionConfigFile >> "MyLoadout");
Additional Information
- See also:
- setUnitLoadout
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