Skip to content

Workspace settings

The workspace setting can be accessed by pressing the rightmost gear icon in the toolbar.

alt text

This brings up the following panel. There are 4 different tabs (Server, Scene, Gateway and Logs), the settings for each tab are explained below.

alt text

Server settings

In this tab, all settings related to the current server can be configured.

Server Version

Displays the version of the connected server.

Domain Name

Displays the domain name of the server.

Remaining Time

Displays how much time is left before the server shuts down (online servers only).

Connection Status

The status is 'Connected' when the app is able to communicate with the server.


A list of all users currently logged in on the server.


When this is enabled a wireframe is shown around all collision shapes in the scene. Dynamic objects are red, while static objects are green. Rays are also visualized. This option is turned off by default.

DebugDrawPhysics Interval

This setting specifies how frequently the collision visualization is updated.

Physics clock

Displays how long the emulation has been running. It's the same as the server time shown in the toolbar, but with higher resolution.

Node count

Displays how many nodes are currently loaded in the workspace.

Emulation fps

Displays the update frequency of the physics engine.

Emulation step

Default is 0.005

Time relation

The time relation can be used to slow down or speed up the emulation time. The default value is 1.

Global erp

The ERP specifies what proportion of the joint error will be fixed during the next simulation step. If ERP=0 then no correcting force is applied and the bodies will eventually drift apart as the simulation proceeds. If ERP=1 then the simulation will attempt to fix all joint error during the next time step. However, setting ERP=1 is not recommended, as the joint error will not be completely fixed due to various internal approximations. A value of ERP=0.1 to 0.8 is recommended (0.2 is the default).

Global cfm

If CFM is set to zero (which is the default value), the constraint will be hard. If CFM is set to a positive value, it will be possible to violate the constraint by "pushing on it" (for example, for contact constraints by forcing the two contacting objects together). In other words the constraint will be soft, and the softness will increase as CFM increases. What is actually happening here is that the constraint is allowed to be violated by an amount proportional to CFM times the restoring force that is needed to enforce the constraint. Note that setting CFM to a negative value can have undesirable bad effects, such as instability. Don't do it.

Constraint iterations

A higher value means that all constraints and collisions are calculated more accurately.

Gateway interval

VR sample_rate

VR transform_sensor

VR save_to_json

VR avatar_GUID

This is the GUID of the component used as the character when entering VR mode.

Scene settings

In this tab, all settings related to the scene can be configured.


Determines whether shadows are drawn or not. Having shadows active can have a big impact on performance. It is turned off by default.

Ambient Light

Toggles the ambient light on or off.


Determines the color of the ambient light.


Determines the intensity of the ambient light.


Toggles the point light on or off.


Determines the color of the point light


Determines the intensity of the point light.


Determines the position of the point light


Toggles the ground plane on or off.


Length of the ground planes sides in metres.


Determines how many squares are distributed along each side of the ground plane. If this value is equal to the ground size parameter, every square will be one square metre.


Determines the color of the ground plane.


In this tab, all settings related to the gateway can be configured.


Displays the version of the running gateway.

Connection Status

Toggles the connection state of the gateway.

Connected To

Displays the URL of the server the gateway is connected to. This is only visible if the gateway is actually connected to a server.

Gateway URL

Sets the URL of the gateway.


This tab displays log messages sent from the server. Black text is used for INFO messages, while red text is used for ERROR messages.


This button clears all messages from the log.