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)

Control settings

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. For possible hotkey values, see the SFML documentation. For joystick axis values, see the SFML documentation.

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

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.
• first_person: Whether to default to first-person view in Main Screen and Single Pilot stations.
• fsaa: Enable full-screen anti-aliasing. A value of 2 or more represents the multiplier in use.
• fullscreen: Enable fullscreen mode. If disabled, run in windowed mode.
• ship_window_flags: Values for ship_window_flags are spacedust (1), headings (2), callsigns (4). Sum them to set more than one value. Example: ship_window_caption=7 enables all three.
• multimonitor: Enable or disable experimental multiple monitor support. Default is disabled. Set value to 1 to enable: multimonitor=1

Interface settings

• autoconnect, autocontrolmainscreen, autoconnectship: See Automatic (re) connection of stations.
• 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: Enable use of a custom touchscreen calibration data file.
  • touchcalibfile: 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 option:

Note: The science radar lock option in game sets both science_radar_lock and operations_radar_lock in options.ini

Gameplay settings

• 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.
• httpserver: The port number for EmptyEpsilon's built in HTTP server, both for use with its API and to serve content from the www directory. 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.
• 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 events to JSON in the logs directory, if it exists. 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 from the given subdirectory within resources/mods/ (or ~/.emptyepsilon/resources/mods/) to the game.

Audio options

• 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.
• music_volume: Percentage (from 0.00 to 100.00) of music volume.
• sound_volume: Percentage (from 0.00 to 100.00) of sound volume.
• engine_enabled: impulse engine sounds enabled or not and where they come from: 0 = disabled, 1 enabled, 2 enabled for main screen only.
• engine_volume: Percentage (from 0.00 to 100.00) of impulse engine sound volume These two engine parameters correspond to this in-game configuration:
  

Graphical User Interface (GUI) options

Fonts

If you want to use a different font, be sure it's in resources/gui/fonts

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