1. copy "dialog" folder to mission folder
2. copy "stringtable.xml" to mission folder or copy the strings inside to your stringtable.xml
3. copy >> #include "dialog\outfit_gear\gear_main.hpp" << to "description.ext"
4. copy >> #include "dialog\outfit_gear\functions\functions.hpp" << to "class cfgFuntions" in description.ext
5. copy >> nul=['add',[this]] Spawn OG_fnc_Init << to init field of object in editor


NOTE: "gear_main.hpp" must be included in the description.ext before class CfgFunctions
NOTE: if changing folder paths must change literal constant "OG_FOLDERPATH" in "\outfit_gear\functions\defines_ctrl.hpp"

* the output loadout from the 'output button' can be used with 'OG_fnc_AddInventory' or take that function and execute it like a script
([&lt;unit&gt;] + &lt;loadout&gt;) Spawn OG_fnc_AddInventory

1. copy mod-folder(@outfit_gear) to "%userprofile%\Documents\Arma 3"
2. right-click Arma 3 in steam library, select properties, set launch options, add "-mod=@outfit_gear;"
OR
2. use mod launcher
3. actions appear on ammoboxes and ammotrucks

*move the file 'PA_outfit_gear_weaponholder.pbo' to addons folder in the mod-folder for a cheaty access of menu on any GroundWeaponHolder (unsigned)
*move the file 'PA_outfit_gear_inv_btn.pbo' to addons folder in the mod-folder for a cheaty access of menu from inventory screen (unsigned)

*you only need to define these if you want something other than default values
*blacklist/whitelist are specific to each client, initialize them on each client according to conditions for say different sides

VARIABLE ---- DEFAULT
OG_BLACKLIST ---- [] ---- array of prohibited classnames, the entire system enforces these (OG_BLACKLIST=["ItemMap"]//the map item is blocked)
OG_WHITELIST ---- [] ---- array of classnames that will ONLY work with the system (OG_WHITELIST=["ItemMap"]//only the map item will work)
OG_RESPAWN_LOADOUT ---- true ---- enable or disable respawn functionality

OG_CONFIG_ITEMS ---- [] ---- classnames of items as strings specifically placed under 'items' category
OG_CONFIG_MED ---- [] ---- classnames of items as strings specifically placed under 'medical supplies' category
*don't put same item in both arrays

*specific blacklist/whitelist for the object its actions are attached to, overrides OG_BLACKLIST/OG_WHITELIST
&lt;object&gt; SetVariable ['OG_BLACKLIST', []] // array of blacklisted classnames
&lt;object&gt; SetVariable ['OG_WHITELIST', []] // array of whitelisted classnames

*maximum loadouts capped at 500

&lt;unit GetVariable ['OG_loadout',[]] // loadout is saved locally to unit's namespace from loadout menu
([unit&gt;] + &lt;loadout&gt;) Spawn OG_fnc_AddInventory // loads loadout on to unit

*disable mod-version's actions globally - true:enabled:default, false:disabled
MissionNamespace SetVariable ['outfit_gear', &lt;bool&gt;]

*disable mod-version's actions on an object, overrides global - true:enabled:default, false:disabled
&lt;object&gt; SetVariable ['outfit_gear', &lt;bool&gt;, true]

_this select 0: type - (string)("add"/"remove"/"show"/"show_loadout")
_this select 1: parameters - (array)

0: object/objects - (object/array of objects)
1: distance action appears - (number)(default=10) (OBSOLETE: SupplyBoxes distance to objects is messed up)
2: action priority - (number)(default=4.0)
3: show window proximity - (bool)(default=false)
4: condition action appears - (string)(OPTIONAL) (_target=objectActionsAttached, _this=unitActivatingAction)
(EX: "Alive _target && IsPlayer _this")
default: target is alive/unit is player/not underwater/not pilot/copilot

["show"] Spawn OG_fnc_Init; // displays gear menu
["show",[&lt;object&gt;]] Spawn OG_fnc_Init; // displays gear menu for specified unit
["show_loadout"] Spawn OG_fnc_Init; // displays loadout menu
["show_loadout",[&lt;object&gt;]] Spawn OG_fnc_Init; // displays loadout menu for specified unit
["add",[&lt;object&gt;,Nil,10,true]] Spawn OG_fnc_Init;
["add",[[&lt;object&gt;,&lt;object&gt;],Nil,10,true]] Spawn OG_fnc_Init;
["remove",[&lt;object&gt;]] Spawn OG_fnc_Init;
["remove",[[&lt;object&gt;,&lt;object&gt;]]] Spawn OG_fnc_Init;

* you could also just use "CreateDialog 'outfit_gear';" or "CreateDialog 'outfit_gear_loadout';"
* assign unit to 'OG_UNIT_EQUIP' before opening if want other than player
* addAction snippet in 'readme.txt'

*sometimes adding grenades adds twice, 'AddItem' command is buggy with grenades
*ACRE: radio 'ACRE_PRC119' does not show up because its type property is 4, it should be type=131072 as that is the 'ItemCore' type
*ACRE: radio 'ACRE_PRC119' is added manually, but behaves strangely, can't assign directly, only can be added to a container
*you need to refresh the gear listbox a few seconds after adding a TF/ACRE radio because they add a new radio of a specific id
*closing dialog too fast will prompt script error if didn't finish populating listboxes, won't matter because dialog is destroyed anyway
*sometimes can't remove handgun you start with, bug with 'removeWeapon'

v1.016
*fixed not being able to add suppressors/pointers from accessory editor to inventory
*fixed black pictures in listboxes
*magazines can be added/removed to/from equipped weapon
*fixed accessory search button
*support for bipods
*updated ACRE2/TFAR/ACRE3 support

v1.015
* exporting loadouts as script/init/array/classname of unit
* importing loadouts have input validation
* every grenade/explosive of every throw/put muzzle now displayed
* fixed specific blacklist/whitelist always overriding global blacklist/whitelist
* weapons support multiple filters at a time
* item library description shows in the item description hint box
* added keyboard shortcuts
* every category gets own listbox for faster loading
* search/weapon filters saved for each category for mission duration
* clicking on gear pictures displays respective item category

v1.013-1.014
* new interface
* equipped gear listbox can increment/decrement counts of items
* merge weapons/items listbox
* merged accessory/magazines listbox
* camera of soldier used instead of PIP camera
* Authentic Gameplay Modification items under 'items' category
* faster loading of config
* blacklisting/whitelisting of items specific to the object actions are attached to
* side filter button only shows for the categories it affects

v1.012
* item pictures filepath corrected from game update
* export loadout functionality works with VR Arsenal loadouts
* import loadouts from export format
* X39_MedSys changed config of its items
* both dialog's work with curator as drag and drop modules
* glasses in unit's containers weren't loaded from saved loadout
* item config collected after mission starts rather than during loading screen
* two arrays for specifically placing items in 'items' category
* TFAR new radio backpacks show in 'radio' category

v1.011
* reworked weapon filters, now can be filtered by (ALL/GL/AMMO_COUNT/DAMAGE)
* customizable color text and background, default colors now based arma profile
* ammo count and hit values of magazine displayed in magazine listbox
* weapons with pre linked accessories are checked for there item strings rather than just 'LinkedItems' class
* TFAR/ACRE radios inherited base versions saved to loadout
* magazine/items/loadout_name textbox added keyDown event with 'return'/'numpad_enter' keys
* items can be filtered by name
* weapons combobox replaced with a toolbox control
* magazine listbox added shift/ctrl/alt-doubleclicking for different counts
* x39_medSys items and TFAR/ACRE radios have their own categories in items listbox
* added quick-select buttons for items listbox
* added button for quick equipping of map,compass,gps,watch
* overhauled interface
* max number of loadouts hard-coded at 500
* container items from a saved loadout didn't enforce the blacklist
* management of VR Arsenal loadouts
* insignia can be equipped, cleared, saved/loaded to/from loadout, and insignia in unit's namespace will always be used as default
* utility backpacks classified by 'AssembleInfo' subclass in addition to 'maximumLoad' and filter by side
* weight of items displayed as kilograms instead of config mass
* magazines with empty ammo counts are not displayed
* accessory editor supports all accessories defined as config entries in 'WeaponSlotsInfo'

v1.010
* improved compatibility with TaskForceRadio and ACRE, I don't use them, so didn't know updates broke functionality

v1.009
* percentage of load/maximumLoad displayed in tooltips of texts for each container
* equipped goggles, headgear, nvg, binocular displayed as pictures above container pictures
* loaded magazines in equipped weapons are displayed in 'Weapon Accessories' category
* two controls had the same IDC number
* 'forceAddUniform' used instead of 'addUniform' and notified if uniform is not allowed for current unit class
* remove weapons and magazines from individual containers
* can control double-click on the weapons, items, accessories listboxes to add them directly to inventory
* mod-version actions can be disabled with "&lt;object&gt; SetVariable ['outfit_gear',false]"

v1.008
* mod 'SpeedOfSoundv2' adds empty 'SmokeShell' class to CfgWeapons which messed up the priority of checking what class an item belongs to,
tweaked priority so CfgMagazines is checked before CfgWeapons
* side-filter button tooltip uses 'switch' statement to get localized side name based on unit's side property instead of 'side' command
* can remove handgun accessory from 'Weapon Accessories' filter
* backpacks and backpacks without cargo space (ie static weapons) are categorised seperately
* double-clicking in gear listbox while holding control key removes all counts of selected item
* new PIP camera of unit
* naked uniforms no longer appear in items listbox

v1.007
* magazine listbox used an old inefficient method of retrieving grenade shells for weapons with grenade launchers
* mod-version includes ammoboxes 'IG_supplyCrate_F' and 'C_supplyCrate_F'
* uniform, vest, and backpack load labels' width was too short

v1.006
* total load progress bar displays percentage of load in tooltip
* clear new backpack of items (some have stuff in them already)
* more efficient/intuitive code adding accessories to weapons
* MineDetector had an error in code with tooltip

v1.005
* new filtering method for weapons with a grenade launcher, doesn't rely on number of muzzles weapon has anymore
* item load and maxLoad now also displayed next to their containers
* accessory editor now supports ASDG_JointRails
* weapons config ignores all weapons with pre-equipped accessories for faster script loops
* selecting weapon populated accessory/magazine listbox twice

v1.004
* uniforms are now filtered by side of unit, toggled by button in title
* message is displayed if uniform's side is not same as player's side
* items display mass, maxLoad, and armor values
* container load progress bar displays load and maxLoad

v1.003
* items drop-down listbox now retains its selection
* fixed loadout menu uses correct loadouts if names are above '<NEW LOADOUT>'

v1.002
* fixed loadout menu not working if loadout names are above '&lt;NEW LOADOUT&gt;'
* more efficient config retrieval of grenade launcher shells
* magazine is automatically added for binocular weapons that have magazines (IE LaserDesignator)