getUnitLoadout: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
m (Remove syntaxhighlight spoiler hack)
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


|game1= arma3
|game1= arma3
|version1= 1.58
|version1= 1.58


|gr1= Unit Inventory
|gr1= Unit Inventory


|descr= 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:
|descr= Returns a '''[[Unit Loadout Array]]''' with all assigned items, weapons, containers and their stored items.
 
{{Feature|informative|
The config should contain the following standard entries: <spoiler>
<syntaxhighlight lang="cpp">
<syntaxhighlight lang="cpp">
class MyLoadout
class MyLoadout
Line 23: Line 25:
"HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade"
"HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade"
};
};
};</syntaxhighlight>
};
 
</syntaxhighlight>
{{Informative | Since {{arma3}} v1.92 an empty loadout could be obtained with <tt>[[getUnitLoadout]] ([[configFile]] >> "EmptyLoadout")</tt>}}
</spoiler>
 
}}


|s1= [[getUnitLoadout]] unit
|s1= [[getUnitLoadout]] unit
Line 32: Line 34:
|p1= unit: [[Object]]
|p1= unit: [[Object]]


|r1= [[Array]] - [[Unit Loadout Array]]
|r1= [[Array]] format [[Unit Loadout Array]]


|s2= [[getUnitLoadout]] [unit, fullMagazines]


|s2= [[getUnitLoadout]] [unit, fullMagazines]
|p21= unit: [[Object]]


|p21 = [unit, fullMagazines]: [[Array]]
|p22= fullMagazines: [[Boolean]] - [[true]] to top up used magazines


|p22= unit: [[Object]]
|r2= [[Array]] format [[Unit Loadout Array]]


|p23= fullMagazines: [[Boolean]] - [[true]] to top up used magazines
|s3= [[getUnitLoadout]] name


|r2= [[Array]] - [[Unit Loadout Array]]
|p41= name: [[String]] - {{hl|CfgVehicles}} classname from which to extract the loadout


|r3= [[Array]] format [[Unit Loadout Array]]


|s3= [[getUnitLoadout]] name
|s4= [[getUnitLoadout]] config


|p41= name: [[String]] - class name (see description)
|p61= config: [[Config]] - loadout config class


|r3= [[Array]] - [[Unit Loadout Array]]
|r4= [[Array]] format [[Unit Loadout Array]]


|x1= <sqf>getUnitLoadout player;</sqf>


|s4= [[getUnitLoadout]] config
|x2= <sqf>getUnitLoadout [player, true];</sqf>


|p61= config: [[Config]] - config class (see description)
|x3= <sqf>getUnitLoadout "B_Soldier_F";</sqf>


|r4= [[Array]] - [[Unit Loadout Array]]
|x4= <sqf>getUnitLoadout (configFile >> "CfgVehicles" >> "B_Soldier_F");</sqf>


|x1= <code>[[getUnitLoadout]] [[player]];</code>
|x5= <sqf>getUnitLoadout (missionConfigFile >> "MyLoadout");</sqf>
|x2= <code>[[getUnitLoadout]] [<nowiki/>[[player]], [[true]]];</code>
|x3= <code>[[getUnitLoadout]] "B_Soldier_F";</code>
|x4= <code>[[getUnitLoadout]] ([[configFile]] >> "CfgVehicles" >> "B_Soldier_F");</code>
|x5= <code>[[getUnitLoadout]] ([[missionConfigFile]] >> "MyLoadout");</code>


|seealso= [[setUnitLoadout]]
|seealso= [[setUnitLoadout]]
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<!-- BEGIN Note Section -->
<!-- END Note Section -->
</dl>
<h3 style="display:none">Bottom Section</h3>
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma3|New Scripting Commands}}

Latest revision as of 13:44, 23 June 2023

Arma 3 logo black.png1.58
Hover & click on the images for description

Description

Description:
Returns a Unit Loadout Array with all assigned items, weapons, containers and their stored items.
ⓘ
The config should contain the following standard entries:
Groups:
Unit Inventory

Syntax 1

Syntax:
getUnitLoadout unit
Parameters:
unit: Object
Return Value:
Array format Unit Loadout Array

Syntax 2

Syntax:
getUnitLoadout [unit, fullMagazines]
Parameters:
unit: Object
fullMagazines: Boolean - true to top up used magazines
Return Value:
Array format Unit Loadout Array

Syntax 3

Syntax:
getUnitLoadout name
Parameters:
name: String - CfgVehicles classname from which to extract the loadout
Return Value:
Array format Unit Loadout Array

Syntax 4

Syntax:
getUnitLoadout config
Parameters:
config: Config - loadout config class
Return Value:
Array format Unit Loadout Array

Examples

Example 1:
Copy
getUnitLoadout player;
Example 2:
Copy
getUnitLoadout [player, true];
Example 3:
Copy
getUnitLoadout "B_Soldier_F";
Example 4:
Copy
getUnitLoadout (configFile >> "CfgVehicles" >> "B_Soldier_F");
Example 5:
Copy
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
Retrieved from "https://community.bistudio.com/wiki?title=getUnitLoadout&oldid=341789"