Author: Belbo
Author Website:

Requirements: Microsoft .NET Framework 4

Version: 2.0.1

Short description: This is a small gear distribution script

Date: 2014-08-03 10:13

Comments: (0)


ADV Gear Distribution


I've played a lot of missions with either buggy or performance demanding gear distribution scripts or systems.
Some switch to Tonic's VAS because of that, but I personally don't really like using it in my missions (it's a great script though, no questions asked!). That's why I created this little script (pretty much for my own use).
But as requested I make this public and offer you my little gear distribution script.
As of version 2.0 the ADV Gear Distribution system comes with an executable file that creates all the necessary scripts for you. This is the ADV Gear Configurator made by Joko.
The script version is put into the download file as well, if you want to have a look at how the system works. (Or even create your loadouts without the ADV Gear Setup. It's highly recommended though.)

- combines playable units in classes
- every class gets their predefined loadout
- loadouts completely customizable
- script output all in all just ~70kB (with loadouts for 8 units)
- JIP-compatible
- compatible with AGM (You can define agm-items separately. They will be added to the loadout if AGM is active.)
- creating loadouts has never been easier thanks to the ADV Gear Configurator (made by Joko)!

It might be a bit tricky in the beginning, but the reward is a set-up-and-forget loadout script that doesn't put much weight on your mission and does not require you to add each and every magazine.

Installation / Usage:
There's a sample mission included with a prewritten loadout script. Just take a look at it to know how this script and the ADV Gear Setup-Configurator work.

1. Copy the ADV Gear Setup.exe to a folder of your choice and launch it. Click on "Create Script". After that it pretty much does most of the work for you.
If you want to create loadouts only, click on "Loadout Editor".

2. Select your mission folder and hit "Ok". If you want to have players respawn with their custom loadouts every time, select the box "Respawn with custom loadouts". Without that you should use another gearsaving script.
After that click on "Create initPlayerLocal.sqf". If you already have on, it will just add the necessary call to the end of your initPlayerLocal.sqf. You might check if that's right for your mission.

3. Click on "Create adv_fnc_gear.sqf" and on "Create loadoutsInit.sqf" afterwards. With these clicks you basically created the necessary files for adding the loadouts you're creating in the next steps.
But first you have to select the amount of different playable units you have in your mission and enter their unit names. Add the playable unit's names under "Unit names". Make sure they're in quotation marks
and separated by commas, without a comma at the end.
(eg. "player1","player2").
"Script name" defines the names of the sqf-files your loadouts will be saved as. "Type of unit" is for your own good. That way you can keep track which units belong to which category. If you're done, hit "Done".

4. Now, and after a click on "Create loadouts", you can create your loadouts. You can either select items from the drop down menus or enter your own classnames. Don't put them in quotation marks, except for those in
the tab "Other". By clicking on "Info" you'll get information on the expected format for (almost) each entry.
If you're done with your first loadout, just click on "Save Configuration" and then on "Next loadout" - as long as there are loadouts you need to create. If you have created all loadouts, just close the application
and you're good to go.
If you're not too keen on creating a loadout from the scratch and want to see how it's being done, you can open one of the prefabs contained in ADV_Gear_Prefabs\ to try one of the prefabricated loadouts. You can
save your loadouts as prefab-files as well if you want to.
For editing the loadouts, just take a look at ADV_gear\loadouts\. There you'll find all the loadouts you have just created according to the preferences you set in step 3. Even within the sqf-files it's
easy as pie to edit the loadouts. Just try it for yourself.
5. Have fun and don't boss your players around too much!

Known issues:
If you want to submit bugs in ADV Gear Setup.exe, you can do it either here or on

Change log:
- Minor bugfixes in ADV Gear Setup.exe

- Major update. ADV Gear Setup.exe is now doing all the work for you. Creating loadouts has never been easier and less demanding for your missions.
- Removed BWmod-Navpad-compatibility. Otherwise it would add the navpad to your loadout even if you were playing an Afghan tribal fighter as long as BWmod was running.

- fixed error with Chemlights. Wrong classnames in adv_fnc_gear.sqf

- added prefabs to ADV Gear Configurator. Now you can load and save preconfigured loadouts.
- additionally some little changes were made to ADV Gear Configurator-netcode.

- added goggles to loadouts.
- reworked adding of medical items.
- reworked adv_fnc_gear.sqf.
- brought look of unitCat*.sqf in line.
- added ADV_Gear.exe (thanks to Joko!)
- changed ReadMe accordingly.

- removed issue with 40mm-grenades caused by spelling error.

- small change to the 40mm-section.

- reworked unitCat*.sqf-structure and adv_fnc_gear.sqf in preparation for the upcoming GUI-tool.

- refined some issues with order of adding linked items in ADV_fnc_gear.sqf
- added compatibility with FHQ M4 pack and Massi's Nato/Russian Weapon Pack.
- removed some custom items from ADV_fnc_gear.sqf that could return errors when AGM is active.
- reworked the example mission for checking the respawn function.
- added respawnWithGear-variable to arguments that are passed to loadoutsInit.sqf.

- Initial release

Forums Topic:
- BI Forums

(only required for the ADV Gear Configurator, the script can work without it)
- Microsoft .NET Framework 4

Enable javascript to be able to download from Armaholic please!

Tags: Gear,   Inventory,   Loadouts