Preferences file

The Preferences file (options.ini) contains settings to customize EmptyEpsilon. Many of these settings are set and saved within the game, while others are set only within the file. Many settings are written to the file after the first time EmptyEpsilon is launched and quit.

Unless otherwise noted, settings with on/off values use 1 to represent enabled and 0 to represent disabled.

Location

• Windows: In the EmptyEpsilon directory.
• Linux, macOS: In an .emptyepsilon directory within your user's home directory (~/.emptyepsilon)
• Linux if installed via Flatpak: ~/.var/app/io.github.daid.EmptyEpsilon/config/emptyepsilon ($XDG_CONFIG_HOME/emptyepsilon)

You can change this by setting the $EE_CONF_DIR environment variable.

Graphical settings

• disable_shaders: Disable postprocessing shaders, such as jump, wormhole, and warp glitch effects. A value of 1 disables the shaders. The default value depends on the platform.

• fsaa: Enable full-screen anti-aliasing. A value of 2 or more represents the multiplier in use.

• first_person: Whether to default to first-person view in Main Screen and Single Pilot stations. Defaults to 1 (enabled).

• fullscreen: Enable fullscreen mode. If disabled, run in windowed mode.

• gl_debug: Enables OpenGL debug output. Defaults to disabled except in debug builds (see [Build\Debug]).

  • gl_debug_synchronous: If enabled, OpenGL debug messages are produced synchronously if possible. Defaults to disabled except in debug builds, and has no effect if gl_debug is not enabled.

• main_screen_camera_fov: Sets the field of view, in degrees, for the main screen view. Defaults to 60.

• main_screen_flags, ship_window_flags: Sets the visibility of spacedust, headings, and callsigns on the main screen and ship window views, respectively. These are additive flags, and the sum of the values determines which features are enabled. Defaults to 7.

  For example, to enable only spacedust and disable the rest, use the value 1. To enable only headings, use 2. To enable only callsigns, use 4.

  Add those values together to enable any combination of features. For example, ship_window_flags=7 enables all three.

• multimonitor: Enable or disable experimental multiple monitor support. Default is disabled. Set value to 1 to enable: multimonitor=1

• warp_post_processor_disable: Disable the warp post processor when set to 1. Disabling this processor can fix graphical problems on some platforms.

Interface settings

• autoconnect, autocontrolmainscreen, autoconnectship, autoconnect_address: See Automatic (re) connection of stations.
• guitheme: Defines the GUI theming file to apply. Defaults to gui/default.theme.txt in a resource path, such as resources/gui/default.theme.txt.
• language: The preferred interface and scenario language. Defaults to en (English). Other options include cz, de, fr, it. More may be added as collaborators add translation files.
• touchscreen: Enable touchscreen mode. See Touchscreens for details.
  • touchcalib: Deprecated. Enable use of a custom touchscreen calibration data file.
  • touchcalibfile: Deprecated. The path to a file containing touchscreen calibration data.
• tutorial: Launch EmptyEpsilon in the tutorial mission.

Radar lock

The interface options for the consoles that have a view of nearby space such as helm, weapons, science, tactical and operations can be set to either rotate the ship icon when the ship turns or keep the ship icon pointing the same way and rotate the view of objects around the ship instead. The default is 0: the ship icon rotates and the view around the ship icon remains fixed. Setting the value to 1 makes the ship icon remain fixed and the view around the ship rotate when the ship turns.

• helms_radar_lock
• weapons_radar_lock
• science_radar_lock
• tactical_radar_lock
• operations_radar_lock
• single_pilot_radar_lock

This setting corresponds to this portion of the in-game configuration options:

Note: The science radar lock option in the options menu sets both science_radar_lock and operations_radar_lock settings in the Preferences file.

Fonts (older versions only)

Note: Newer versions of EmptyEpsilon define fonts in the GUI theming file instead of the Preferences file.

To use a different font, make sure it's in the gui/fonts/ subdirectory of a resource path, such as resources/gui/fonts/.

• font_bold: Allows you to select the bold font used. Defaults to gui/fonts/BigShouldersDisplay-ExtraBold.ttf
• font_regular: Allows you to select the regular font used. Defaults to gui/fonts/BigShouldersDisplay-SemiBold.ttf

Gameplay settings

• script_cycle_limit: Sets a limit on the number of cycles a loop in a Lua script can run. Defaults to 0 (unlimited). Set this when troubleshooting Lua scripts that cause the game to lock up.
• self_destruct_countdown: Sets the self-destruct countdown, in seconds. Defaults to 10. This setting is effective only when set on the server.
• Options beginning with server_config configure the game server's scenario settings.
  • server_config_warp_jump_drive_setting: 0 is Ship Default, 1 is Warp Drive, 2 is Jump Drive, 3 is Both, 4 is Neither
  • server_config_scanning_complexity: 0 is None (Delay), 1 is Simple, 2 is Normal, 3 is Advanced
  • server_config_hacking_difficulty: 0 is Simple, 1 is Normal, 2 is Difficult, 3 is Fiendish
  • server_config_hacking_games: 0 is Mine, 1 is Lights, 2 is All
  • server_config_use_beam_shield_frequencies: Enabled/disabled
  • server_config_use_system_damage: Enabled/disabled
  • server_config_allow_main_screen_long_range_radar: Enabled/disabled
  • server_config_allow_main_screen_tactical_radar: Enabled/disabled
  • server_config_gm_control_code: Set a password for GM screen access

Networking options

• headless: The filename of a scenario in the scripts directory to run with the game server in headless mode, without a user interface. See Headless Dedicated Server.
  • headless_name: The headless game server's name.
  • headless_password: The headless game server's password.
  • headless_internet: Whether to register the headless game server on the internet.
  • variation: The mission variation to use.
  • startpaused: If 1, start the game paused, which requires the server to unpause the game via HTTP API. Defaults to not pausing the game on launch.
• httpserver: The port number for EmptyEpsilon's built in HTTP server, both for use with its API and to serve content from the directory configured by the www_directory setting (defaults to www). Omitting the value disables the server. See HTTP Server for details.
• last_server: The previous game server's IP address.
• proxy: The IP address of a game server that this client should serve as a proxy of, or the word listen to act as a reverse proxy. See Proxy Server for details.
• registry_list_url, registry_registration_url: URL to the master registry server's list and registry endpoints. See the SeriousProton masterserver README for an example master registry server.
• server_scenario: Similar to headless, but launches the scenario with the given filename with a user interface, skipping the main menu and server configuration screens and using the scenario's default variation or options.
• serverproxy: The IP address of a reverse proxy server. See Proxy Server for details.
• username: The default username. Defaults to the operating system's username (USER or USERNAME environment variables).

Data options

• game_logs: Enable logging of game state to JSON in the logs directory, if it exists, of your running path. See the repository's logs directory for an example visualization of these logs.
• instance_name: Label this client with a name that appears on the main menu screen and the window's title bar.
• mod: Adds resources to the game from the given subdirectory within the mods/ subdirectory of a resource path. For example, mod=example would load resources from resources/mods/example/, scripts/mods/example/, or ~/.emptyepsilon/resources/mods/example/.

Audio options

• impulse_sound_enabled: Defines whether impulse engine sounds are enabled, and where they're played. 0 = disabled, 1 enabled, 2 enabled for main screen only. Defaults to 2.

• impulse_sound_volume: Percentage (from 0.00 to 100.00) of impulse engine sound volume. Defaults to 50.

  These parameters correspond to this in-game configuration:

  

  Older versions of EmptyEpsilon used the names engine_enabled and engine_volume for these settings.

• music_enabled: If the value is 0, disable background music. If the value is 1, enable music on this client. If the value is 2, enable music on this client only if it is the main screen. Defaults to 2.

• music_volume: Percentage (from 0.00 to 100.00) of music volume.

• sound_volume: Percentage (from 0.00 to 100.00) of sound volume.

Control settings (older versions only)

Note: Newer versions of EmptyEpsilon save hotkeys in a separate file named keybindings.json, and have a user interface in the Options menu to configure them.

Hotkey and joystick options are formatted like this:

HOTKEY.ENGINEERING.DECREASE_COOLANT=Left
JOYSTICK.AXIS.ENGINEERING.COOLANT=-Y

To specify a joystick button for a hotkey, enter the button in the format of [b0] for joystick button 0, like this:

HOTKEY.ENGINEERING.DECREASE_COOLANT=[b0]

• All available options begin with HOTKEY or JOYSTICK and have default values, or no value if there is no default keybinding.
• In the above example, ENGINEERING represents the category.
• The function that the hotkey affects follows.
• The key value, if any, is last.

All settable hotkey and joystick options are written when EmptyEpsilon is closed.