README
======

Addon: asr_vfai
Version: 0.96 beta
Developer(s): Robalo [AS], Victor Farbau
Description: 
This addon enables AI units to equip themselves with weapons and ammo.
This is a remake of Victor Farbau's VFAI.Equipment addon which he released as public domain.

Rearming AI Features:

- Take what's needed from about anywhere possible: crates, vehicles, stuff dropped on the ground, dead soldiers and their backpacks.
- Also rearming from their own backpack or from another (alive) AI's pack in the group.
- Equip with primary weapons, launchers and sidearms, ammo, frag grenades, smoke grenades.
- Take rocket launchers if not carrying a rucksack (OA or ACE) or the primary weapon is a sniper rifle, machinegun or automatic rifle.
- Grab a little extra ammo when using specialist weapons (sniper, MG, AR) since they won't take a launcher.
- Will only take items when there's space for them in the inventory unless the items are important (launcher ammo or medic kits).
- Will try and grab all useful items found in a place on a single run.
- Do not rearm if any of these conditions is met: option globally disabled / unit is: busy doing something / in a vehicle / captive / hiding / in combat / unconscious
- Units rearm even while in combat if they have no weapons to fight with (unless they're commanded to stay put).
- Configurable options can also be set at the beginning or during the mission by changing the global variables (turn rearming on/off or allow civilians to rearm etc.)
- Some options can also be set in game using the comms menu (0-8).

ACE mod features (auto-enabled when ACE mod is active)
- Also grab extra frags and smokeshells found in ACE.
- Rearming from own ACE backpacks or other AI's packs in the group.
If the ACE Wounding module is active:
- Take bandages. Medics will also take Epi and Morphine.
- Rearm from unconscious units.

This addon can be installed on clients, servers or both. It will configure only the AI local to the machine where it is installed.



README CONTENTS
===============

01. VERSION HISTORY
02. COPYRIGHT STATEMENT
03. TERMS OF USE
04. LEGAL DISCLAIMER
05. INSTALLATION
06. REQUIRED ADDONS
07. NOTES
08. CHANGE HISTORY
09. THANKS


01. VERSION HISTORY
===================

0.96 | 19 OCT 2010 | Bugfix. See change history.
0.95 | 11 OCT 2010 | Bugfixes, features and optimizations. See change history.
0.94 | 10 OCT 2010 | Features and optimizations. See change history.
0.93 | 07 OCT 2010 | Readme file added. More features and optimizations. See change history.
0.92 | 04 OCT 2010 | Features and optimizations. See change history.
0.91 | 03 OCT 2010 | Features and optimizations. See change history.
0.90 | 02 OCT 2010 | First release

02. COPYRIGHT STATEMENT
=======================

(c)[ 2010 ] Robalo [AS]. All rights reserved.



03. TERMS OF USE
================

This addon (hereafter 'Software') contains files to be used in the PC CD-ROM simulator "Armed Assault 2" (hereafter 'ArmA2'). To use the Software you must agree to the following conditions of use:

1. Robalo [AS] (hereafter 'The Author(s)') grant to you a personal, non-exclusive license to use the Software.

2. The commercial exploitation of the Software without written permission from The Author(s) is expressly prohibited.



04. LEGAL DISCLAIMER
====================

The Software is distributed without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. The Software is not an official addon or tool. Use of the Software (in whole or in part) is entirely at your own risk.



05. INSTALLATION
================

To begin using the Software:

1. Copy the .pbo and .bisign files to a mod (addon folder) and launch the game with that mod loaded. For more information about addon folders please check BIS Wiki here:

http://community.bistudio.com/wiki/Addons#ArmA_2

2. Copy the content of userconfig to a folder named userconfig in your main Arma2 folder.
Users can customize the addon's parameters by editing the file config_airearming.hpp that should be located in <main Arma2 folder>\userconfig\asr\



06. REQUIRED ADDONS
===================

The CBA mod is required, it can be found at this address: http://dev-heaven.net/wiki/cca


07. NOTES
=========

Comments and suggestions are welcome. 
Addon thread at BIS forums: http://forums.bistudio.com/showthread.php?t=108558


08. CHANGE HISTORY
==================

0.96 | 19 OCT 2010
Mags were not properly counted for some weapons (specifically for rifles with GL, when used with ACE or with ASR Grenadier fix addons).

0.95 | 11 OCT 2010
Fixed a couple of bugs that prevented rearming in some situations.
AI can now rearm from own ACE pack or another alive AI's ACE pack in the group.
Visiting field hospitals for supplies too.

0.94 | 10 OCT 2010
Medics do not pick up launchers anymore.
Heavy launchers will only be picked up by respective specialists or units that start with them.
AI can now take magazines from own OA backpack or another (alive) AI's pack in same group.

0.93 | 07 OCT 2010
Performance tweaks - the full inventory check is done less often, 30-60 seconds for AI with a player in their group, 2-3 minutes otherwise.
Quick checks are done more often, each 10-20 seconds, if for example a unit needs a primary weapon.
Prevent units from moving to grab stuff out of the water.
Communications submenu that can be used to toggle rearming on/off. More options to be added there in the future.

0.92 | 04 OCT 2010
Ammo that goes into primary or secondary slots is handled separately. This means AI with a rifle GL will also grab GL ammo when found.
When looking for a weapon because the current one is empty, don't pick up same weapon

0.91 | 03 OCT 2010
Extra muzzle magazines are now also counted for primary weapons - means the AI might grab GL rounds as well.

0.90 | 02 OCT 2010
First release


09. THANKS
==================
Victor Farbau for creating the original VFAI.Equipment addon and permission to modify his work, his gesture was the kickstart for this addon.
AlphaSquad team members for testing and sharing years of gaming fun.
BIS forum members that tested and provided constructive feedback.
BIS for making the best games.
