Skip to content

Configuration files

Using OpenTSConfiguration

OpenTS reads player options, hotkeys, rules, art, media registries, and scenario data from separate files.

Look up a configuration fact in the area that covers it:

AreaCovers
INI ReferenceAccepted keys, sections, value types, and established omission behavior
FormatsFile loading, registration sections, record structure, and companion files
CommandsHotkey command names and fixed controls
Command line optionsOptions accepted on the OpenTS command line
MappingScenario sections, triggers, TeamTypes, TaskForces, Scripts, and AI triggers

The game reads its configuration from these files:

  • SUN.INI stores the player’s options.
  • KEYBOARD.INI assigns keys to command names.
  • UI.INI, which a mod or deployment may ship, sets how order lines and the sighting laser are drawn.
  • Rules, art, sound, theme, and scenario files supply game and mod data.

A deployment can rename these files in OPENTS.INI: the settings file, UI.INI, the tutorial file, and the rules, language rules, multiplayer rules, art, AI, sound, theme, and campaign list files together with their expansion copies. KEYBOARD.INI and scenario files cannot be renamed.

The game looks for each file in the search order and uses the first copy it finds. Settings and hotkeys the player saves are written to the first directory in that order, so the saved copy is read ahead of a shipped one.

Authoritative files

Linked at revision 51b52aa38392.