View source for Minecraft:Launcher settings.json

{{Missing information|{{cd|updateStrategy}} option}}
{{underscore title|launcher_settings.json}}
<code>'''launcher_settings.json'''</code> is a [[Minecraft:JSON]] file located in {{File|directory|[[Minecraft:.minecraft]]|inline=1}}, which stores global configuration parameters of the ''[[Minecraft:Minecraft Launcher]]''.

== JSON format ==
<code>launcher_settings.json</code> uses JSON structures to save and retrieve settings across launcher sessions. The keys and their data types are outlined below.

<div class="treeview">
* {{nbt|compound}} The root object
** {{nbt|int|version}}: The active schema version of the configuration file. Currently {{cd|17}}.
** {{nbt|int|formatVersion}}: Internal schema format version identifier of the settings model. Defaults to {{cd|0}}.
** {{nbt|long|deviceId}}: A unique 64-bit integer identifier randomly generated to uniquely identify the client machine installation.
** {{nbt|string|locale}}: The interface language tag (such as {{cd|en-US}}). Defaults to the operating system's locale.
** {{nbt|string|channel}}: The release channel used for receiving launcher updates. Can be {{cd|"release"}}, {{cd|"beta"}} or any custom defined channel in {{cd|customChannels}}. Defaults to {{cd|"release"}}.
** {{nbt|list|customChannels}}: A list of strings representing custom distribution update channels. Defaults to an empty list {{cd|[]}}.
** {{nbt|string|productLibraryDir}}: Custom path for installing and managing game files.
** {{nbt|boolean|useArm64JreIfSupported}}: Forces the launcher to use the native 64-bit ARM Java Runtime Environment, on supported ARM64 hardware. Defaults to {{cd|false}}.
** {{nbt|boolean|useMagnifiedMode}}: Increases all texts size. Defaults to {{cd|false}}.
** {{nbt|boolean|quickPlayEnabled}}: Toggles support for [[Minecraft:Quick Play|quick play]]. Defaults to {{cd|true}}.
**; Optional properties<nowiki>:</nowiki>
** {{nbt|string|updateStrategy}}: {{more info}}. Can be {{cd|"STABLE_VERSIONS"}}, {{cd|"SNAPSHOTS"}} or {{cd|"CONTROLLED_EXPERIMENT"}}.
** {{nbt|string|minecraftServicesEnvironment}}: Target API backend environment for Minecraft Services. Can be any string or {{cd|"staging"}}/{{cd|"stage"}}.<ref name="staging" group="note">Redirects critical backend services to internal staging servers, causing network and authentication failures without valid developer credentials.</ref><ref name="version-tags" group="note">Configuring this appends identifier tags directly to the launcher's displayed version: {{cd|mse}} (Minecraft Services), {{cd|mae}} (Mojang API), {{cd|fse}} (Franchise Services), {{cd|cse}} (Dynamic Resource Services), and {{cd|noent}} ({{cd|forceNoEntitlements}} active).</ref>
** {{nbt|string|mojangApiEnvironment}}: Target API backend environment for the in-game [[Minecraft:Mojang API]]. Can be any string or {{cd|"staging"}}/{{cd|"stage"}}.<ref name="staging" group="note" /><ref name="version-tags" group="note" />
** {{nbt|string|franchiseServicesEnvironment}}: Target API backend environment for the franchise services. Can be any string or {{cd|"staging"}}/{{cd|"stage"}}.<ref name="staging" group="note" /><ref name="version-tags" group="note" />
** {{nbt|string|dynamicResourceServicesEnvironment}}: Endpoint for CDN asset delivery. Can be {{cd|"prod"}} or {{cd|"testing"}}.<ref name="version-tags" group="note" />
** {{nbt|compound|dungeonsSettings}}: Settings for the updater specific to {{MCD}}.<ref group="note">Only respected by installations from the unified launcher of {{MCD}}.</ref>
*** {{nbt|string|channelId}}: The release channel identifier.
*** {{nbt|string|customBuildType}}: The release channel used for receiving updates. Can be an empty string or {{cd|"beta"}}.<ref group="note">Setting this to {{cd|"beta"}} allows downloading the official closed [[Minecraft:Dungeons:Beta Update April 3|beta build of ''Minecraft Dungeons'']] from April 3, 2020.</ref>
** {{nbt|boolean|debugGPU}}: Opens a dedicated debugging window showing GPU driver capabilities and hardware acceleration statistics for troubleshooting.
** {{nbt|boolean|disableGPU}}: Disables hardware graphics acceleration in the launcher.
** {{nbt|boolean|autoPlayVideoDisabled}}: Prevents embedded videos from automatically playing inside game tabs.
** {{nbt|compound|treatmentTagOverride}}: Overrides treatment tags and A/B feature flag experiments.
*** {{nbt|list|onTags}}: A list of tags to explicitly force on.
*** {{nbt|list|offTags}}: A list of tags to explicitly force off.
** {{nbt|boolean|logVerboseTelemetry}}: Enables high-verbosity diagnostic telemetry reporting.
** {{nbt|boolean|logPerformance}}: Enables recording of performance metrics in logs.
** {{nbt|boolean|forceNoEntitlements}}: Internal debug flag to simulate an account with no owned game licenses.
** {{nbt|string|shutDownTimestampUnified}}: UNIX timestamp recording the exact date and time of the last shutdown of the unified Minecraft Launcher.
** {{nbt|string|shutDownTimestampGamecore}}: UNIX timestamp recording the exact date and time of the last shutdown of the launcher.
** {{nbt|string|sendAdditionalHeader}}: Custom HTTP header injected into network requests sent to backend services.
** {{nbt|string|additionalCEFOptions}}: Custom command-line arguments and flags passed directly to the {{w|Chromium Embedded Framework|Chromium Embedded Framework (CEF)}} runtime on launch. Accepts a string or an array of argument strings.
</div>

== Gallery ==
<gallery>
File:Launcher custom channels.png|Hidden channel selector revealed in the launcher settings when {{cd|customChannels}} is populated
File:Launcher environment version tags.png|Environment override tags appended to the launcher version
</gallery>

== Notes ==
{{notelist}}

== Navigation ==
{{Navbox Java Edition technical|general}}