Game settings.tbl

This feature requires FreeSpace Open

Revision information.....

FSO Git Commit: Date: 2022-09-09 SHA: bb232382cf7401d6728a3614583e8e3c7d893790

Note: Please update the revision information when the page is updated. If your edit had nothing to do with new code entries then please do not edit the revision information

List of Tables and related code files
* Notes Modular Tables
** Notes tables which only use modular tables
Ai.tbl*	/ai/aicode.cpp
Ai_profiles.tbl*	/ai/ai_profiles.cpp
Animation.tbl**	/model/modelanimation.cpp
Armor.tbl*	/ship/ship.cpp
Asteroid.tbl*	/asteroid/asteroid.cpp
Autopilot.tbl*	/autopilot/autopilot.cpp
Cheats.tbl*	/cheats_table/cheats_table.cpp
Colors.tbl*	/globalincs/alphacolors.cpp
Curves.tbl*	/math/curves.cpp
Controlconfigdefaults.tbl	/controlconfig/controlsconfigcommon.cpp
Credits.tbl*	/menuui/credits.cpp
Cutscenes.tbl*	/cutscene/cutscenes.cpp
Decals.tbl**	/decals/decals.cpp
Fireball.tbl*	/fireball/fireballs.cpp
Fonts.tbl*	/graphics/font.cpp
Game_settings.tbl*	/mod_table/mod_table.cpp
Glowpoints.tbl*	/model/modelread.cpp
Help.tbl*	/gamehelp/contexthelp.cpp
Hud_gauges.tbl*	/hud/hudparse.cpp
Icons.tbl*	/mission/missionbriefcommon.cpp
Iff_defs.tbl*	/iff_defs/iff_defs.cpp
Keywords.tbl*	Not In Codebase
Lighting_Profiles.tbl*	/lighting/lighting_profiles.cpp
Lightning.tbl*	/nebula/neblightning.cpp
Mainhall.tbl*	/menuui/mainhallmenu.cpp
Medals.tbl*	/stats/medals.cpp
Messages.tbl*	/mission/missionmessage.cpp
Mflash.tbl*	/weapon/muzzleflash.cpp
Music.tbl*	/gamesnd/eventmusic.cpp
Nebula.tbl*	/nebula/neb.cpp
Objecttypes.tbl*	/ship/ship.cpp
Options.tbl*	Not In Codebase
Particle effects(-part.tbm)**	/particle/effects...
Post_processing.tbl	/graphics/gropenglpostprocessing.cpp
Rank.tbl*	/stats/scoring.cpp
Scpui.tbl*	Not In Codebase
Scripting.tbl*	/parse/scripting.cpp
Ships.tbl*	/ship/ship.cpp
Sexps.tbl**	/parse/sexp/sexp_lookup.cpp
Sounds.tbl*	/gamesnd/gamesnd.cpp
Species_defs.tbl*	/species_defs/species_defs.cpp
Species.tbl*	/menuui/techmenu.cpp
Ssm.tbl*	/hud/hudartillery.cpp
Stars.tbl*	/starfield/starfield.cpp
Strings.tbl*	/localization/localize.cpp
Tips.tbl*	/menuui/playermenu.cpp
Traitor.tbl*	/stats/scoring.cpp
Tstrings.tbl*	/localization/localize.cpp
Virtual_pofs.tbl*	/model/modelreplace.cpp
Weapon_expl.tbl*	/weapon/weapons.cpp
Weapons.tbl*	/weapon/weapons.cpp

The game_settings.tbl, also known as mod.tbl, defines options that can be changed globally. All settings are optional.

This table is one of the Modular Tables and can be extended with xxx-mod.tbm

#GAME SETTINGS

Contains settings that affect how the engine works.

$Target Version:

FS2 Open, 3.7.4:

Specifies the minimum version of FreeSpace Open that this mod supports. If the version specified here is greater than the version of the current build, an error message is displayed.

FS2 Open, 19.0:

The $Minimum version option has been renamed to $Target Version. The old name is kept with the same functionality for backwards-compatibility.

The target version specifies what version of the FSO engine this mod was created for. It will be used by the engine to enable or disable backwards-incompatible changes by default. The default value is 2.0 which specifies that the mod targets the retail engine version.

+Major:

FS2 Open, 3.7.4:

Required. Sets the major component of the target version.

• Syntax: Integer
• Example: 3 (for a minimum version of 3.7.3.20151121)

+Minor:

FS2 Open, 3.7.4:

Required. Sets the minor component of the target version.

• Syntax: Integer
• Example: 7 (for a minimum version of 3.7.3.20151121)

+Build:

FS2 Open, 3.7.4:

Required. Sets the build component of the target version.

• Syntax: Integer
• Example: 3 (for a minimum version of 3.7.3.20151121)

+Revision:

FS2 Open, 3.7.4:

Sets the revision component of the target version. If no revision is given then all builds of that release are supported (even nightly builds if there are any). For nightly builds this is the date in YYYYMMDD format.

• Syntax: Integer
• Example: 20151121 (for a minimum version of 3.7.3.20151121)

$Window title:

FS2 Open, 19.0:

Specifies the name of the FSO window when this mod is running. If blank or unspecified, the window will have the default title of "FreeSpace 2".

• Syntax: String

$Window icon:

FS2 Open, 19.0:

Specifies the icon filename of the FSO window when this mod is running. If blank or unspecified, the window will have the default icon.

• Syntax: String

$Mod title:

FS2 Open, 23.0:

Specifies the title of the mod and will be displayed at the mainhall near the FSO version.

• Syntax: String

$Mod version:

FS2 Open, 23.0:

Specifies the version of the mod and will be displayed at the mainhall near the FSO version. Can be a string or it can be semantic versioning such as 2.0.0.

• Syntax: String

$Unicode mode:

FS2 Open, 19.0:

Enabled the Unicode text mode for this mod. In Unicode mode all text is assumed to be UTF-8 encoded Unicode and certain features are disabled if they do not have full Unicode support. Most notably, if this is enabled then the engine will no longer support the old bitmap fonts that were used by Retail FreeSpace. Only the newer TrueType fonts will be supported.

• Syntax: Boolean
• Default Value: NO

$Splash screens:

FS2 Open, 23.2: Defines a list of splash screens that FSO can display upon game startup. Chosen at random.

+Bitmap:

FS2 Open, 23.2:

The name of the bitmap to use as a splash screen. Extension will be removed if included.

• Syntax: +Bitmap: String

#LOCALIZATION SETTINGS

Contains various settings related to localization and language support.

$Use tabled strings for the default language:

FS2 Open, 21.0:

Causes the game to use the text in strings.tbl and tstrings.tbl even when the current language is English. By default, the game will use the literal text in the source code and the data files (tables and missions) and will not look up the entry when the language is English. For other languages, the translation is always used, if it exists, regardless of this setting.

• Syntax: Boolean
• Default Value: NO

$Don't pre-empt training message voice:

FS2 Open, 21.4:

Prevents training messages from being interrupted by other training messages. If a training message has a voice file associated with it, or simulated speech is active, the next message will not be played until the current message has finished.

• Syntax: Boolean
• Default Value: NO

#CAMPAIGN SETTINGS

This group contains various Campaign related settings and overrides.

$Default Campaign File Name:

Defines which campaign will be selected by default for new pilots. A file extension is not needed and, if present, is removed by the code.

• Syntax: String

#Ignored Campaign File Names

Defines which campaigns, if present, will not appear in the Campaign Room. In the original implementation, only single-player campaigns could be ignored and file extensions were required, but see below.

FS2 Open, 3.7.2: As of 3.7.1, file extensions are not required and, if present, are removed by the code.

FS2 Open, 19.0: As of 3.8.2, file name comparisons are not case sensitive and multiplayer campaigns can be ignored.

$Campaign File Name:

File name of the campaign to ignore. Multiple entries may exist.

• Syntax: String

#Ignored Mission File Names

FS2 Open, 19.0: Defines which standalone missions, if present, will not appear in the Tech Room or Multiplayer Lobby. Both single-player and multiplayer missions can be ignored, but missions which appear in a campaign cannot. File extensions are not required and, if present, are removed by the code. File name comparisons are not case sensitive.

$Mission File Name:

File name of the mission to ignore. Multiple entries may exist.

• Syntax: String

$Red-alert applies to delayed ships:

FS2 Open, 3.7.2: Controls whether red-alert saved statistics (hitpoints, weapons, subsystem strengths) will be restored for ships that are not present at mission start.

• Syntax: Boolean
• Default Value: NO

#HUD SETTINGS

This group contains various HUD behavior settings and overrides

$Directive Wait Time:

• Defines how long the game will wait before displaying a directive.
• Syntax: Integer
• Values: Greater than or equal to 0 ms

$Cutscene camera displays HUD:

Show the HUD when the cutscene camera is enabled.

• Syntax: Boolean
• Default Value: NO

In earlier versions of the code, this option was controlled by $Cutscene camera disables HUD: and had a default of YES.

$Full color head animations:

Enables full-color head ANIs. Normal head ANIs will appear in gray.

• Syntax: Boolean
• Default Value: NO

In earlier versions of the code, this option was controlled by $Color head animations with hud colors: and had a default of YES.

$Don't automatically select a turret when targeting a ship:

FS2 Open, 22.0: Uses FS1 behavior where targeting a new ship did not target any turrets. In FS2 a turret is automatically targeted.

• Syntax: Boolean
• Default Value: NO

$Supernova hits at zero:

FS2 Open, 22.2:

Adjusts the HUD timer so that the timer reaches zero when the supernova hits the player. The actual timing is not affected -- whether the flag is enabled or not, the supernova will always hit the player when 5 seconds remain in the time specified in the sexp.

• Syntax: Boolean
• Default Value: NO

$Always warn player about unbound keys used in Directives Gauge:

FS2 Open, 22.2:

Ensures that the "Key Unbound" message will pop up for a directive with an unbound key in any single-player mission, not just a training mission. Note, that the default string (index 426) will still say "Warning\nYou have no control bound to the action \"%s\". You must do so before you can continue with training." Thus, it is advised to change the string at index 426 using the -lcl.tbm to "Warning\nYou have no control bound to the action \"%s\". You must do so before you can continue with this mission."

• Syntax: Boolean
• Default Value: NO

#SEXP SETTINGS

This group contains SEXP settings and overrides.

$Loop SEXPs Then Arguments:

Flips how when-argument settings loop. See: SEXP Argument changes via mod.tbl

• Syntax: Boolean
• Default Value: NO

$Use Alternate Chaining Behavior:

When set, this allows all events in a chain to repeat, instead of only the last one. It makes the event chaining behavior act as people expected it to be in Mantis #82.

• Syntax: Boolean
• Default Value: NO

$Fixed Chaining To Repeating Events:

FS2 Open, 23.0: When set, this makes event chaining to repeated events work as designed - that is, the chained event will only be evaluated after the chain delay. If the repeating event's interval is shorter than the chain delay, then the delay countdown will continually be restarted until all repetitions have completed. Without this flag, FSO will emulate retail behavior which, due to a bug, allowed chained events to be evaluated immediately after a repeating event is first evaluated.

• Syntax: Boolean
• Default Value: NO

$Use host orientation for set-camera-facing:

FS2 Open, 22.0: When set, this will take into account the host orientation for cutscene cameras. This is a bugfix for GitHub issue #3889.

• Syntax: Boolean
• Default Value: NO

$Show-subtitle uses pixels:

FS2 Open, 22.2: When set, SEXPs which display subtitles will read their arguments as pixels, not percentages. If $Show-subtitle base resolution: is set, these pixels will be scaled up or down as needed.

• Syntax: Boolean
• Default Value: NO

$Show-subtitle base resolution:

FS2 Open, 22.2: When set, subtitles are assumed to display at the appropriate size in the specified resolution, and will be scaled up or down if the current screen resolution is different. If this is not set, or is set to a resolution less than (640, 480), subtitles will not be scaled.

• Syntax: (Integer, Integer)
• Default Value: (-1, -1)

#GRAPHICS SETTINGS

This group contains settings related to graphics.

$Enable External Shaders:

Enables the use of external shader files. By default, the engine will use the built-in shaders.

• Syntax: Boolean
• Default Value: NO

$Default Detail Level:

FS2 Open, 3.6.16:

Determines which graphics detail level preset (low, medium, high, very high) acts as the default for new pilots.

• Syntax: Integer (0-3)
• Default Value: 3 (very high)

$Briefing Window FOV:

FS2 Open, 3.7.2:

Determines the FOV in the briefing Icon window. Retail default for this is 0.29375; some previous versions of FSO used a value of 0.5.

• Syntax: Float (0.0 to 1.0)
• Default Value: 0.29375

$Generic Pain Flash Factor:

FS2 Open, 3.7.4:

Determines the intensity of the pain red flash when the player is hit.

• Syntax: Float
• Default Value: 1.0

$Shield Pain Flash Factor:

FS2 Open, 3.7.4:

Determines the intensity of a pain flash when the player's shields are hit. Color will match the current ships shield color defined in ships.tbl. A value of 0 will give retail behavior (no shield effect). Positive values will cause the effect to start at full intensity at full shields and go to next to no intensity at zero shields. Negative values will cause no effect at full shields and full effect at no shields. Values should be kept between -1.0 and 1.0 for good pilot visibility.

• Syntax: Float
• Default Value: 0.0

$BMPMAN Slot Limit:

FS2 Open, 19.0:

Determines the maximum number of textures that can be loaded simultaneously. This includes every frame of an animation, unless that animation is streaming (e.g. command briefing animations, message talking heads, etc). Also includes dynamically-created textures (used internally for various functions).

• Syntax: Int
• Values: Greater than or equal to 3500
• Default Value: 4750

$EMP Arc Color:

FS2 Open, 19.0:

Allows custom RGB color values to be set for the EMP lightning arc effect.

• +Primary Color Option 1:
  • The RGB color of the first primary color for the EMP lightning arc effect.
  • The actual lightning arc color shown in-game is randomly selected between the first and second primary color.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (64, 64, 5)
• +Primary Color Option 2:
  • The RGB color of the second primary color for the EMP lightning arc effect.
  • The actual lightning arc color shown in-game is randomly selected between the first and second primary color.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (128, 128, 10)
• +Secondary Color Option 1:
  • The RGB color of the secondary color for the EMP lightning arc effect.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (255, 255, 10)

$EMP Arc Width:

FS2 Open, 23.0:

Allows setting how the width is calculated for the EMP lightning arc effect.

• +Width Default:
  • The default width of the arc. This value will be multiplied by `+Width Radius Multiplier:` if the radius of the ship is less than or equal to `+Do Not Use Width Multiplier Over Radius:`.
  • Syntax: Float
  • Default value: 0.9
• +Width Radius Multiplier:
  • The value that the width is multiplied by if the radius of the ship is less than or equal to `+Do Not Use Width Multiplier Over Radius:`.
  • Syntax: Float
  • Default value: 0.01
• +Do Not Use Width Multiplier Over Radius:
  • If the object is larger than this radius, the `+Width Default:` value is used.
  • Syntax: Float
  • Default value: 500
• +Width Radius Minimum:
  • Minimum width that the arc can be. Any calculated widths lower than this value will be set to this value.
  • Syntax: Float
  • Default value: 0.2

$Damage Arc Color:

FS2 Open, 19.0:

Allows custom RGB color values to be set for the damage lightning arc effect.

• +Primary Color Option 1:
  • The RGB color of the first primary color for the damage lightning arc effect.
  • The actual lightning arc color shown in-game is randomly selected between the first and second primary color.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (64, 64, 255)
• +Primary Color Option 2:
  • The RGB color of the second primary color for the damage lightning arc effect.
  • The actual lightning arc color shown in-game is randomly selected between the first and second primary color.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (128, 128, 255)
• +Secondary Color Option 1:
  • The RGB color of the secondary color for the damage lightning arc effect.
  • Syntax: Color, (red, green, blue) respectively, integer value from 0 to 255
  • Default value: (64, 64, 5)

$Damage Arc Width:

FS2 Open, 23.0:

Allows setting how the width is calculated for the EMP lightning arc effect.

• +Width Default:
  • The default width of the arc. This value will be multiplied by `+Width Radius Multiplier:` if the radius of the ship is less than or equal to `+Do Not Use Width Multiplier Over Radius:`.
  • Syntax: Float
  • Default value: 0.9
• +Width Radius Multiplier:
  • The value that the width is multiplied by if the radius of the ship is less than or equal to `+Do Not Use Width Multiplier Over Radius:`.
  • Syntax: Float
  • Default value: 0.01
• +Do Not Use Width Multiplier Over Radius:
  • If the object is larger than this radius, the `+Width Default:` value is used.
  • Syntax: Float
  • Default value: 500
• +Width Radius Minimum:
  • Minimum width that the arc can be. Any calculated widths lower than this value will be set to this value.
  • Syntax: Float
  • Default value: 0.2

$Requires Rendering Feature:

FS2 Open, 21.0: Needs description

$Render player muzzle flashes in cockpit:

FS2 Open, 21.2:

Determines whether muzzle flashes will be shown within the cockpit view.

• Syntax: Boolean
• Default Value: False

$Glowpoint nebula visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which glowpoints are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.2

$Shield nebula visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which shield effects are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.2

$Thruster nebula visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which thruster flares are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.5

$Beams affected by nebula visibility:

FS2 Open, 21.2:

Determines whether beam weapons will be faded by nebula fog.

• Syntax: Boolean
• Default Value: False

+Constant visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which beam effects are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 4.0

+Scaled visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which the size of a beam effect affects its visibility. This is multiplied by the radius of the beam and added to the above for the final value. This results in larger beams being visible from farther away.
• Syntax: Float
• Default Value: 0.1

$Weapons affected by nebula visibility:

FS2 Open, 21.2:

Determines whether lasers, missiles, countermeasures, etc will be faded by nebula fog.

• Syntax: Boolean
• Default Value: False

+Weapon visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which laser-type weapons are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.3

+$Trail visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which trails (weapon and ship contrails) are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.0

+Shockwave visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which shockwave effects are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 2.5

$Particles affected by nebula visibility:

FS2 Open, 21.2:

Determines whether particle effects, including impact effects, will be faded by nebula fog.

• Syntax: Boolean
• Default Value: False

+Constant visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which particle effects are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.0

+Scaled visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which the size of a particle effect affects its visibility. This is multiplied by the radius of the particle and added to the above for the final value. This results in larger particles being visible from farther away.
• Syntax: Float
• Default Value: 0.08

$Fireballs affected by nebula visibility:

FS2 Open, 21.2:

Determines whether fireballs from ship explosions will be faded by nebula fog.

• Syntax: Boolean
• Default Value: False

+Constant visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which fireballs are affected by nebula fog. 1.0 is exactly the same as regular ship hull obscurity, higher means they stay visible for longer.
• Syntax: Float
• Default Value: 1.2

+Scaled visibility factor:

FS2 Open, 22.0:

• Specifies the degree to which the size of a fireball affects its visibility. This is multiplied by the radius of the fireball and added to the above for the final value. This results in larger fireballs being visible from farther away.
• Syntax: Float
• Default Value: 0.08

$$Shadow Quality Default:

FS2 Open, 22.0:

Sets the default level for shadow quality if the 'enable_shadows' command line is used and 'shadow_quality' is not used. By default, the FSO will set the shadow detail level to 2. Valid values are 0 (shadows disabled), 1 (Low, 512x512 shadow map), 2 (Medium, 1024x1024 shadow map), 3 (High, 2048x2048 shadow map), or 4 (Ultra, 4096x4096). Note, the command line 'shadow_quality' will override any value set here.

• Syntax: Integer
• Default Value: 2

$Shadow Cascade Distances:

FS2 Open, 21.4:

Sets the distances that the shadow map for the game scene uses. Float values must all be greater than 0 and successively larger than each consecutive value.

• Syntax: List of floats
• Default Value: (200.0, 600.0, 2500.0, 8000.0)

$Shadow Cascade Distances Cockpit:

FS2 Open, 21.4:

Sets the distances that the shadow map for the cockpit pass scene uses. Will only shadow the cockpit model, and does not interact with the external game scene shadow map. Float values must all be greater than 0 and successively larger than each consecutive value.

• Syntax: List of floats
• Default Value: (0.25, 0.75, 1.5, 3.0)

$Shadow Disable Techroom:

FS2 Open, 23.0:

Disables shadows on ships in the techroom.

• Syntax: Boolean

$Shadow Disable Cockpit:

FS2 Open, 23.0:

Disables shadows on the player cockpit in mission.

• Syntax: Boolean

$Shadow Disable Brief Weapons:

FS2 Open, 23.0:

Disables shadows on weapons in the mission briefing.

• Syntax: Boolean

$Shadow Disable Brief Ships:

FS2 Open, 23.0:

Disables shadows on ships in the mission briefing.

• Syntax: Boolean

$Show Ship Casts Shadow:

FS2 Open, 23.0:

When cockpit shadows are enabled, enabling this setting will cause the players ship model shown with "show ship" to cast shadow onto the cockpit.

• Syntax: Boolean

$Ship Model And Cockpit Share Coordinate Space:

FS2 Open, 23.0:

When having the "show ship" flag enabled and cockpit models for a ship, this flag should be on if the cockpits can fit into the actual geometry of the ship model. Disable this flag if this is not the case and the cockpit needs to be rendered on top of the ship regardless of actual coordinates. If this can be enabled, the external show ship model can be rendered using deferred rendering.

• Syntax: Boolean

$Minimum Pixel Size Thrusters:

FS2 Open, 22.0:

• Specifies the smallest pixel size that thrusters will be rendered. Setting this > 0 can be expensive in larger missions.
• Syntax: Float
• Default Value: 0.0

$Minimum Pixel Size Beams:

FS2 Open, 22.0:

• Specifies the smallest pixel size that beams will be rendered. Setting this > 0 can be expensive in larger missions.
• Syntax: Float
• Default Value: 0.0

$Minimum Pixel Size Muzzle Flashes:

FS2 Open, 22.0:

• Specifies the smallest pixel size that muzzle flashes will be rendered. Setting this > 0 can be expensive in larger missions.
• Syntax: Float
• Default Value: 0.0

$Minimum Pixel Size Trails:

FS2 Open, 22.0:

• Specifies the smallest pixel size that trails will be rendered. Setting this > 0 can be expensive in larger missions.
• Syntax: Float
• Default Value: 0.0

$Minimum Pixel Size Lasers:

FS2 Open, 22.0:

• Specifies the smallest pixel size that lasers will be rendered. Setting this > 0 can be expensive in larger missions.
• Syntax: Float
• Default Value: 0.0

#NETWORK SETTINGS

This group contains network-related settings

$FS2NetD port:

• (description required)

$Default object update level for multiplayer:

FS2 Open, 22.0:

Sets the distances default object update rate for multiplayer matches. By default, the FSO will set the object update level to 2. Valid values are 0 (Low), 1 (Medium), 2 (High), 3 (LAN). FSO caps the bandwidth it uses based on these settings, but they were designed for connections from 1999. LAN has the least restrictive limits and does not require an actual LAN connection. Also, if a player's connection is within the dial-up speed range then game auto force the use of the lowest level during a match.

• Syntax: Integer
• Default Value: 2

#SOUND SETTINGS

This group contains sound-related settings

$Default Sound Volume:

FS2 Open, 3.7.2:

• Defines the default sound fx volume for new pilots.
• Syntax: Float, between 0.0 and 1.0
• Default Value: 1.0

$Default Music Volume:

FS2 Open, 3.7.2:

• Defines the default music volume for new pilots.
• Syntax: Float, between 0.0 and 1.0
• Default Value: 0.5

$Default Voice Volume:

FS2 Open, 3.7.2:

• Defines the default voice volume for new pilots.
• Syntax: Float, between 0.0 and 1.0
• Default Value: 0.7

$Use weapon class impact sounds for hits to player:

FS2 Open, 23.0:

Allows weapons that hit the player to play their specific impact sounds, not the hard-coded default sounds.

• Syntax: Boolean

#FRED SETTINGS

This group contains settings for FRED.

$Disable Hard Coded Message Head Ani Files:

FS2 Open, 3.7.2:

If set, FRED will not fill the head ani selection in the Event Editor with the retail head ani filenames.

• Syntax: Boolean
• Default Value: NO

$Add Message Head Ani Files:

FS2 Open, 23.0: FRED will append each +Head entry listed below to the head ani selection list in the Event Editor.

+Head:

FS2 Open, 23.0:

The head ani filename to add. Extensions will be stripped if included.

• Syntax: +Head: String

$Enable scripting in FRED:

FS2 Open, 19.0:

If set, scripting will be enabled in FRED. Use with extreme caution. The effects of scripts on FRED have not been fully tested. You can check if a script is running in FRED by using ba.inMissionEditor().

• Default Value: NO

$FRED Briefing window resolution:

FS2 Open, 23.0:

The width and height of the briefing window in FRED. Defaults to 888x371. Note that changing this only affects FRED and can cause a mismatch to the ingame briefing view which defaults to 888x371 (or 555x232 for 640 base res).

• Syntax: integer, integer
• Default Value: 888,371

$FRED spacemouse nonlinearities:

FS2 Open, 23.2:

Allows setting custom nonlinearities and scaling for controlling FRED with a spacemouse.

+Sideways exponent:

The exponent for input for Sideways spacemouse motion.

• Syntax: float
• Default Value: 1

+Sideways scale:

The multiplier for input for Sideways spacemouse motion.

• Syntax: float
• Default Value: 1

+Forwards exponent:

The exponent for input for Forwards spacemouse motion.

• Syntax: float
• Default Value: 1

+Forwards scale:

The multiplier for input for Forwards spacemouse motion.

• Syntax: float
• Default Value: 1

+Upwards exponent:

The exponent for input for Upwards spacemouse motion.

• Syntax: float
• Default Value: 1

+Upwards scale:

The multiplier for input for Upwards spacemouse motion.

• Syntax: float
• Default Value: 1

+Pitch exponent:

The exponent for input for Pitch spacemouse rotation.

• Syntax: float
• Default Value: 1

+Pitch scale:

The multiplier for input for Pitch spacemouse rotation.

• Syntax: float
• Default Value: 1

+Bank exponent:

The exponent for input for Bank spacemouse rotation.

• Syntax: float
• Default Value: 1

+Bank scale:

The multiplier for input for Bank spacemouse rotation.

• Syntax: float
• Default Value: 1

+Heading exponent:

The exponent for input for Heading spacemouse rotation.

• Syntax: float
• Default Value: 1

+Heading scale:

The multiplier for input for Heading spacemouse rotation.

• Syntax: float
• Default Value: 1

#OTHER SETTINGS

This group contains miscellaneous settings.

$Fixed Turret Collisions:

Makes all hits to a turret's barrels count as hits to the turret subsystem. By default, this does not happen unless the point of impact falls inside the model radius of the turret's base.

• Syntax: Boolean
• Default Value: NO

$Fixed Missile Detonation:

FS2 Open, 22.0:

• When this flag is set, missiles which reach the center of a submodel will not detonate immediately; they will delay detonation until they have traveled another radius of the submodel.
• Syntax: Boolean
• Default Value: False

$Damage Impacted Subsystem First:

If set, a hit to a physical subsystem will always deal damage to that subsystem first, even if another subsystem is closer to the point of impact. By default, the closest subsystem will always receive damage first.

• Syntax: Boolean
• Default Value: NO

$Use 3d ship select:

FS2 Open, 23.0:

• Whether or not to use 3D models for ship select instead of animations
• Syntax: Boolean
• Default Value: False

$Default ship select effect:

FS2 Open, 3.6.16:

• This specifies which effect to use for ship select animations when no .ani can be found, or the 3d ship select effect is active. This will default to the FS2 effect.
• Syntax: String
• Possible options are "FS2", "FS1", and "off"

$Use 3d ship icons:

FS2 Open, 23.0:

• Whether or not to use 3D models for ships in ship/weapon select instead of icons
• Syntax: Boolean
• Default Value: False

$Use 3d weapon select:

FS2 Open, 23.0:

• Whether or not to use 3D models for weapon select instead of animations
• Syntax: Boolean
• Default Value: False

$Default weapon select effect:

FS2 Open, 3.6.16:

• This specifies which effect to use for weapon select animations when no .ani can be found, or the 3d weapon select effect is active. This will default to the FS2 effect.
• Syntax: String
• Possible options are "FS2", "FS1", and "off"

$Use 3d weapon icons:

FS2 Open, 23.0:

• Whether or not to use 3D models for weapons in weapon select instead of icons
• Syntax: Boolean
• Default Value: False

$Use 3d overhead ship:

FS2 Open, 23.0:

• Whether or not to use 3D models for ship overhead view instead of a bitmap in weapon select
• Syntax: Boolean
• Default Value: False

$Default overhead ship style:

FS2 Open, 23.0:

• This specifies which style of overhead view to use if 3d overhead view is active
• Syntax: String
• Possible options are "ROTATE" or "TOPVIEW"

$Weapons inherit parent collision group:

FS2 Open, 3.6.16:

• When set to true, Weapons fired by a ship will inherit their parents' collision group setting.
• Syntax: Boolean
• Default Value: NO

$Flight controls follow eyepoint orientation:

FS2 Open, 3.7.2:

• Specifies that if the player ship's eyepoint happens to rotate into a non-standard orientation, pitch and yaw axes should stay relative to the eyepoint orientation, not the ship. Note that this does not affect the pitch/yaw turning speed, which always remains relative to the ship.
• Syntax: Boolean
• Default Value: NO

$Beams Use Damage Factors:

FS2 Open, 3.7.2:

• Specifies that beam weapons will use the tabled damage factors for Armour, Shields and Subsystems. Default is false (i.e. all factors are treated as 1.0)
• Syntax: Boolean
• Default Value: NO

$Default fiction viewer UI:

FS2 Open, 3.7.4:

• Specifies which fiction viewer layout to use in missions that don't specify one. Possible values are as follows:
  • "FS2": Standard layout. Requires (2_)fictionviewer and (2_)fictionviewer-m to be present in data\interface.
  • "WCS": Moves the "Accept" button to the lower-left corner of the screen. Requires (2_)fictionviewerb and (2_)fictionviewer-mb to be present in data\interface.
  • "auto": Selects "WCS" if the appropriate files are present; otherwise, selects "FS2". This is the default setting.

$Movie subtitle font:

FS2 Open, 19.0:

• Specifies which font should be used for displaying subtitles in the cutscene player. This should be the name given to this font in the fonts table. Since movie subtitles can contain Unicode text it is a good idea to enable Unicode mode when movie subtitles are used but this is not enforced by this option.
• Syntax: String

$Disable built-in translations:

FS2 Open, 19.0:

• Turns off hard-coded translations, e.g. Transport -> Transporter in German. All strings will either use their XSTR entry or else not be translated.
• Syntax: Boolean
• Default Value: NO

$Weapon shockwave damage respects huge ship flags:

FS2 Open, 19.0:

• Controls whether weapon shockwaves will respect the huge/supercap ship flags. In retail they do not.
• Syntax: Boolean
• Default Value: NO

$Enable external default scripts:

FS2 Open, 19.0:

• Enables the loading of external scripts with the same name as a built-in script. Otherwise, uses the version of the script included in the executable (currently, just cfile_require.lua).
• Syntax: Boolean
• Default Value: NO

$Player warpout speed:

FS2 Open, 19.0:

• Defines the speed the player must reach to warp out.
• Syntax: Float
• Default Value: 40.0

$Target warpout match percent:

FS2 Open, 19.0:

• Defines how close to the warpout speed the player needs to be to actually warp out.
• Syntax: Float, between 0.0 and 1.0
• Default Value: 0.05 (5%)

$Minimum player warpout time:

FS2 Open, 19.0:

• The default amount of time, in seconds, warping out will take before actually starting to check whether the player is the right speed.
• Syntax: Float
• Default Value: 3.0

$Enable in-game options:

FS2 Open, 19.0:

• Experimental mode whereby various settings can be modified by FSO while it's still running, rather than being set by the launcher before execution. Requires custom assets for the in-game options menu to actually be able to change the settings.
• Syntax: Boolean
• Default Value: NO

$Dinky Shockwave Default Multiplier:

FS2 Open, 19.0:

• Amount of damage, as a multiple of normal shockwave damage, assigned to a weapon's dinky shockwave by default. To get the same behavior FSO had from 2005-2019, set this to 0.25.
• Syntax: Float
• Default Value: 1.0

$Shockwaves Always Damage Bombs:

FS2 Open, 21.0:

• Enables all bombs being damaged by shockwaves. Previously only those marked with flags could be damaged.
• Syntax: Boolean
• Default Value: False

$Shockwaves Damage All Object Types Once:

FS2 Open, 21.0:

• Keeps any object from being damaged more than once by a shockwave. The default behavior is for asteroids and flagged missiles to be damaged every frame by the shockwave.
• Syntax: Boolean
• Default Value: False

$Shockwaves Inherit Parent Weapon Damage Type:

FS2 Open, 23.0:

• When enabled, the shockwaves of weapons that have a defined damage type automatically inherit that damage type, rather than dealing "typeless" damage. As this behavior is more intuitive than when this flag is disabled, mods targeting 22.4 or newer versions of FSO will have it enabled by default.
• Syntax: Boolean
• Default Value: True for mods targeting 22.4 or newer versions of FSO, otherwise False

$Inherited Shockwave Damage Type Added Suffix:

FS2 Open, 23.0:

• When combined with "$Shockwaves Inherit Parent Weapon Damage Type:", this string is added to the inherited damage type to define the shockwave's damage type. For example, if a weapon has the damage type "heavy" and the provided suffix is "-shock", then that weapon's shockwave's damage type would default to "heavy-shock".
• Note: When defined, this also implicitly sets the equivalent value for dinky shockwaves, below.
• Syntax: String

$Inherited Dinky Shockwave Damage Type Added Suffix:

FS2 Open, 23.0:

• The same as "$Inherited Shockwave Damage Type Added Suffix:", except specifically for "dinky" shockwaves.
• Syntax: String

$Default Shockwave Damage Type:

FS2 Open, 23.0:

• If a weapon's shockwave doesn't have a damage type set, it will have this damage type instead (when "$Shockwaves Inherit Parent Weapon Damage Type:" is enabled, this will only be used if the weapon itself also doesn't have a damage type set).
• Note: When defined, this also implicitly sets the equivalent value for dinky shockwaves, below.
• Syntax: Boolean
• Default Value: NO

$Default Dinky Shockwave Damage Type:

FS2 Open, 23.0:

• The same as "$Default Shockwave Damage Type:", except specifically for "dinky" shockwaves.
• Syntax: Boolean
• Default Value: NO

$Use Engine Wash Intensity:

FS2 Open, 19.0:

• Allows the game to use the Intensity value when calculating Engine Wash effects.
• Syntax: Boolean
• Default Value: NO

$Apply HUD shudder to chase view:

FS2 Open, 23.2:

• Applies hud shudder (afterburner and engine wash) also to chase view. Does not override the command line toggle.
• Syntax: Boolean
• Default Value: NO

$Swarmers Lead Targets:

FS2 Open, 21.0:

• Causes swarm missiles to lead their targets by default, and will make use of Target Lead Scaler if specified, like normal aspect seekers.
• Syntax: Boolean
• Default Value: NO

$Damage Threshold for Weapons Subsystems to Trigger Turret Inaccuracy:

FS2 Open, 21.0:

• Specifies the damage threshold for when turrets become less accurate due to weapon subsystem damage. In other words, how damaged do a ship's aggregated weapons systems have to be before the turrets become inaccurate? Value must be between 0.0-1.0 (includes 0.0 and 1.0).
• Syntax: Float
• Default Value: 0.7

$AI use framerate independent turning:

FS2 Open, 21.0:

• Without this flag, missiles turn rate is directly dependent on the current framerate. When enabled their turn rate will be consistent, with the "true" turning taken to be observed turning at 60fps. This flag also affects ships, but the instability is only apparent at extremely low framerates, and so the change will not be apparent.
• Syntax: Boolean
• Default Value: True

+AI respect tabled turn time and rotdamp:

FS2 Open, 21.0:

• Due to complicated physics issues caused by retail not using the above method, tabled turn times on ships and missiles are not representative of actual observed turn times. The above flag makes it consistent, but this flag will make it accurate to what is actually listed in the table.
• Additionally, rotdamp is now used properly by the AI in a similar manner to players. More rotdamp will result in slower rotational acceleration, and less results in faster acceleration.
• NOTE: BEWARE OF ADDING THIS FLAG TO AN EXISTING MODPACK. NEARLY EVERY SINGLE TURN TIME WILL NEED TO BE CHANGED.
• Syntax: Boolean
• Default Value: False

$Player starts in third person/chase view by default:

FS2 Open, 21.2:

• When this flag is set, a player will start the mission in the chase view, not in the cockpit view.
• Syntax: Boolean
• Default Value: False

$Custom briefing icons always override standard icons:

FS2 Open, 21.4:

• Custom ship briefing icons will always be shown when the briefing icon is a ship, but not when it is a non-ship icon such as a planet. Set this flag to use custom briefing icons in all cases.
• Syntax: Boolean
• Default Value: False

$Enable discord rich presence:

FS2 Open, 23.0:

• Enables or disables the built-in Discord game-status reporting.
• Syntax: Boolean
• Default Value: True

$Always hide hidden ships in hotkey list:

FS2 Open, 23.0:

• Whether or not to always hide ships with HIDDEN hotkey (set in FRED), even in the in-mission hotkey menu.
• Syntax: Boolean
• Default Value: False

#END

Required. The last line of the table must be #END

Sample Entry

   #CAMPAIGN SETTINGS
   $Default Campaign File Name: NewCampaignFile
   
   #Ignored Campaign File Names
   $Campaign File Name: FreeSpace2.fc2
   
   #HUD SETTINGS
   $Directive Wait Time: 5000
   
   #SEXP SETTINGS
   $Loop SEXPs Then Arguments: True
   
   #OTHER SETTINGS
   $Fix Turret Collisions: True
   
   #END