Game settings.tbl
| This feature requires FreeSpace Open |
Revision information.....
- FSO Git Commit: Date: 2015-12-03 SHA: 5d8f779
The game_settings.tbl, also known as mod.tbl, defines options that can be changed globally.
This table is one of the Modular Tables and can be extended with xxx-mod.tbm
Contents
#GAME SETTINGS
Optional. Contains settings that affect how the engine works.
$Target Version:
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.
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:
Required. Sets the major component of the target version.
- Syntax: Integer
- Example: 3 (for a minimum version of 3.7.3.20151121)
+Minor:
Required. Sets the minor component of the target version.
- Syntax: Integer
- Example: 7 (for a minimum version of 3.7.3.20151121)
+Build:
Required. Sets the build component of the target version.
- Syntax: Integer
- Example: 3 (for a minimum version of 3.7.3.20151121)
+Revision:
Optional. 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:
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
$Unicode mode:
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
#CAMPAIGN SETTINGS
Optional. 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
Optional. Defines which campaigns, if present, will not appear in the Campaign Room. Only single-player campaigns can be ignored. File extensions are required.
$Campaign File Name:
File name of the campaign to ignore. Multiple entries may exist.
- Syntax: String
$Red-alert applies to delayed ships:
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
Optional. 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.
#SEXP SETTINGS
Optional. 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 makes the event chaining behavior act as people expected it to be in Mantis #82.
- Syntax: Boolean
- Default Value: NO
#GRAPHICS SETTINGS
Optional. 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:
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:
Determines the FOV in the briefing Icon window. Retail default for this is 0.29375, 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:
Determines the intensity of the pain red flash when the player is hit.
- Syntax: Float
- Default Value: 1.0
$Shield Pain Flash Factor:
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:
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
#SOUND SETTINGS
Optional. This group contains sound-related settings
$Default Sound Volume:
- Defines the default sound fx volume for new pilots.
- Syntax: Float, between 0.0 and 1.0
- Default Value: 1.0
$Default Music Volume:
- Defines the default music volume for new pilots.
- Syntax: Float, between 0.0 and 1.0
- Default Value: 0.5
$Default Voice Volume:
- Defines the default voice volume for new pilots.
- Syntax: Float, between 0.0 and 1.0
- Default Value: 0.7
#FRED SETTINGS
Optional. This group contains settings for FRED.
$Disable Hard Coded Message Head Ani Files:
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
#OTHER SETTINGS
Optional. 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
$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
$Default ship select effect:
- This specifies which effect to use for ship select animations when no .ani can be found, or the -ship_choice_3d commandline flag is active. This will default to the FS2 effect.
- Possible options are "FS2", "FS1", and "off"
$Default weapon select effect:
- This specifies which effect to use for weapon select animations when no .ani can be found, or the -weapon_choice_3d commandline flag is active. This will default to the FS2 effect.
- Possible options are "FS2", "FS1", and "off"
$Weapons inherit parent collision group:
- When set to true, Weapons fired by a ship will inherit their parents' collision group setting. Default is false.
$Flight controls follow eyepoint orientation:
- 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. Default is false.
$Beams Use Damage Factors:
- 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)
$Default fiction viewer UI:
- 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.
#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
