# Ambient Life Configs

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

## Ambient Life Distribution

There is a probabilistic way to define ambient life distribution, depending on current time, place and weather conditions, defined in CfgWorlds.

Layer cost and species probability use Simple Expressions.

Ambient Parameters which can be used inside of expressions:

As far as probabilities are considered, for each Species class, the probabilities need sum to one. In the following example, for instance:

```probability = "deadBody+(1-deadBody)*(0.5-forest*0.1-meadow*0.2)";
```

Which really sums into one, as one can easily check:

```sum = deadBody+(1-deadBody)*(0.5 - 0.1*forest - 0.2*meadow + 0.5 - 0.1*forest + 0.2*meadow + 0.2*forest) =
```

More complete example follows:

```class CfgWorlds
{
class DefaultWorld
{
// ambient life configuration
class Ambient
{
class SmallInsects
{
radius = 3; // radius in meters, where ambient lives (distance from the player)
cost = "(10-5*hills)*(1-night)*(1-rain)*(1-sea)*(1-( (windy*2) min 1))"; // total number of all species
/// species configuration
class Species
{
class HouseFly
{
cost = 1; // when the fly lives, it pays this cost to the total sum cost SmallInsects::cost
};
class HoneyBee
{
cost = 1;
};
class Mosquito
{
cost = 1;
};
};
};
// ...
};
};
};
```

## Basic Ambient Behaviour

Basic ambient behaviour is defined in cfgVehicles.hpp.

```class CfgNonAIVehicles
{
class Bird
{
scope = private;
model = "";
simulation = SeaGull;	// which CPP class simulate ambient behaviour
reversed = false;		// default is not reversed (ambients are oriented in other way, than a man)
//straightDistance,minHeight,avgHeight and maxHeight can be overiden by randomMove fsm function
minHeight = 5;
avgHeight = 10;
maxHeight = 50;
straightDistance = 50; // random move will use this to set the maximum distance, where to fly
minSpeed = -0.5;	// m/s
maxSpeed = 20;		// m/s
acceleration = 7;	// m/s^2
turning = 1;		// angular acceleration - relative (the higher, the more maneuvrable)
flySound[]	= { "", db-30, 1, 1 };
singSound[]	= { "", db-30, 1, 1 };
canBeShot = true;					// birds can, insect cannot
airFriction2[] = {25,12,2.5};		// defines the matrix for computing friction
airFriction1[] = {1500,700,100};	// multiplying columns changes friction in given coordinate
airFriction0[] = {40,20,60};
};
// ...
};
```

## Ambient Behaviour Specialisation

For particular species, default Bird or Insect values, defined in cfgVehicles.hpp can be specialized:

```class CfgNonAIVehicles
{
class Insect;
class Bird;
class ButterFly : Insect
{
model = "aglais_urticae.p3d";
fsm[] = {"Butterfly"};		// there could be more FSMs for layered FSM system, but it is not implemented yet
moves = CfgMovesButterfly;	// animation subject is described on other place in wiki
//straightDistance,minHeight,avgHeight and maxHeight can be overridden by randomMove fsm function
straightDistance = 2;		// random move will use this to set the maximum distance, where to fly
minHeight = -0.10;			// allow landing
avgHeight = 0.3;			// these Height values are used in random movement
maxHeight = 1.5;
minSpeed = -0.1;			// autopilot tries to make ambient fly within this range
maxSpeed = 1;				// but it is modulated only in Z coordinate, yet (side speed is still problem)
acceleration = 5;			// m/s^2 this acceleration is used whenever possible. Ambient cannot fly with less effort.
turning = 5;				// turning ability (less value, less turning ability)
reversed = false;			// model is oriented in another way than a man. With true value, ambient flies backwards.
autocenter = false;			// important for proper rtm animation (bones mounted on proper place)
};
// ...
};
```