Arma 2: Ambient Civilians

From Bohemia Interactive Community
Jump to navigation Jump to search

Ambient Life In Civilian Environment (ALICE) is a system for populating towns with civilian units and simulating their common life.


Initialization

Paths

Editor:

Modules (F7) > Ambient Civilians

Data:

ca\modules\alice

Startup

Place ALICE manager on map. No additional synchronizing needed.

Optional parameters

General Variables

  • townlist = <array>; - list of places where civilians will be spawned. Can be location logic (created by BIS_fnc_locations), array in format [center, distance] or trigger.
Example:
this setVariable ["townlist", [bis_loc_acityc_mogilevka, [position this, 3000], trigger1]];
Default value: Whole island.
  • spawnDistance = <number>; - distance of player(s) to town logic (in metres) in which system is starting to spawn civilians.
Example:
BIS_alice_mainscope setVariable ["spawnDistance", 800];
Default value: 1000
  • civilianRarity = <array>; - Changing civilian rarity numbers (e.g. to have villagers spawned in cities, or to disable spawning of given class completely with unusual number like 10). Default rarity numbers are set in config under rarityUrban value (in range from 0/village to 1/city)
Example:
BIS_alice_mainscope setVariable ["vehicleRarity", ["Citizen1", 10, "Worker2", 0.8]];
Default value: []
  • civilianCount = <string>; - formula on which basis system calculates number of civilians for locations. %1 is number of buildings with door (memory points called "AIDoor1", "AIDoor2", ...) in 500 metres from location.
Example:
BIS_alice_mainscope setVariable ["civilianCount", "round (%1 / 10)"];
Default value (and recommended): "round (2 * (sqrt %1))"
  • civilianActions = <array>; - list of action categories from CfgCivilianActions
Example:
BIS_alice_mainscope setVariable ["civilianActions", ["BIS", "CSLA"]];
Default value: ["BIS"]
  • respectModifyCoef = <number>; - artificial coeficient to set how much will be town's respect decreased once some civilian is hit or killed. The higher the number is, the more is respect towards killer's faction decreased.
Example:
BIS_alice_mainscope setVariable ["respectModifyCoef", 0.2];
Default value: 0.7
  • threatDecay = <number>; - value which is removed from town threat every 5 seconds (until threat reaches 0)
Example:
BIS_alice_mainscope setVariable ["threatDecay", 0.05];
Default value: 0.033
  • ALICE_civilianinit = <array>; - array of codes which is executed upon every civilian unit created.
Example:
[BIS_alice_mainscope, "ALICE_civilianinit", [{ _this addweapon "Mk_48" }]] call BIS_fnc_variableSpaceAdd;
(use function BIS_fnc_variableSpaceAdd to prevent replacing currently existing codes)
Default value: none

Location Variables

  • ALICE_forcePopulation = <boolean>; - set to true if you want to populate town even without players' presence.
Example:
BIS_loc_acityc_kozlovka setVariable ["ALICE_forcePopulation", true];
Default value: false
  • ALICE_populationCoef = <number>; - coeficient to tell system what amount of civilians will be outside doing some action. 0.5 means 50% of civilians will be outside.
Example:
BIS_loc_acityc_kozlovka setVariable ["ALICE_populationCoef", 1];
Default value: around 0.6
  • ALICE_civilianinit = <array>; - array of codes which is executed upon every civilian unit created.
Example:
[bis_loc_acityc_kozlovka, "ALICE_civilianinit", [{ _this addweapon "Mk_48" }]] call BIS_fnc_variableSpaceAdd;
(use function BIS_fnc_variableSpaceAdd to prevent replacing currently existing codes)
Default value: none

Stored variables

Variables stored in town logics

  • "ALICE_population" = <array>; - list of all civilians in town
  • "ALICE_populationActive" = <array>; - list of all active civilians in town (e.g. civilians who are outside)
  • "ALICE_populationCountDef" = <number>; - initial number of civilians (is reset when someone leaves the town)
  • "ALICE_threat" = <number>; - threat level of town (-1 = not yet populated; 0 = safe; >0 = danger, where 0-1 is just suspicion and values higher than 10 are beginning to be extreme).

It seems that threat refers to how threatened the civilians feel by troops. Civilian behaviour changes when the fear increases (for example, I think they don't drive cars when they are fearful)

  • "ALICE_status" = <string>; - status category ("black" = inactive, "green" = threat on 0, "red" = threat > 0)


Functions

BIS_ALICE_fnc_civilianSet

Description: Sets basic ALICE values for civilian unit. Since then, unit will start to behave according to ALICE behavior pattern.

Params:

  • _this select 0 - OBJECT or ARRAY - Civilian or [group, class] to create new unit
  • _this select 1 - OBJECT (Optional) - Town logic (if nothing is set, nearest one is found)
  • _this select 2 - OBJECT (Optional) - Invisible door (if nothing is set, random one in town are selected)

Returned value: true