Arma 2: Ambient Combat Manager - Functions
This page describes all pre-defined functions available to manipulate the settings of an Ambient Combat Manager (ACM).
Not all missions require heavy enemy / friendly presence. The ACM's intensity controls how many patrols can be active at a given time and how frequently patrols are spawned. The intensity can be controlled by using the following function call:
- intensity: Number - a Scalar between 0.0 and 1.0. 1.0 is the maximum intensity and 0.0 will in effect pause the ACM.
- module: Object - a reference to the ACM module itself, or a reference to any unit in the group the ACM is synchronized to.
Sets frequency and number of patrols (values 0-1). BIS_ACM is module name.
It is possible to control the minimum and maximum distance from the group leader at which enemies will be spawned. Be careful not to spawn too close, since it will be obvious to human players.
- Distances with the value -1 will leave the distance as it was.
- Distances with a value below -1 will reset to their defaults.
- The default values are 500 meters (minimum) and 1000 meters (maximum).
- Air patrols are currently excluded from these distances, since they generally require a much large area and they are not spawned on the ground.
Min & Max spawn distances included. BIS_ACM is module name.
You can control the skill levels of spawned units by defining a range from which a random value is selected for each unit. If you want a very specific value, simply make a range with both minimum and maximum set to that value.
Min & Max skill range for spawned units. BIS_ACM is module name.
Ammunition count range
You may define the ammunition count of spawned units by defining a range from which a random value is selected for each unit.
Amount of ammo spawned units possess. BIS_ACM is module name.
By default the ACM will select group types from CfgGroups, but you may want to use only a number of specific group types. You have the possibility of overriding the group type database with your own database, by using two functions.
Useable group types: Ambient Combat Manager - Group types
You are able to control which factions are spawned by the ACM.
// Arma 2 factions: "USMC", "CDF", "RU", "INS", "GUE" // Operation Arrowhead factions: "BIS_US", "BIS_CZ", "BIS_GER", "BIS_TK", "BIS_TK_INS", "BIS_TK_GUE", "BIS_UN", "BIS_TK_CIV", "BIS_CIV_special" // DLC/Reinforcements factions: "BIS_BAF", "PMC_BAF", "BIS_CZ" [factions, module] call BIS_ACM_setFactionsFunc;
Factions to be spawned. BIS_ACM is module name.
Certain areas of a map can be blacklisted as areas in which the ACM should not spawn units or place their waypoints (although their travel paths may cross these areas). There are a number of methods to define such areas.
You may place markers with a special naming pattern BIS_ACM_X (where X has to start at 1 and may not skip any numbers). The areas defined by these markers are automatically blacklisted and the markers deleted.
In some missions you may not want to use all patrol types, or use different chances for said patrol types. A custom pool of types and chances can be defined like so:
Type of patrol. With 0 meaning no chance of appearing, and 1 meaning 100% chance. -1 removes patrol type completely. BIS_ACM is module name.
For further discussion on the ACM: Official Forums thread.