Minecraft:Launcher settings.json - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-16T11:11:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 16 October 2026
Line 1:		Line 1:
			{{Exclusive\|Java}}
	{{underscore title\|launcher_settings.json}}		{{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]]''.		<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]]''.

SyncBot: Sync: updated from Minecraft

2026-10-04T11:14:00Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 4 October 2026
Line 1:		Line 1:
	~~{{Missing information\|{{cd\|updateStrategy}} option}}~~
	{{underscore title\|launcher_settings.json}}		{{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]]''.		<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]]''.
Line 19:		Line 18:
	** {{nbt\|boolean\|quickPlayEnabled}}: Toggles support for [[Minecraft:Quick Play\|quick play]]. Defaults to {{cd\|true}}.		** {{nbt\|boolean\|quickPlayEnabled}}: Toggles support for [[Minecraft:Quick Play\|quick play]]. Defaults to {{cd\|true}}.
	**; Optional properties<nowiki>:</nowiki>		**; Optional properties<nowiki>:</nowiki>
	** {{nbt\|string\|updateStrategy}}: ~~{{more info}}~~. Can be {{cd\|"STABLE_VERSIONS"}}, {{cd\|"SNAPSHOTS"}} or {{cd\|"CONTROLLED_EXPERIMENT"}}.		** {{nbt\|string\|updateStrategy}}: The rollout strategy used to select launcher self-updates. Can be {{cd\|"STABLE_VERSIONS"}}, {{cd\|"SNAPSHOTS"}} or {{cd\|"CONTROLLED_EXPERIMENT"}}. Unused in modern launcher versions.
	** {{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\|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\|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" />

SyncBot: Sync: updated from Minecraft

2026-09-19T11:16:04Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:16, 19 September 2026
Line 53:		Line 53:
	== Navigation ==		== Navigation ==
	{{Navbox Java Edition technical\|general}}		{{Navbox Java Edition technical\|general}}

			[[Category:Minecraft Launcher]]

SyncBot: Sync: updated from Minecraft

2026-09-07T11:10:00Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 7 September 2026
Line 22:		Line 22:
	** {{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\|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\|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\|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" /><ref group="note">Setting this to {{cd\|"staging"}}/{{cd\|"stage"}} enables downloading development builds of the launcher: [[Minecraft:Launcher 2.4.571-dev\|2.4.571-dev]] when {{cd\|channel}} is set to {{cd\|"release"}}, or [[Minecraft:Launcher 2.18.46-dev\|2.18.46-dev]] when set to {{cd\|"beta"}}.</ref>
	** {{nbt\|string\|dynamicResourceServicesEnvironment}}: Endpoint for CDN asset delivery. Can be {{cd\|"prod"}} or {{cd\|"testing"}}.<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\|compound\|dungeonsSettings}}: Settings for the updater specific to {{MCD}}.<ref group="note">Only respected by installations from the unified launcher of {{MCD}}.</ref>

SyncBot: Sync: new page from Minecraft

2026-08-21T11:08:38Z

Sync: new page from Minecraft

New page

{{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}}