View source for Config.toml

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