Technical Reference/config.toml

Configuration Settings

The `config.toml` file is the authoritative source of configuration in Exofactory. It is a super-set of the config options provided in the settings page in the game. It may be possible to "break" the game by manually editing this file. If you do, deleting the `config.toml` file and relaunching the game will restore functionality.

The `config.toml` file is NOT synced via steam.

The game when played on the Steamdeck may have different defaults that enable the game to run smoother without the need for player intervention.

File Location

Exofactory stores user settings in a config.toml file. The location varies by operating system:

Operating System	File Path
Linux	$XDG_CONFIG_HOME/ExoFactory/config.toml (typically ~/.config/ExoFactory/config.toml)
Windows	%APPDATA%\Exofactory\ExoFactory\config.toml
macOS	~/Library/Application Support/com.Exofactory.ExoFactory/config.toml

This file is created automatically when you first launch the game. You can edit it with any text editor while the game is closed.

Graphics Settings

Setting	Description	Default	Valid Values
graphics_quality	Overall graphics quality preset	Medium	Low, Medium, High
window_mode	Window display mode	BORDERLESS	WINDOWED, BORDERLESS
window_resizable	Whether the window can be resized (windowed mode only)	false	true, false
window_decorations	Show window title bar and borders	true	true, false
vsync	Vertical sync to prevent screen tearing	ON	ON, OFF

Monitor Settings

Located under [graphics.monitor]

Setting	Description	Default	Valid Values
kind	Monitor selection method	primary	primary, index
value	Monitor index (when kind = index)	0	0, 1, 2, ...

Resolution Settings

Located under [graphics.resolution]

Setting	Description	Default	Valid Values
kind	Resolution mode	native	native, fixed
width	Horizontal resolution (when kind = fixed)	-	Any positive integer
height	Vertical resolution (when kind = fixed)	-	Any positive integer

Frame Limit Settings

Located under [graphics.frame_limit]

Setting	Description	Default	Valid Values
kind	Frame rate limiting mode	unlimited	unlimited, capped
fps	Target frame rate (when kind = capped)	-	Any positive integer

Camera Settings

Located under [graphics.camera]

Setting	Description	Default	Valid Values
global_fov_degrees	Field of view in global/map view	55.0	Any positive float
exoframe_fov_degrees	Field of view when piloting an exoframe	55.0	Any positive float
exoframe_lens_chromatic_aberration_preset	Chromatic aberration effect intensity	standard	off, low, standard, high
exoframe_lens_chromatic_aberration_vignette_start	Distance from center where vignette begins	1.2	Any positive float
exoframe_lens_chromatic_aberration_vignette_softness	Softness of the vignette edge	0.5	Any positive float

Skybox

Located under [graphics.camera.skybox]

Setting	Description	Default	Valid Values
enabled	Display the skybox	true	true, false
brightness	Skybox brightness intensity	30000.0	Any positive float

Bloom

Located under [graphics.camera.bloom]

Setting	Description	Default	Valid Values
enabled	Enable bloom lighting effect	true	true, false

TAA (Temporal Anti-Aliasing)

Located under [graphics.camera.taa]

Setting	Description	Default	Valid Values
enabled	Enable temporal anti-aliasing	true	true, false

SSAO (Screen Space Ambient Occlusion)

Located under [graphics.camera.ssao]

Setting	Description	Default	Valid Values
enabled	Enable ambient occlusion	true	true, false
quality	SSAO quality level	HIGH	LOW, MEDIUM, HIGH
object_thickness	Assumed thickness of objects for occlusion	0.5	Any positive float

Occlusion Culling

Located under [graphics.camera.occlusion_culling]

Setting	Description	Default	Valid Values
enabled	Enable GPU-based occlusion culling (performance optimization)	true	true, false

Depth Prepass

Located under [graphics.camera.depth_prepass]

Setting	Description	Default	Valid Values
enabled	Enable depth prepass rendering (performance optimization)	true	true, false

Volumetric Fog

Located under [graphics.camera.volumetric_fog]

Setting	Description	Default	Valid Values
enabled	Enable volumetric fog effects	true	true, false
ambient_intensity	Intensity of ambient fog lighting	0.0	0.0 - 1.0

Volumetric Light

Located under [graphics.camera.volumetric_light]

Setting	Description	Default	Valid Values
enabled	Enable volumetric light rays (god rays)	true	true, false

Shadow Settings

Located under [graphics.shadows]

Setting	Description	Default	Valid Values
enabled	Enable dynamic shadows	true	true, false
quality	Shadow map resolution quality	HIGH	LOW, MEDIUM, HIGH, ULTRA
num_cascades	Number of shadow cascades (more = better quality at distance)	3	1-4
max_distance	Maximum distance for shadow rendering (meters)	100.0	Any positive float

Graphics Presets

The game provides four graphics presets that configure multiple settings at once. The table below shows what each preset configures:

Setting	High	Medium	Low	Minimal
Graphics Quality	High	Medium	Low	Low
Bloom	On	On	Off	Off
TAA	On	On	Off	Off
SSAO Enabled	On	On	Off	Off
SSAO Quality	HIGH	MEDIUM	LOW	LOW
Volumetric Fog	On	On	Off	Off
Volumetric Light	On	On	Off	Off
Shadows Enabled	On	On	On	Off
Shadow Quality	HIGH	MEDIUM	LOW	LOW
Shadow Cascades	3	3	2	1
Shadow Max Distance	100m	80m	60m	30m
Occlusion Culling	On	On	On	On
Depth Prepass	On	On	On	On
Skybox	On	On	On	On

Note: The Minimal preset is the only one that disables shadows entirely. Use this for the best performance on low-end hardware.

Sound Settings

Located under [sound]

Setting	Description	Default	Valid Values
master_volume	Overall volume multiplier	1.0	0.0 - 1.0
menu_volume	UI and menu sound effects volume	0.55	0.0 - 1.0
machine_volume	Factory machine sound effects volume	1.0	0.0 - 1.0
music_volume	Background music volume	0.3	0.0 - 1.0
dialogue_volume	Character dialogue volume	0.5	0.0 - 1.0
ambient_volume	Environmental ambient sounds volume	0.15	0.0 - 1.0
music_replay_delay_ms	Delay before music tracks replay (milliseconds)	120000	Any positive integer

Language Settings

Located under [language]

Setting	Description	Default	Valid Values
language_code	Game language	en-US	en-US, de-DE

UI Settings

Located under [ui]

Setting	Description	Default	Valid Values
preset	UI scaling preset	auto	auto, percent_100, percent_125, percent_150, percent_200
auto_preset	Scaling used when preset is auto (set automatically based on resolution)	percent_100	percent_100, percent_125, percent_150, percent_200

Input Sensitivity

Located under [input_sensitivity]

Setting	Description	Default	Valid Values
mouse_look	Mouse look sensitivity multiplier	0.002	Any positive float
move_stick	Gamepad movement stick sensitivity	1.0	Any positive float
look_stick	Gamepad look stick sensitivity	2.5	Any positive float

Control Guide Preference

Setting	Description	Default	Valid Values
control_guide_preference	Which control scheme icons to show in UI	auto	auto, keyboard_mouse, xbox, steam_deck

Autosave Settings

Located under [autosave]

Setting	Description	Default	Valid Values
enabled	Enable automatic saving	true	true, false
interval_secs	Time between autosaves (seconds)	300	Any positive integer
slot_count	Number of rotating autosave slots	5	1-255

Keyboard Bindings

Located under [key_bindings]

Action	Description	Default Key
move_up	Move forward	w
move_down	Move backward	s
move_left	Strafe left	a
move_right	Strafe right	d
jump	Jump	space
enter_exoframe_mode	Enter an exoframe	e
exit_to_root_mode	Exit current mode / return to global view	q
toggle_menu	Open/close game menu	escape
enter_building_mode	Enter building placement mode	e
enter_movement_mode	Enter movement mode	v
change_exoframe	Cycle to next exoframe	tab
exoframe_information	Show exoframe information panel	z
toggle_fps_stats	Toggle FPS counter display	f1
rotate_object	Rotate building placement	r
delete_building	Delete selected building	c
mirror_building	Mirror building placement	m
cycle_global_view	Cycle global view modes (Normal, Power, etc.)	tab

Valid key values: a-z, escape, tab, shift_left, shift_right, space, f1

Mouse Bindings

Located under [mouse_bindings]

Action	Description	Default
interact	Primary interaction	mouse_left
step_back	Cancel / step back in menus	mouse_right

Valid values: mouse_left, mouse_right, mouse_middle, mouse_back, mouse_forward

Gamepad Bindings

Located under [gamepad_bindings]

Action	Description	Default Button
nav_up	Navigate up in menus	dpad_up
nav_down	Navigate down in menus	dpad_down
nav_left	Navigate left in menus	dpad_left
nav_right	Navigate right in menus	dpad_right
zoom_in_button	Zoom in (global view)	right_trigger
zoom_out_button	Zoom out (global view)	left_trigger
jump	Jump	right_thumb
enter_exoframe_mode	Enter an exoframe	west
exit_to_root_mode	Exit to global view	select
toggle_menu	Open/close game menu	start
toggle_building_mode	Toggle building mode	west
toggle_movement_mode	Toggle movement mode	left_bumper
change_exoframe	Cycle exoframes	dpad_right
rotate_object	Rotate building	dpad_left
delete_building	Delete building	dpad_down
mirror_building	Mirror building	dpad_up
exoframe_information	Show exoframe info	north
interact	Primary interaction	south
step_back	Cancel / back	east
cycle_global_view	Cycle view modes	right_bumper

Gamepad Stick Bindings

Located under [gamepad_bindings.move_stick] and [gamepad_bindings.look_stick]

Stick	Axis	Default
Move Stick	horizontal	left_stick_x
Move Stick	vertical	left_stick_y
Look Stick	horizontal	right_stick_x
Look Stick	vertical	right_stick_y

Valid button values: south, east, west, north, left_trigger, left_bumper, right_trigger, right_bumper, select, start, mode, left_thumb, right_thumb, dpad_up, dpad_down, dpad_left, dpad_right

Valid axis values: left_stick_x, left_stick_y, right_stick_x, right_stick_y, left_z, right_z