Ambient Civilians – Arma 2

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " (={2,})([^ = ])(.*)([^ = ])(={2,}) * " to " $1 $2$3$4 $5 ")
m (Remove custom section based on an unavailable mission template file)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{GameCategory|arma2|Editor Modules}}
{{TOC|side}}
'''Ambient Life In Civilian Environment (ALICE)''' is a system for populating towns with civilian units and simulating their common life.
 
 
== Initialization ==


'''Ambient Life In Civilian Environment (ALICE)''' is system for populating towns with civilian units and simulating their common life.
== Initialization==
=== Paths ===
=== Paths ===
Editor:
Editor:
  Modules (F7) > Ambient Civilians
  Modules (F7) > Ambient Civilians
Line 10: Line 13:


=== Startup ===
=== Startup ===
Place ALICE manager on map. No additional synchronizing needed.
Place ALICE manager on map. No additional synchronizing needed.


=== Optional parameters ===
=== Optional parameters ===
==== Set variables to BIS_alice_mainscope with desired values ====
*'''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.
==== General Variables ====
::Example: ''BIS_alice_mainscope setvariable ["spawnDistance",800];''
* '''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.
::Default value: 1000
:: Example: <sqf>this setVariable ["townlist", [bis_loc_acityc_mogilevka, [position this, 3000], trigger1]];</sqf>
 
:: Default value: Whole island.
*'''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)
* '''spawnDistance = <number>;''' - distance of player(s) to town logic (in metres) in which system is starting to spawn civilians.
::Example: ''BIS_alice_mainscope setvariable ["vehicleRarity",["Citizen1",10,"Worker2",0.8]];''
:: Example: <sqf>BIS_alice_mainscope setVariable ["spawnDistance", 800];</sqf>
::Default value: []
:: 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)
*'''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: <sqf>BIS_alice_mainscope setVariable ["vehicleRarity", ["Citizen1", 10, "Worker2", 0.8]];</sqf>
::Example: ''BIS_alice_mainscope setvariable ["civilianCount","round (%1 / 10)"];''
:: Default value: []
::Default value (and recommended): "round (2 * (sqrt %1))"
* '''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: <sqf>BIS_alice_mainscope setVariable ["civilianCount", "round (%1 / 10)"];</sqf>
*'''civilianActions = <array>;''' - list of action categories from CfgCivilianActions
::Default value (and recommended): "round (2 * (sqrt %1))"
::Example: ''BIS_alice_mainscope setvariable ["civilianActions",["BIS","CSLA"]];''
* '''civilianActions = <array>;''' - list of action categories from CfgCivilianActions
::Default value: ["BIS"]
:: Example: <sqf>BIS_alice_mainscope setVariable ["civilianActions", ["BIS", "CSLA"]];</sqf>
 
:: 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.
* '''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];''
:: Example: <sqf>BIS_alice_mainscope setVariable ["respectModifyCoef", 0.2];</sqf>
::Default value: 0.7
:: Default value: 0.7
 
* '''threatDecay = <number>;''' - value which is removed from town threat every 5 seconds (until threat reaches 0)
*'''threatDecay = <number>;''' - value which is removed from town threat every 5 seconds (until threat reaches 0)
:: Example: <sqf>BIS_alice_mainscope setVariable ["threatDecay", 0.05];</sqf>
::Example: ''BIS_alice_mainscope setvariable ["threatDecay",0.05];''
:: Default value: 0.033
::Default value: 0.033
* '''ALICE_civilianinit = <array>;''' - array of codes which is executed upon every civilian unit created.
 
:: Example: <sqf>[BIS_alice_mainscope, "ALICE_civilianinit", [{ _this addweapon "Mk_48" }]] call BIS_fnc_variableSpaceAdd;</sqf>
*'''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)'''
::'''(use function [[BIS_fnc_variableSpaceAdd]] to prevent replacing currently existing codes)'''
::Default value: none
:: Default value: none


==== Set variables to town logic with desired values ====
==== Location Variables ====
*'''ALICE_forcePopulation = <boolean>;''' - set to true if you want to populate town even without players' presence.
* '''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];''
:: Example: <sqf>BIS_loc_acityc_kozlovka setVariable ["ALICE_forcePopulation", true];</sqf>
::Default value: false
:: 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.
*'''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: <sqf>BIS_loc_acityc_kozlovka setVariable ["ALICE_populationCoef", 1];</sqf>
::Example: ''BIS_loc_acityc_kozlovka setvariable ["ALICE_populationCoef",1];''
:: Default value: around 0.6
::Default value: around 0.6
* '''ALICE_civilianinit = <array>;''' - array of codes which is executed upon every civilian unit created.
 
:: Example: <sqf>[bis_loc_acityc_kozlovka, "ALICE_civilianinit", [{ _this addweapon "Mk_48" }]] call BIS_fnc_variableSpaceAdd;</sqf>
*'''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)'''
::'''(use function [[BIS_fnc_variableSpaceAdd]] to prevent replacing currently existing codes)'''
::Default value: none
:: Default value: none


=== Stored variables ===
=== Stored variables ===
==== Variables stored in town logics ====
==== Variables stored in town logics ====
*'''"ALICE_population" = <array>;''' - list of all civilians in town
* '''"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_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_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).
* '''"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)
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)
* '''"ALICE_status" = <string>;''' - status category ("black" = inactive, "green" = threat on 0, "red" = threat > 0)
 


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


'''Params:'''
'''Params:'''
*_this select 0 - OBJECT or ARRAY - Civilian or [group,class] to create new unit
* _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 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)
* _this select 2 - OBJECT (Optional) - Invisible door (if nothing is set, random one in town are selected)


'''Returned value:''' true
'''Returned value:''' true


== Good simple things ==
==== More civilians driving ====
[http://freeweb.t-2.net/McHide/Missions/Sample_MoreDriving.Chernarus.7z Download sample mission]


'''In your mission you will need:'''
{{GameCategory|arma2|Editor Modules}}
 
*'''''CUSTOM_NAMED_Civil_Actions.HPP'''''
*'''''description.ext'''''
<pre>
// On top of description file include your custom civilian actions
// Note that file name must be correct or your PC will CTD on mission start!
#include "CUSTOM_NAMED_Civil_Actions.HPP"
</pre>
*'''''Alice Module'''''
<pre>
// Note that you need bigger spawn distance... Why? That cars can drive around from village to village...
// We need to call your custom civilian actions... In sample file new actions are named Mc_CA
init window of module : this setvariable ["spawnDistance",2000]; this setvariable ["civilianActions",["Mc_CA"]]
</pre>

Latest revision as of 14:22, 31 January 2023

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