Author: Alexander (ImperialAlex)
Author Website:

Requirements: No addons required

Version: 3.1.1
Signed: Yes, server key included

Short description: A tiny mod that adds support for composite weapons to whitelisted arsenals.

Date: 2015-05-24 16:31


Comments: (4)
Rating:



 



XLA FixedArsenal

by
Alexander (ImperialAlex)


Description:
This is a mod for Arma3. This mod improves the way the virtual arsenal works when using 'whitelisting' mode. The 'white listing' feature of the (vanilla) arsenal allows scripters to determine what items are or are not available. However, the vanilla white-listing has a few issues. E.g. by default, saved outfits that contain non-whitelisted equipment cannot be loaded. This mod introduces partial loading, i.e. loading all whitelisted parts of a saved outfit. It also includes fixes and improvements related to the white-listing feature.

Partial Loading
Partial Loading means that outfits that contain non-whitelisted or non-existing (classname not found) items can still be loaded, but any item that is non-whitelisted/not found will be skipped.
If the non-whitelisted item is a uniform, backpack or vest, the currently equipped uniform,backpack or vest (respectively) will be kept.
Outfits that contain non-available (either due to classname-not-found or non-whitelisted) will be highlighted in the virtual arsenal's "load" view.

white = outfit is loadable in its entirety.
yellow = at least one non whitelisted item
orange = at least one non existing class (i.e. wrong classname or mod not loaded)
N.B: orange will take precedence over yellow if both apply

Better Performance
When opening the "load" menu in a whitelisted arsenal each item in each outfit has to be checked against the whitelist.
This was done in a way where the whitelist was always traversed in its entirety. In this mod, the search stops once the item has been found.

Semantics Change
Apart from the indirect changes induced by partial loading, a deliberate change was made to the semantics of white listing.
In the vanilla arsenal (and previous versions), any item currently equipped by the soldier was automatically available in the arsenal.
(Effectively, the white-list was computed as the white list + any current equipment the soldier had).
The vanilla semantics have two effects: Firstly, it allows players to duplicate items like grenades even if they are not part of the white-list.
Secondly, it makes it hard for players and mission designers to predict what items will be available when a certain player visits the arsenal.
The mod resolves both of these issues by making the arsenal ignore player's current equipment.

Composite Weapons
This mod introduces proper support for composite weapons, i.e. weapons that have things pre-attached.
(effectively a one-line change, fixing #20978


Installation:
Extract into the ArmA 3 Directory, by default this is located in:
32-Bit - C:\Program Files\Steam/Steamapps\Common\ArmA 3\
64-Bit - C:\Program Files (x86)\Steam/Steamapps\Common\ArmA 3\
After extraction it should look like this:
Steam\Steamapps\Common\ArmA 3\@your_mod_folder_name\addons\

You can also use the "Arma 3 Alpha" folder in your "My Documents" folder. Your folder setup could than look like for example this:
mydocuments\Arma3 Alpha\@your_mod_folder_name1\addons\
mydocuments\Arma3 Alpha\@your_mod_folder_name2\addons\
mydocuments\Arma3 Alpha\@your_mod_folder_name2\addons\

When present place the "userconfig" folder into your game install folder, usually:
"C:\Program Files (x86)\Steam\steamapps\common\Arma 3".
You may already have "userconfig" folder from other addons and/or mods in which case it is safe to merge the contents from this archive.

You'll also need to add a Launch Parameter to Steam, in order to do so right-click on ArmA 3 Alpha and click Properties and then Set Launch Options. In the window that opens enter in -mod=@your_mod_folder_name
For using multiple mods you would then do so like this:
-mod=@mod_name;@mod_name2;@mod_name3;@mod_name4;@mod_name5

Note:
You can also use -nosplash to get rid of the splash art and intro videos.


And of course you can also enable and disable community made addons and mods through the in-game Options Expansions menu if you do not want to mess with startup parameters!

When the above information still does not provide you with enough to learn how to install custom addons and mods you can always ask in our Guide On Installing Mods.


Included files:
xla_fixedarsenal.pbo


Steam Workshop:
- Subscribe


Changelog:
v3.1.1
- HOTFIX to remove some debug output

v3.1.0
- add/remove from white/blacklist now properly updates the ammobox white/blacklist
- force-replace is now also used on loading an outfit and on import of an outfit
- added an example of how to fall-back to vanilla

v3.0.1
- This update re-works the faulty config definitions that led to compatibility issues with e.g. lock-on-launchers from other mods.

v3.0.0
This update includes some major refactoring that should improve the performance of whitelisted arsenals significantly.
Most filtering (the thing that made whitelisting slow) now happens only once, during the "preload" (when the loadscreen is visible). This is done at virtually the same speed as the normal (no whitelisting) loading!
There is still a tiny bit of a delay when selecting a weapon (rifle/launcher/pistol) because the arsenal needs to calculate the allowed magazines for each weapon.

The release also introduces the ability to define lists of "force-replacements", i.e. items that should be replaced with another specified item when the user first opens the arsenal (mostly intended for TFAR/ACRE radios).

With the re-worked "preload" a slight change in the way some (advanced) features of the arsenal work had to be changed -- "preload" calls now need to be made on a per-box level. As a bonus you can now also supply a list of classnames to override "scopeArsenal" checks in the preload (force-add items to the arsenal).

v2.1.0
Support for #bipods (merged 1.42 vanilla improvments)
Fix small error in sample mission
additional optional parameter for xla_fnc_removeVirtual... functions

v2.0.3
- fixes the behaviour of the "%ALL" tag
- improves (hopefully) handling of composite weapons

v2.02
- Fixes an issue with "side whitelisting". Resolves "All VAs in Showcase mission are empty".

v2.01
- HOTFIX for CfgGlasses + conditions now case-IN-sensitive

v2.0.0
- updated it to be @ASDG compatible
- include updates to the arsenal made in 1.38/1.40
- generally cleaned up the codebase
- this now also has "side" and "blacklisting"

v1.4
- Fixed addAction added by addVirtual...Cargo
- Improved feedback for players when trying to load non-available items
- Removed *.rpt spam caused by loading non-available items.

v1.3
- Various fixes with items not loading as expected. (Gear belt items, default magazines, etc) - Thanks to Pundra, Flipped and Midnight for reporting bugs!
- Dramatically decreases the time it takes to load/open the "LOAD"/"SAVE" menu.

v1.2
- Added support for partial loading. You can now load (whitelisted parts of) saved outfits that contain non-allowed items.
- Changed whitelisting behaviour: Player inventory is no longer added to the whitelist.

v1.1
- first release


Forum topic:
- BI forums




Enable javascript to be able to download from Armaholic please!



Tags: Arsenal,   Workaround