Config.toml - Revision history

Caitlin: Update defaults for controls

2026-04-25T13:51:14Z

Update defaults for controls

← Older revision		Revision as of 13:51, 25 April 2026
Line 335:		Line 335:
	\| <code>toggle_menu</code> \|\| Open/close game menu \|\| escape		\| <code>toggle_menu</code> \|\| Open/close game menu \|\| escape
	\|-		\|-
	\| <code>enter_building_mode</code> \|\| Enter building placement mode \|\| e		\| <code>enter_building_mode</code> \|\| Enter building placement mode \|\| f
	\|-		\|-
	\| <code>enter_movement_mode</code> \|\| Enter movement mode \|\| v		\| <code>enter_movement_mode</code> \|\| Enter movement mode \|\| v
Line 341:		Line 341:
	\| <code>change_exoframe</code> \|\| Cycle to next exoframe \|\| tab		\| <code>change_exoframe</code> \|\| Cycle to next exoframe \|\| tab
	\|-		\|-
	\| <code>exoframe_information</code> \|\| Show exoframe information panel \|\| z		\| <code>exoframe_information</code> \|\| Show exoframe information panel \|\| e
	\|-		\|-
	\| <code>toggle_fps_stats</code> \|\| Toggle FPS counter display \|\| f1		\| <code>toggle_fps_stats</code> \|\| Toggle FPS counter display \|\| f1

Caitlin: Caitlin moved page Technical Reference/config.toml to Config.toml: Cleaner Approach

2026-01-10T12:32:58Z

Caitlin moved page Technical Reference/config.toml to Config.toml: Cleaner Approach

← Older revision		Revision as of 12:32, 10 January 2026
(No difference)

Caitlin: /* Multiplayer Settings */

2026-01-10T12:31:24Z

Multiplayer Settings

← Older revision		Revision as of 12:31, 10 January 2026
Line 305:		Line 305:
	! Setting !! Description !! Default !! Valid Values		! Setting !! Description !! Default !! Valid Values
	\|-		\|-
	\| <code>bind_ip</code> \|\| IP address to bind the server to \|\| :: \|\| Valid IP address string (IPv4 or IPv6)		\| <code>bind_ip*</code> \|\| IP address to bind the server to \|\| :: \|\| Valid IP address string (IPv4 or IPv6)
	\|-		\|-
	\| <code>bind_port</code> \|\| Port to listen on \|\| 6000 \|\| 1 - 65535		\| <code>bind_port</code> \|\| Port to listen on \|\| 6000 \|\| 1 - 65535
Line 311:		Line 311:
	\| <code>cert_hostname</code> \|\| Hostname for the self-signed certificate \|\| localhost \|\| Valid hostname string		\| <code>cert_hostname</code> \|\| Hostname for the self-signed certificate \|\| localhost \|\| Valid hostname string
	\|}		\|}
			* When the bind_ip is set to <code>::</code> this will enable IPv4/6 full-stack on platforms that support it.

	== Keyboard Bindings ==		== Keyboard Bindings ==

Caitlin at 12:29, 10 January 2026

2026-01-10T12:29:08Z

@@ Line 297: / Line 297: @@
 |-
 | <code>slot_count</code> || Number of rotating autosave slots || 5 || 1-255
 |}

Caitlin at 16:27, 28 December 2025

2025-12-28T16:27:28Z

← Older revision		Revision as of 16:27, 28 December 2025
Line 1:		Line 1:
	= Configuration Settings =		= 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 <code>config.toml</code> 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 <code>config.toml</code> file and relaunching the game will restore functionality.

	The `config.toml` file is ''NOT'' synced via steam.		The <code>config.toml</code> 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.		The game when played on the Steamdeck may have different defaults that enable the game to run smoother without the need for player intervention.

Caitlin at 16:26, 28 December 2025

2025-12-28T16:26:02Z

← Older revision		Revision as of 16:26, 28 December 2025
Line 3:		Line 3:
	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 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 `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.		The game when played on the Steamdeck may have different defaults that enable the game to run smoother without the need for player intervention.

Caitlin: /* Configuration Settings */

2025-12-28T16:25:19Z

Configuration Settings

← Older revision		Revision as of 16:25, 28 December 2025
Line 1:		Line 1:
	= Configuration Settings =		= 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 ==		== File Location ==

Caitlin at 16:21, 28 December 2025

2025-12-28T16:21:12Z

← Older revision		Revision as of 16:21, 28 December 2025
Line 65:		Line 65:
	\| <code>kind</code> \|\| Frame rate limiting mode \|\| unlimited \|\| unlimited, capped		\| <code>kind</code> \|\| Frame rate limiting mode \|\| unlimited \|\| unlimited, capped
	\|-		\|-
	\| <code>fps</code> \|\| Target frame rate (when kind = capped) \|\| - \|\| ~~30-240~~		\| <code>fps</code> \|\| Target frame rate (when kind = capped) \|\| - \|\| Any positive integer
	\|}		\|}

Caitlin: Init

2025-12-28T16:01:59Z

Init

New page

= Configuration Settings =

== File Location ==

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

{| class="wikitable"
! Operating System !! File Path
|-
| '''Linux''' || <code>$XDG_CONFIG_HOME/ExoFactory/config.toml</code> (typically <code>~/.config/ExoFactory/config.toml</code>)
|-
| '''Windows''' || <code>%APPDATA%\Exofactory\ExoFactory\config.toml</code>
|-
| '''macOS''' || <code>~/Library/Application Support/com.Exofactory.ExoFactory/config.toml</code>
|}

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 ==

{| class="wikitable sortable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>graphics_quality</code> || Overall graphics quality preset || Medium || Low, Medium, High
|-
| <code>window_mode</code> || Window display mode || BORDERLESS || WINDOWED, BORDERLESS
|-
| <code>window_resizable</code> || Whether the window can be resized (windowed mode only) || false || true, false
|-
| <code>window_decorations</code> || Show window title bar and borders || true || true, false
|-
| <code>vsync</code> || Vertical sync to prevent screen tearing || ON || ON, OFF
|}

=== Monitor Settings ===
Located under <code>[graphics.monitor]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>kind</code> || Monitor selection method || primary || primary, index
|-
| <code>value</code> || Monitor index (when kind = index) || 0 || 0, 1, 2, ...
|}

=== Resolution Settings ===
Located under <code>[graphics.resolution]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>kind</code> || Resolution mode || native || native, fixed
|-
| <code>width</code> || Horizontal resolution (when kind = fixed) || - || Any positive integer
|-
| <code>height</code> || Vertical resolution (when kind = fixed) || - || Any positive integer
|}

=== Frame Limit Settings ===
Located under <code>[graphics.frame_limit]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>kind</code> || Frame rate limiting mode || unlimited || unlimited, capped
|-
| <code>fps</code> || Target frame rate (when kind = capped) || - || 30-240
|}

=== Camera Settings ===
Located under <code>[graphics.camera]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>global_fov_degrees</code> || Field of view in global/map view || 55.0 || Any positive float
|-
| <code>exoframe_fov_degrees</code> || Field of view when piloting an exoframe || 55.0 || Any positive float
|-
| <code>exoframe_lens_chromatic_aberration_preset</code> || Chromatic aberration effect intensity || standard || off, low, standard, high
|-
| <code>exoframe_lens_chromatic_aberration_vignette_start</code> || Distance from center where vignette begins || 1.2 || Any positive float
|-
| <code>exoframe_lens_chromatic_aberration_vignette_softness</code> || Softness of the vignette edge || 0.5 || Any positive float
|}

==== Skybox ====
Located under <code>[graphics.camera.skybox]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Display the skybox || true || true, false
|-
| <code>brightness</code> || Skybox brightness intensity || 30000.0 || Any positive float
|}

==== Bloom ====
Located under <code>[graphics.camera.bloom]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable bloom lighting effect || true || true, false
|}

==== TAA (Temporal Anti-Aliasing) ====
Located under <code>[graphics.camera.taa]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable temporal anti-aliasing || true || true, false
|}

==== SSAO (Screen Space Ambient Occlusion) ====
Located under <code>[graphics.camera.ssao]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable ambient occlusion || true || true, false
|-
| <code>quality</code> || SSAO quality level || HIGH || LOW, MEDIUM, HIGH
|-
| <code>object_thickness</code> || Assumed thickness of objects for occlusion || 0.5 || Any positive float
|}

==== Occlusion Culling ====
Located under <code>[graphics.camera.occlusion_culling]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable GPU-based occlusion culling (performance optimization) || true || true, false
|}

==== Depth Prepass ====
Located under <code>[graphics.camera.depth_prepass]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable depth prepass rendering (performance optimization) || true || true, false
|}

==== Volumetric Fog ====
Located under <code>[graphics.camera.volumetric_fog]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable volumetric fog effects || true || true, false
|-
| <code>ambient_intensity</code> || Intensity of ambient fog lighting || 0.0 || 0.0 - 1.0
|}

==== Volumetric Light ====
Located under <code>[graphics.camera.volumetric_light]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable volumetric light rays (god rays) || true || true, false
|}

=== Shadow Settings ===
Located under <code>[graphics.shadows]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable dynamic shadows || true || true, false
|-
| <code>quality</code> || Shadow map resolution quality || HIGH || LOW, MEDIUM, HIGH, ULTRA
|-
| <code>num_cascades</code> || Number of shadow cascades (more = better quality at distance) || 3 || 1-4
|-
| <code>max_distance</code> || 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:

{| class="wikitable"
! 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 <code>[sound]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>master_volume</code> || Overall volume multiplier || 1.0 || 0.0 - 1.0
|-
| <code>menu_volume</code> || UI and menu sound effects volume || 0.55 || 0.0 - 1.0
|-
| <code>machine_volume</code> || Factory machine sound effects volume || 1.0 || 0.0 - 1.0
|-
| <code>music_volume</code> || Background music volume || 0.3 || 0.0 - 1.0
|-
| <code>dialogue_volume</code> || Character dialogue volume || 0.5 || 0.0 - 1.0
|-
| <code>ambient_volume</code> || Environmental ambient sounds volume || 0.15 || 0.0 - 1.0
|-
| <code>music_replay_delay_ms</code> || Delay before music tracks replay (milliseconds) || 120000 || Any positive integer
|}

== Language Settings ==
Located under <code>[language]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>language_code</code> || Game language || en-US || en-US, de-DE
|}

== UI Settings ==
Located under <code>[ui]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>preset</code> || UI scaling preset || auto || auto, percent_100, percent_125, percent_150, percent_200
|-
| <code>auto_preset</code> || 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 <code>[input_sensitivity]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>mouse_look</code> || Mouse look sensitivity multiplier || 0.002 || Any positive float
|-
| <code>move_stick</code> || Gamepad movement stick sensitivity || 1.0 || Any positive float
|-
| <code>look_stick</code> || Gamepad look stick sensitivity || 2.5 || Any positive float
|}

== Control Guide Preference ==

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>control_guide_preference</code> || Which control scheme icons to show in UI || auto || auto, keyboard_mouse, xbox, steam_deck
|}

== Autosave Settings ==
Located under <code>[autosave]</code>

{| class="wikitable"
! Setting !! Description !! Default !! Valid Values
|-
| <code>enabled</code> || Enable automatic saving || true || true, false
|-
| <code>interval_secs</code> || Time between autosaves (seconds) || 300 || Any positive integer
|-
| <code>slot_count</code> || Number of rotating autosave slots || 5 || 1-255
|}

== Keyboard Bindings ==
Located under <code>[key_bindings]</code>

{| class="wikitable sortable"
! Action !! Description !! Default Key
|-
| <code>move_up</code> || Move forward || w
|-
| <code>move_down</code> || Move backward || s
|-
| <code>move_left</code> || Strafe left || a
|-
| <code>move_right</code> || Strafe right || d
|-
| <code>jump</code> || Jump || space
|-
| <code>enter_exoframe_mode</code> || Enter an exoframe || e
|-
| <code>exit_to_root_mode</code> || Exit current mode / return to global view || q
|-
| <code>toggle_menu</code> || Open/close game menu || escape
|-
| <code>enter_building_mode</code> || Enter building placement mode || e
|-
| <code>enter_movement_mode</code> || Enter movement mode || v
|-
| <code>change_exoframe</code> || Cycle to next exoframe || tab
|-
| <code>exoframe_information</code> || Show exoframe information panel || z
|-
| <code>toggle_fps_stats</code> || Toggle FPS counter display || f1
|-
| <code>rotate_object</code> || Rotate building placement || r
|-
| <code>delete_building</code> || Delete selected building || c
|-
| <code>mirror_building</code> || Mirror building placement || m
|-
| <code>cycle_global_view</code> || 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 <code>[mouse_bindings]</code>

{| class="wikitable"
! Action !! Description !! Default
|-
| <code>interact</code> || Primary interaction || mouse_left
|-
| <code>step_back</code> || Cancel / step back in menus || mouse_right
|}

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

== Gamepad Bindings ==
Located under <code>[gamepad_bindings]</code>

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

=== Gamepad Stick Bindings ===
Located under <code>[gamepad_bindings.move_stick]</code> and <code>[gamepad_bindings.look_stick]</code>

{| class="wikitable"
! 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

[[Category:Settings]]
[[Category:Configuration]]