default_settings.tbl

Revision information OFP Revision: #135 Set the revision to your PR when your PR changes what this page documents. Leave it alone for edits that only fix or improve the documentation.

The default_settings.tbl sets the default values of the game's options (the in-game options menu): the values used on first launch, or for any option the player hasn't changed and saved. It can also lock an option to its default and hide it from the menu.

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

Code: /options/default_settings_table.cpp. See Tables for every table.

Badges show the version a field or behavior was added in.

Contents

1. Format
2. $Option Key:
3. Options
4. Sample

Field index (every field, one per line in table order; click one to jump to it)

$Option Key:

• +Value:
• +Enforce

---

Format

• The table begins with #DEFAULT SETTINGS (optional) and ends with #END.
• In between, any number of $Option Key: entries, in any order.
• An option set again by a later table replaces the earlier value.

$Option Key:

• The key of the option, from the list below. Not case sensitive.
• A key that doesn't exist is only noted in the log and skipped. This is on purpose: an option may be missing in some builds or modes (for example, the window mode option in VR) and the table still works.
• An option that can't take a default value (listed at the end of the options) logs a warning and is skipped.
• Syntax: String

+Value:

• Required. The default value, in the format the option's row shows. A value that isn't valid logs a warning and the option keeps its built-in default.

+Enforce

• Optional, after +Value:. Also accepted as +Enforced.
• Locks the option to this value: the player's saved value is ignored and the option is removed from the options menu.
• Options marked retail below are also in the original game's options screen, which can't hide them, so they can't be enforced; trying logs a warning.

Options

Values:

• Boolean: YES or NO.
• Detail list: four integers from 0 to 4 in parentheses, the value this option takes in each of the detail presets, from lowest to highest: ( 1 2 3 4 ). A value outside 0 to 4 logs a warning and that preset keeps its default.
• Text values are not case sensitive.

Key	Option in the menu	Value	Version
Audio.Effects	Effects (retail)	Float, 0 to 1 (clamped)
Audio.Music	Music (retail)	Float, 0 to 1 (clamped)
Audio.Voice	Voice (retail)	Float, 0 to 1 (clamped)
Game.FlightCursorDeadzone	Flight Cursor Deadzone	Float, radians, 0 to 0.349 (clamped)
Game.FlightCursorExtent	Flight Cursor Extent	Float, radians, 0 to 0.698 (clamped)
Game.FlightMode	Flight Mode	Text: ship locked, flight cursor
Graphics.3DShockwaves	Shockwaves	Boolean
Graphics.AAMode	Anti Aliasing	Text: none, fxaa low, fxaa medium, fxaa high, smaa low, smaa medium, smaa high, smaa ultra
Graphics.BloomIntensity	Bloom intensity	Integer, 0 to 200 (clamped)
Graphics.CockpitFOV	Cockpit Field Of View	Float, radians, 0.436 to 1.5708 (25 to 90 degrees, clamped)
Graphics.CockpitFOVToggle	Cockpit FOV Toggle	Boolean
Graphics.DeferredCockpitLighting	Deferred Cockpit Lighting	Boolean
Graphics.DeferredLighting	Deferred Lighting	Boolean
Graphics.Detail	Model Detail (retail)	Detail list
Graphics.FOV	Field Of View	Float, radians, 0.436 to 1.5708 (25 to 90 degrees, clamped)
Graphics.Gamma	Brightness (retail)	Float, 0.1 to 5.0 in steps of 0.05
Graphics.HDR	HDR Output	Boolean
Graphics.HDRPaperWhite	HDR Paper White	Float, nits
Graphics.HDRPeakLuminance	HDR Peak Luminance	Float, nits
Graphics.Lighting	Lighting (retail)	Detail list
Graphics.Lightshafts	Lightshafts	Boolean
Graphics.MSAASamples	Multisample Anti Aliasing	Text: off, 4 samples, 8 samples
Graphics.MotionDebris	Motion Debris	Boolean
Graphics.NebulaDetail	Nebula Detail (retail)	Detail list
Graphics.Particles	Particles (retail)	Detail list
Graphics.PostProcessing	Post processing	Boolean
Graphics.RenderAPI	Render API	Text: opengl, vulkan
Graphics.ShadowRenderMethod	Shadow Method	Text: shadow map (or shadow maps), raytraced
Graphics.Shadows	Shadow Quality	Text: disabled, low, medium, high, ultra
Graphics.ShieldEffects	Shield Hit Effects (retail)	Detail list
Graphics.SmallDebris	Impact Effects (retail)	Detail list
Graphics.SoftParticles	Soft Particles	Boolean
Graphics.Stars	Stars (retail)	Detail list
Graphics.Sunglare	Sunglare	Boolean
Graphics.Texture	3D Hardware Textures (retail)	Detail list
Graphics.TextureFilter	Texture Filtering	Text: bilinear, trilinear
Graphics.VSync	Vertical Sync	Boolean
Graphics.WindowMode	Window Mode	Text: windowed, borderless, fullscreen

These options exist but can't take a default value from this table: Audio.BriefingVoice, Audio.CaptureDevice, Audio.EnableEFX, Audio.PlaybackDevice, Game.BriefIconScaleFactor, Game.Discord, Game.FontScaleFactor, Game.IffAccessibility, Game.Language, Graphics.Anisotropy, Graphics.Display, Graphics.MaxRtShadowLights, Graphics.MaxRtShadowLocalLights, Graphics.RTShadowQuality, Graphics.Resolution, Graphics.ResolutionVR, Graphics.RtShadowBiasMax, Graphics.RtShadowBiasMin, HUD.Radar2dIconMode, Input.FFStrength, Input.ForceFeedback, Input.HitEffect, Input.Joystick, Input.Joystick1, Input.Joystick2, Input.Joystick3, Input.JoystickDeadZone, Input.JoystickSensitivity, Input.MouseSensitivity, Input.UseMouse, Multi.FlushCache, Multi.LocalBroadcast, Multi.TogglePXO, Multi.TransferMissions, Speech.Briefing, Speech.Ingame, Speech.Multi, Speech.Rate, Speech.Techroom, Speech.Volume.

Sample

#DEFAULT SETTINGS

$Option Key: Graphics.AAMode
+Value: smaa high

$Option Key: Audio.Music
+Value: 0.6

$Option Key: Graphics.Lighting
+Value: ( 1 2 3 4 )

$Option Key: Game.FlightMode
+Value: flight cursor
+Enforce

#END