Minecraft:Launcher settings.json

Template:Exclusive Template:Underscore title launcher_settings.json is a Minecraft:JSON file located in Template:File, which stores global configuration parameters of the Minecraft:Minecraft Launcher.

JSON format

launcher_settings.json uses JSON structures to save and retrieve settings across launcher sessions. The keys and their data types are outlined below.

• Template:Nbt The root object
  • Template:Nbt: The active schema version of the configuration file. Currently Template:Cd.
  • Template:Nbt: Internal schema format version identifier of the settings model. Defaults to Template:Cd.
  • Template:Nbt: A unique 64-bit integer identifier randomly generated to uniquely identify the client machine installation.
  • Template:Nbt: The interface language tag (such as Template:Cd). Defaults to the operating system's locale.
  • Template:Nbt: The release channel used for receiving launcher updates. Can be Template:Cd, Template:Cd or any custom defined channel in Template:Cd. Defaults to Template:Cd.
  • Template:Nbt: A list of strings representing custom distribution update channels. Defaults to an empty list Template:Cd.
  • Template:Nbt: Custom path for installing and managing game files.
  • Template:Nbt: Forces the launcher to use the native 64-bit ARM Java Runtime Environment, on supported ARM64 hardware. Defaults to Template:Cd.
  • Template:Nbt: Increases all texts size. Defaults to Template:Cd.
  • Template:Nbt: Toggles support for quick play. Defaults to Template:Cd.

    Optional properties:

  • Template:Nbt: The rollout strategy used to select launcher self-updates. Can be Template:Cd, Template:Cd or Template:Cd. Unused in modern launcher versions.
  • Template:Nbt: Target API backend environment for Minecraft Services. Can be any string or Template:Cd/Template:Cd.<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: Template:Cd (Minecraft Services), Template:Cd (Mojang API), Template:Cd (Franchise Services), Template:Cd (Dynamic Resource Services), and Template:Cd (Template:Cd active).</ref>
  • Template:Nbt: Target API backend environment for the in-game Minecraft:Mojang API. Can be any string or Template:Cd/Template:Cd.<ref name="staging" group="note" /><ref name="version-tags" group="note" />
  • Template:Nbt: Target API backend environment for the franchise services. Can be any string or Template:Cd/Template:Cd.<ref name="staging" group="note" /><ref name="version-tags" group="note" /><ref group="note">Setting this to Template:Cd/Template:Cd enables downloading development builds of the launcher: 2.4.571-dev when Template:Cd is set to Template:Cd, or 2.18.46-dev when set to Template:Cd.</ref>
  • Template:Nbt: Endpoint for CDN asset delivery. Can be Template:Cd or Template:Cd.<ref name="version-tags" group="note" />
  • Template:Nbt: Settings for the updater specific to Template:MCD.<ref group="note">Only respected by installations from the unified launcher of Template:MCD.</ref>
    • Template:Nbt: The release channel identifier.
    • Template:Nbt: The release channel used for receiving updates. Can be an empty string or Template:Cd.<ref group="note">Setting this to Template:Cd allows downloading the official closed beta build of Minecraft Dungeons from April 3, 2020.</ref>
  • Template:Nbt: Opens a dedicated debugging window showing GPU driver capabilities and hardware acceleration statistics for troubleshooting.
  • Template:Nbt: Disables hardware graphics acceleration in the launcher.
  • Template:Nbt: Prevents embedded videos from automatically playing inside game tabs.
  • Template:Nbt: Overrides treatment tags and A/B feature flag experiments.
    • Template:Nbt: A list of tags to explicitly force on.
    • Template:Nbt: A list of tags to explicitly force off.
  • Template:Nbt: Enables high-verbosity diagnostic telemetry reporting.
  • Template:Nbt: Enables recording of performance metrics in logs.
  • Template:Nbt: Internal debug flag to simulate an account with no owned game licenses.
  • Template:Nbt: UNIX timestamp recording the exact date and time of the last shutdown of the unified Minecraft Launcher.
  • Template:Nbt: UNIX timestamp recording the exact date and time of the last shutdown of the launcher.
  • Template:Nbt: Custom HTTP header injected into network requests sent to backend services.
  • Template:Nbt: Custom command-line arguments and flags passed directly to the Template:W runtime on launch. Accepts a string or an array of argument strings.

Gallery

• Hidden channel selector revealed in the launcher settings when Template:Cd is populated
  Hidden channel selector revealed in the launcher settings when Template:Cd is populated
• Environment override tags appended to the launcher version
  Environment override tags appended to the launcher version