Engine Options Reference

Engine-wide options are stored in ./Engine/Options.xml and loaded at startup. Each option is an <Parameter> entry with a Description (the option name), a Value and a valueType. Options are global and persist across levels and sessions; they can also be read and modified at runtime through the API (get_options / save_options).

The values below are the defaults shipped with the engine. Unless noted, changing an option takes effect the next time the engine starts; audio channel volumes are applied live.

Note

valueType values map to: Long (integer), Double (floating point), Boolean (True/False), String (text), Vec4 (X/Y/Z[/W] coordinate), LongArray / FloatArray (comma-separated lists).

General

Option	Type	Default	Description
dataDirectory	String	../dataLocal/	Root directory the engine loads game data and assets from.
GraphicsBackend	String	libOpenGLGraphicsBackend	Graphics backend library to load (e.g. OpenGL or OpenGL ES).
StartingRenderPipeline	String	./Engine/forward_=renderPipeline.xml	Render pipeline definition loaded at startup.

Display

Option	Type	Default	Description
screenWidth	Long	2560	Game window width in pixels.
screenHeight	Long	1440	Game window height in pixels.
fullScreen	Boolean	False	Launch in fullscreen.
TextureFiltering	String	Trilinear	Texture filtering mode: Nearest, Bilinear or Trilinear.

Audio

Audio is mixed on four channels (buses). The effective gain of a sound is per-sound gain × channel volume × master volume. These options are the channel volumes; see Audio Channels in the Python API reference. Changes are applied to the mixer immediately.

Option	Type	Default	Description
soundVolumeMaster	Double	1.0	Master channel volume, normalized 0.0..1.0. Multiplies every sound.
soundVolumeMusic	Double	1.0	Music channel volume, normalized 0.0..1.0.
soundVolumeSFX	Double	1.0	Sound-effects channel volume, normalized 0.0..1.0.
soundVolumeSpeech	Double	1.0	Speech/dialogue channel volume, normalized 0.0..1.0.

Player Movement

Option	Type	Default	Description
walkSpeed	Vec4	(8, 0, 8)	Player walk speed.
runSpeed	Vec4	(12, 0, 12)	Player run speed.
moveSpeed	Vec4	(8, 0, 8)	General movement speed.
freeMovementSpeed	Vec4	(0.5, 0.5, 0.5)	Free-camera (editor / debug) movement speed.
lookAroundSpeed	Double	-6.5	Mouse look sensitivity.
jumpFactor	Double	7.0	Jump impulse factor.

Lighting and Shadows

Option	Type	Default	Description
maximumLights	Long	4	Maximum number of simultaneous dynamic lights.
shadowMapDirectionalSize	Long	2048	Directional light shadow map resolution.
shadowMapPointWidth	Long	512	Point light shadow map width.
shadowMapPointHeight	Long	512	Point light shadow map height.
PointShadowSampleCount	Long	20	PCF sample count for point light shadows.
DirectionalShadowSampleCount	Long	8	PCF sample count for directional light shadows.
CascadeCount	Long	4	Number of cascaded shadow map cascades.
CascadeLimitList	FloatArray	5.0, 20.0, 50.0, 150.0, 250.0	View-space distance splits between shadow cascades.
CascadeStaggerOffsets	LongArray	4, 1, 2, 4	Per-cascade frame offset for staggered shadow updates (cascade 0 updates every frame).
CascadeStaggerIntervals	LongArray	4, 2, 4, 8	Per-cascade update interval in frames. Larger values improve framerate but delay shadow updates.
lightOrthogonalProjectionBackOff	Double	-5000	Back-off distance for the directional light orthographic projection.
lightPointNearPlane	Double	0.1	Near plane for point light shadow projection.
lightPointFarPlane	Double	100	Far plane for point light shadow projection.

Ambient Occlusion (SSAO)

Option	Type	Default	Description
SSAOWidth	Long	2560	SSAO buffer width.
SSAOHeight	Long	1440	SSAO buffer height.
SSAOSampleCount	Long	9	SSAO kernel sample count.
SSAOBlurRadius	Long	1	SSAO blur radius.

Culling, LOD and Occlusion

Option	Type	Default	Description
multiThreadedCulling	Boolean	True	Run visibility culling on worker threads.
LodDistanceList	LongArray	5, 10, 25, 150, 250	Distance thresholds selecting LOD level (3 LODs are generated per model, so 4 levels).
SkipRenderDistance	Double	50.0	Distance at which the engine may start skipping rendering of an object (with SkipRenderSize).
SkipRenderSize	Double	0.075	On-screen size (fraction) below which distant objects past SkipRenderDistance are skipped.
MaxSkipRenderSize	Double	3	On-screen size above which an object is never skipped (avoids jarring wall/ground pop).
SplitModelToMeshCount	Long	10	Models with more meshes than this get occlusion tested per mesh instead of per model.
SoftwareOcclusionRenderWidth	Long	512	Software-rasterized depth buffer width (must be a multiple of 8).
SoftwareOcclusionRenderHeight	Long	256	Software-rasterized depth buffer height (must be a multiple of 8).
SoftwareOcclusionOccluderSize	Double	0.5	On-screen size threshold for an object to be treated as an occluder (1 = full coverage).

Debugging and Profiling

Option	Type	Default	Description
renderInformations	Boolean	True	Show the on-screen logger overlay and tris/lines/FPS counters.
DebugDrawLines	Boolean	False	Draw debug lines.
debugDrawBufferSize	Long	1000	Vertex buffer size for debug line drawing.
Profiler.EnableServer	Boolean	True	Enable the built-in profiler server.
SoftwareOcclusionRenderDump	Boolean	False	Dump the software-rasterized depth buffer to a PPM file (debug only).
SoftwareOcclusionRenderDumpFrequency	Long	300	How often (in frames) to dump the software depth buffer when dumping is enabled.