Skip to content
FiveLaunch FiveLaunch

GTA settings XML

This page documents the gta5_settings.xml format FiveLaunch manages.

FiveLaunch typically reads/writes this file at:

  • %APPDATA%\\CitizenFX\\gta5_settings.xml (most common)
  • %LOCALAPPDATA%\\CitizenFX\\gta5_settings.xml (some installs)
  • FiveM.app/settings.xml (some launch flows)

Example file (template)

Section titled “Example file (template)”

This is the template shipped in this repo at src/content/docs/reference/settings-template.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Settings>
  <configSource>SMC_USER</configSource>
  <version value="27"></version>
  <graphics>
    <Tessellation value="1"></Tessellation>
    <LodScale value="0.5"></LodScale>
    <PedLodBias value="0.200000"></PedLodBias>
    <VehicleLodBias value="0.000000"></VehicleLodBias>
    <ShadowQuality value="0"></ShadowQuality>
    <ReflectionQuality value="0"></ReflectionQuality>
    <ReflectionMSAA value="2"></ReflectionMSAA>
    <SSAO value="0"></SSAO>
    <AnisotropicFiltering value="0"></AnisotropicFiltering>
    <MSAA value="0"></MSAA>
    <MSAAFragments value="0"></MSAAFragments>
    <MSAAQuality value="0"></MSAAQuality>
    <SamplingMode value="0"></SamplingMode>
    <TextureQuality value="0"></TextureQuality>
    <ParticleQuality value="0"></ParticleQuality>
    <WaterQuality value="0"></WaterQuality>
    <GrassQuality value="0"></GrassQuality>
    <ShaderQuality value="0"></ShaderQuality>
    <Shadow_SoftShadows value="5"></Shadow_SoftShadows>
    <UltraShadows_Enabled value="false"></UltraShadows_Enabled>
    <Shadow_ParticleShadows value="false"></Shadow_ParticleShadows>
    <Shadow_Distance value="2.000000"></Shadow_Distance>
    <Shadow_LongShadows value="false"></Shadow_LongShadows>
    <Shadow_SplitZStart value="0.930000"></Shadow_SplitZStart>
    <Shadow_SplitZEnd value="0.890000"></Shadow_SplitZEnd>
    <Shadow_aircraftExpWeight value="0.990000"></Shadow_aircraftExpWeight>
    <Shadow_DisableScreenSizeCheck value="false"></Shadow_DisableScreenSizeCheck>
    <Reflection_MipBlur value="false"></Reflection_MipBlur>
    <FXAA_Enabled value="false"></FXAA_Enabled>
    <TXAA_Enabled value="false"></TXAA_Enabled>
    <Lighting_FogVolumes value="false"></Lighting_FogVolumes>
    <Shader_SSA value="false"></Shader_SSA>
    <DX_Version value="2"></DX_Version>
    <CityDensity value="1.000000"></CityDensity>
    <PedVarietyMultiplier value="1.000000"></PedVarietyMultiplier>
    <VehicleVarietyMultiplier value="1.000000"></VehicleVarietyMultiplier>
    <PostFX value="0"></PostFX>
    <DoF value="false"></DoF>
    <HdStreamingInFlight value="false"></HdStreamingInFlight>
    <MaxLodScale value="1.000000"></MaxLodScale>
    <MotionBlurStrength value="0.000000"></MotionBlurStrength>
  </graphics>
  <system>
    <numBytesPerReplayBlock value="9000000"></numBytesPerReplayBlock>
    <numReplayBlocks value="30"></numReplayBlocks>
    <maxSizeOfStreamingReplay value="1024"></maxSizeOfStreamingReplay>
    <maxFileStoreSize value="65536"></maxFileStoreSize>
  </system>
  <audio>
    <Audio3d value="false"></Audio3d>
  </audio>
  <video>
    <AdapterIndex value="0"></AdapterIndex>
    <OutputIndex value="0"></OutputIndex>
    <ScreenWidth value="2560"></ScreenWidth>
    <ScreenHeight value="1440"></ScreenHeight>
    <RefreshRate value="239"></RefreshRate>
    <Windowed value="2"></Windowed>
    <VSync value="0"></VSync>
    <Stereo value="false"></Stereo>
    <Convergence value="0.100000"></Convergence>
    <Separation value="1.000000"></Separation>
    <PauseOnFocusLoss value="1"></PauseOnFocusLoss>
    <AspectRatio value="5"></AspectRatio>
  </video>
</Settings>

Template breakdown (line-by-line)

Section titled “Template breakdown (line-by-line)”

This table lists every <Setting value="…" /> entry that appears in the template, along with the allowed values from the mapping.

XML elementTemplate valueMeaning / allowed values
<version value="…" />27Free text / numeric (depends on GTA)
<Tessellation value="…" />1
Normal
  • 0 — Off
  • 1 — Normal
  • 2 — High
  • 3 — Very High
<LodScale value="…" />0.50 … 1 (step 0.1)
<PedLodBias value="…" />0.2000000 … 1 (step 0.1)
<VehicleLodBias value="…" />0.0000000 … 1 (step 0.1)
<ShadowQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<ReflectionQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<ReflectionMSAA value="…" />2
x2
  • 0 — Off
  • 2 — x2
  • 4 — x4
  • 8 — x8
<SSAO value="…" />0
Off
  • 0 — Off
  • 1 — Normal
  • 2 — High
<AnisotropicFiltering value="…" />0
Off
  • 0 — Off
  • 1 — x1
  • 2 — x2
  • 4 — x4
  • 8 — x8
  • 16 — x16
<MSAA value="…" />0
Off
  • 0 — Off
  • 2 — 2x MSAA
  • 4 — 4x MSAA
  • 8 — 8x MSAA
<MSAAFragments value="…" />0
Off
  • 0 — Off
  • 1 — On
<MSAAQuality value="…" />0
Low
  • 0 — Low
  • 1 — Medium
  • 2 — High
<SamplingMode value="…" />0
MSAA
  • 0 — MSAA
  • 1 — AMD CAS
  • 2 — NVIDIA DLSS
  • 3 — FSR
<TextureQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<ParticleQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<WaterQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<GrassQuality value="…" />0
Very Low
  • 0 — Very Low
  • 1 — Low
  • 2 — Medium
  • 3 — High
  • 4 — Very High
<ShaderQuality value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<Shadow_SoftShadows value="…" />5
Sharper
  • 0 — Softest
  • 1 — Softer
  • 2 — Soft
  • 3 — Medium
  • 4 — Sharp
  • 5 — Sharper
<UltraShadows_Enabled value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Shadow_ParticleShadows value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Shadow_Distance value="…" />2.0000000 … 2 (step 0.1)
<Shadow_LongShadows value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Shadow_SplitZStart value="…" />0.9300000.5 … 1 (step 0.01)
<Shadow_SplitZEnd value="…" />0.8900000.5 … 1 (step 0.01)
<Shadow_aircraftExpWeight value="…" />0.9900000.9 … 1 (step 0.01)
<Shadow_DisableScreenSizeCheck value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Reflection_MipBlur value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<FXAA_Enabled value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<TXAA_Enabled value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Lighting_FogVolumes value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Shader_SSA value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<DX_Version value="…" />2
DirectX 11
  • 0 — DirectX 10
  • 1 — DirectX 10.1
  • 2 — DirectX 11
<CityDensity value="…" />1.0000000 … 1 (step 0.1)
<PedVarietyMultiplier value="…" />1.0000000 … 1 (step 0.1)
<VehicleVarietyMultiplier value="…" />1.0000000 … 1 (step 0.1)
<PostFX value="…" />0
Normal
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<DoF value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<HdStreamingInFlight value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<MaxLodScale value="…" />1.0000000 … 1 (step 0.1)
<MotionBlurStrength value="…" />0.0000000 … 1 (step 0.1)
<numBytesPerReplayBlock value="…" />9000000Free text / numeric (depends on GTA)
<numReplayBlocks value="…" />30Free text / numeric (depends on GTA)
<maxSizeOfStreamingReplay value="…" />1024Free text / numeric (depends on GTA)
<maxFileStoreSize value="…" />65536Free text / numeric (depends on GTA)
<Audio3d value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<AdapterIndex value="…" />0Free text / numeric (depends on GTA)
<OutputIndex value="…" />0Free text / numeric (depends on GTA)
<ScreenWidth value="…" />2560Free text / numeric (depends on GTA)
<ScreenHeight value="…" />1440Free text / numeric (depends on GTA)
<RefreshRate value="…" />239Free text / numeric (depends on GTA)
<Windowed value="…" />2
Borderless
  • 0 — Fullscreen
  • 1 — Windowed
  • 2 — Borderless
<VSync value="…" />0
Off
  • 0 — Off
  • 1 — On
  • 2 — Half
<Stereo value="…" />false
Disabled
  • false — Disabled
  • true — Enabled
<Convergence value="…" />0.1000000 … 1 (step 0.01)
<Separation value="…" />1.0000000 … 1 (step 0.01)
<PauseOnFocusLoss value="…" />1
Yes
  • 0 — No
  • 1 — Yes
<AspectRatio value="…" />5
16:9
  • 0 — Auto
  • 1 — 3:2
  • 2 — 4:3
  • 3 — 5:3
  • 4 — 5:4
  • 5 — 16:9
  • 6 — 16:10

What each setting means (mapping)

Section titled “What each setting means (mapping)”

The tables below are generated from gtaSettingsMap.ts.

Advanced

XML element Type Values
<AsyncComputeEnabled value="…" /> select
  • false — Disabled
  • true — Enabled
<DX_Version value="…" /> select
  • 0 — DirectX 10
  • 1 — DirectX 10.1
  • 2 — DirectX 11
<maxFileStoreSize value="…" /> text Free text / numeric (depends on GTA)
<maxSizeOfStreamingReplay value="…" /> text Free text / numeric (depends on GTA)
<numBytesPerReplayBlock value="…" /> text Free text / numeric (depends on GTA)
<numReplayBlocks value="…" /> text Free text / numeric (depends on GTA)
<Shader_SSA value="…" /> select
  • false — Disabled
  • true — Enabled

Anti-Aliasing

XML element Type Values
<FXAA_Enabled value="…" /> select
  • false — Disabled
  • true — Enabled
<MSAA value="…" /> select
  • 0 — Off
  • 2 — 2x MSAA
  • 4 — 4x MSAA
  • 8 — 8x MSAA
<MSAAFragments value="…" /> select
  • 0 — Off
  • 1 — On
<MSAAQuality value="…" /> select
  • 0 — Low
  • 1 — Medium
  • 2 — High
<SamplingMode value="…" /> select
  • 0 — MSAA
  • 1 — AMD CAS
  • 2 — NVIDIA DLSS
  • 3 — FSR
<TXAA_Enabled value="…" /> select
  • false — Disabled
  • true — Enabled

Audio

XML element Type Values
<Audio3d value="…" /> select
  • false — Disabled
  • true — Enabled

Display

XML element Type Values
<AdapterIndex value="…" /> text Free text / numeric (depends on GTA)
<AspectRatio value="…" /> select
  • 0 — Auto
  • 1 — 3:2
  • 2 — 4:3
  • 3 — 5:3
  • 4 — 5:4
  • 5 — 16:9
  • 6 — 16:10
<OutputIndex value="…" /> text Free text / numeric (depends on GTA)
<PauseOnFocusLoss value="…" /> select
  • 0 — No
  • 1 — Yes
<RefreshRate value="…" /> text Free text / numeric (depends on GTA)
<ScreenHeight value="…" /> text Free text / numeric (depends on GTA)
<ScreenWidth value="…" /> text Free text / numeric (depends on GTA)
<TripleBuffered value="…" /> select
  • false — Disabled
  • true — Enabled
<VSync value="…" /> select
  • 0 — Off
  • 1 — On
  • 2 — Half
<Windowed value="…" /> select
  • 0 — Fullscreen
  • 1 — Windowed
  • 2 — Borderless

Effects

XML element Type Values
<DoF value="…" /> select
  • false — Disabled
  • true — Enabled
<MotionBlurStrength value="…" /> slider 0 … 1 (step 0.1)
<ParticleQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<PostFX value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra

Graphics Quality

XML element Type Values
<AnisotropicFiltering value="…" /> select
  • 0 — Off
  • 1 — x1
  • 2 — x2
  • 4 — x4
  • 8 — x8
  • 16 — x16
<GrassQuality value="…" /> select
  • 0 — Very Low
  • 1 — Low
  • 2 — Medium
  • 3 — High
  • 4 — Very High
<Lighting_FogVolumes value="…" /> select
  • false — Disabled
  • true — Enabled
<Reflection_MipBlur value="…" /> select
  • false — Disabled
  • true — Enabled
<ReflectionMSAA value="…" /> select
  • 0 — Off
  • 2 — x2
  • 4 — x4
  • 8 — x8
<ReflectionQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<ShaderQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<ShadowQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra
<SSAO value="…" /> select
  • 0 — Off
  • 1 — Normal
  • 2 — High
<Tessellation value="…" /> select
  • 0 — Off
  • 1 — Normal
  • 2 — High
  • 3 — Very High
<WaterQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra

Performance

XML element Type Values
<HdStreamingInFlight value="…" /> select
  • false — Disabled
  • true — Enabled
<LodScale value="…" /> slider 0 … 1 (step 0.1)
<MaxLodScale value="…" /> slider 0 … 1 (step 0.1)
<PedLodBias value="…" /> slider 0 … 1 (step 0.1)
<VehicleLodBias value="…" /> slider 0 … 1 (step 0.1)

Population

XML element Type Values
<CityDensity value="…" /> slider 0 … 1 (step 0.1)
<PedVarietyMultiplier value="…" /> slider 0 … 1 (step 0.1)
<VehicleVarietyMultiplier value="…" /> slider 0 … 1 (step 0.1)

Shadows

XML element Type Values
<Shadow_aircraftExpWeight value="…" /> slider 0.9 … 1 (step 0.01)
<Shadow_DisableScreenSizeCheck value="…" /> select
  • false — Disabled
  • true — Enabled
<Shadow_Distance value="…" /> slider 0 … 2 (step 0.1)
<Shadow_LongShadows value="…" /> select
  • false — Disabled
  • true — Enabled
<Shadow_ParticleShadows value="…" /> select
  • false — Disabled
  • true — Enabled
<Shadow_SoftShadows value="…" /> select
  • 0 — Softest
  • 1 — Softer
  • 2 — Soft
  • 3 — Medium
  • 4 — Sharp
  • 5 — Sharper
<Shadow_SplitZEnd value="…" /> slider 0.5 … 1 (step 0.01)
<Shadow_SplitZStart value="…" /> slider 0.5 … 1 (step 0.01)
<UltraShadows_Enabled value="…" /> select
  • false — Disabled
  • true — Enabled

Stereoscopic 3D

XML element Type Values
<Convergence value="…" /> slider 0 … 1 (step 0.01)
<Separation value="…" /> slider 0 … 1 (step 0.01)
<Stereo value="…" /> select
  • false — Disabled
  • true — Enabled

System Info

XML element Type Values
<configSource value="…" /> text Free text / numeric (depends on GTA)
<version value="…" /> text Free text / numeric (depends on GTA)
<VideoCardDescription value="…" /> text Free text / numeric (depends on GTA)

Texture & Details

XML element Type Values
<TextureQuality value="…" /> select
  • 0 — Normal
  • 1 — High
  • 2 — Very High
  • 3 — Ultra

Notes

Section titled “Notes”
  • If you set an unknown value, GTA/FiveM may clamp it, ignore it, or rewrite it on launch.
  • If your settings “keep resetting”, start by validating the XML is well-formed and that nothing else is overwriting it after launch.