bonz_UnitLoadout

This is the Bonz Characters Unit Loadout.
It enables an admin or a GM to set a loadout on dummy units.
Then every player can come and chose it's specific loadout.
It is persistent between server restarts.

WIP - Use at your own risk.... Better not to though.

(Be smart : test it before you use it on your official server...)

HOW TO USE IT
-------------

AS A PLAYER - TO EQUIP YOURSELF WITH THE SAME LOADOUT AS A BONZ LOADOUT UNIT
 1- Approach a "Bonz Loadout Unit", and select the user action "Get this loadout ..."
    This will copy the layout of the "Bonz Loadout Unit" on you.
    Attention : Sometimes the loadout does not create every piece of equipments, so check your equipment and retry once more if necessary.


AS A GAME MASTER (or ADMIN) - TO APPLY A LOADOUT TO A BONZ LOADOUT UNIT
 1- Spawn a "Bonz Loadout Unit" from the Entity Browser.
 2- Then, with any other unit, approach the Bonz Loadout Unit and select the user action "Save my loadout on this unit"
    This will apply your loadout on the Bonz Loadout Unit, and make it available for every other players.
 3- You can change the loadout whenever you want.


IN THE WORKBENCH - TO CREATE A "BAKED" BONZ LOADOUT UNIT
 1- Override {375EBC414872B4DB}Configs/bonz/UnitsLoadoutList.conf
    This is the config file of this mod
    where you can register pre-defined loadouts as Loadout Strings.

 2- Create units on your map by using the Prefab "E_bonz_UnitLoadout.et"
 
 3- Play your map in the World Editor as Game Master
    + With any other units, approach the Bonz Loadout Unit
       and select the user action "Save my loadout on this unit"
      This will apply your loadout on the Bonz Loadout Unit.
    + Display the loadout string of the unit by chosing the user action "Show the loadout string"
    + Copy-paste the loadout string in a text file
    
    + Repeat that for every loadout you want to prepare.
    
    + finally end the played game

 4- Remove the database that was automatically created when you played the map 
    It's usually here : "<Documents>\My Games\ArmaReforgerWorkbench\profile\.db\"
        Remove the directory "BonzUnitLoadouts"
    Otherwhise, at restart, it will reload the last loadouts used.
     
 5- Now, in the config file you overrode : "UnitsLoadoutList.conf"
    + Add lines to the "Tab Units Loadouts"
    + And complete them with the Name of the loadouts and the Loadout-Strings you copied in your text file.
    + For use as an example, ther is already a "Naked" loadout defined in this config file.
    
 6- Finally, create all the "Bonz Loadout Units" you need on your map by using the Prefab "E_bonz_UnitLoadout.et".
    And on each one, assign a loadout by setting the name of the loadout in the component "bonz_UnitLoadoutComponent",
    in the field "Loadout Name".

If your units are persistent, or created from a GameMaster save game, it should still work.
In the workbench, if you move your units, they might lose their loadout.

Other technical infos :
- The database is in the database directory of your server, in the sub-directory "BonzUnitLoadouts"
- The persistence is based on the position of the unit. It is checked every 20 sec.
- Every five minuts, the unused records in the database are erased.


Please enjoy and don't rage if it doesn't work as wanted the first time.
Look at the example world available with this mode.
Also, be smart, and test it before you use it officially on you server.

Have a nice day.
Hycann - 14e Gaming