Avatar behavior parameters
- Last UpdatedDec 06, 2023
- 3 minute read
The main avatar behavior customization parameters are exposed in the cfg_simulation file.
These parameters affect Avatar behavior, but not its representation in the 3D world. This means, for example, that changing the avatar walkHeight does not change the actual height of the avatar.

CameraMode settings
The cameraMode settings enable you to define which camera modes can be used in the simulation.
|
Setting |
Description |
|---|---|
|
startup |
Specifies initial camera mode: behind or fps. |
|
fpsEnabled |
Enables use of fps camera mode in the simulation. |
|
behindEnabled |
Enables use of behind camera mode in the simulation. |
|
overEnabled |
Enables use of over camera mode in the simulation. |

Avatar movements
The following parameters define avatar camera modes characteristics, so defining avatar movements.
|
Parameter |
Description |
|---|---|
|
overDistance |
The height offset from avatar used when exiting the first person mode and entering the fly mode. |
|
overPhysics |
Enables fly mode collisions. There must be a specific cmesh in the scene. |
|
overRay |
The collision ray for fly mode collisions. Used only if overPhysics is set to true. |
|
behindDistance |
The camera-to-avatar distance. Used in third person mode. |
|
rotationSpeed |
The avatar head rotation speed. Used to change the direction of the avatar in all the modalities. |
|
walkSpeed |
The speed when walking, expressed in m/s. |
|
walkHeight |
First person avatar camera elevation in walk mode. |
|
walkFov |
First person camera field of view in walk mode. |
|
runSpeed |
The speed when running, expressed in m/s. |
|
runHeight |
First person avatar camera elevation in run mode. |
|
runFov |
First person camera field of view in run mode. This is usually higher than walkFov. |
|
crouchSpeed |
The speed when crouched, expressed in m/s. |
|
crouchHeight |
First person avatar camera elevation in crouch mode. |
|
crouchFov |
First person camera field of view in crouch mode. Usually a bit narrower than the walkFov. |
|
flySpeed |
The speed in fly mode, expressed in m/s. |
|
near |
The avatar camera near cutting plane. |
|
far |
The avatar camera far cutting plane. |

Avatar-to-item interaction
These attributes inside the interactionSelector influence avatar-to-item interaction.
|
Attributes |
Description |
|---|---|
|
highlightDistance |
Defines at what distance from the avatar the active items show the silhouette. |
|
avatarPickDistance |
Defines at what distance from an avatar an active item can be selected. |
Both parameters are influenced by the Item avatarPickDistance that can be added to the ones defined above to make big items selectable from far.
