Hello there! We are conducting a survey to better understand the user experience in making a first edit. If you have ever made an edit on Gamepedia, please fill out the survey. Thank you!

client.json

From Minecraft Wiki
Jump to: navigation, search

Information icon.svg
This feature is exclusive to Java Edition.

client.json is the file that accompanies client.jar in .minecraft/versions/<version> and lists the version's attributes. When using the latest version of the Minecraft launcher, it is named <game version>.json. The JSON file for specific versions is located in the version_manifest.json file.

JSON format[edit]

This is the JSON format for client.json.

  • The root tag.
    •  arguments:
      •  game: Contains information about the username, the version, the game directory and more. Also contains compound tags, explained below.
        • A value in the list.
        • This tag appears twice.
          •  rules:
            • This tag contains "action" and "features".
              •  action: Its value is "allow".
              •  features:
                •  is_demo_user: Appears only in the first appearance of the compound tag.
                •  has_custom_resolution: Appears only in the second appearance of the compound tag.
          •  value: Appears only in the first appearance of the compound tag. Its value is "--demo".
          •  value: Appears only in the second appearance of the compound tag. Keeps information about the width and height.
            • : A value in the list.
        •  jvm: A list of more compound tags containing "rules" and "value".
          • : This tag appears four times.
            •  rules:
              • : This tag contains "action" and "os".
                •  action: Its value is "allow".
                •  os:
                  •  name: Its value is "osx" for the first appearance of the compound tag and "windows" for the second and third. Does not appear in the fourth appearance.
                  •  version: Appears only in the third appearance of the compound tag. Its value is "^10\\.".
                  •  arch: Appears only in the fourth appearance of the compound tag. Its value is "x86".
            •  value: Appears only in the second and fourth appearance of the compound tag.
            •  value: Appears only in the first and third appearance of the compound tag.
              • : A value.
    •  assetIndex:
      •  id: The assets version.
      •  sha1: The SHA1 of the assets file.
      •  size: The size of the version.
      •  totalSize: The total size of the version.
      •  url: The URL that the game should visit to download the assets.
    •  assets: As of Java Edition 1.14, this tag's value is "1.14".
    •  downloads:
      • This tag appears twice. Its name is "client" the first time and "server" the second.
        •  sha1: The SHA1 of the client.jar or the server.jar.
        •  size: The size of the client.jar or the server.jar.
        •  url: The URL that the game should visit to download the client.jar or the server.jar.
    •  id: The name of this version client (e.g. 1.14.3).
    •  libraries: A giant list of libraries.
      • : A library.
        •  downloads: A download.
          •  artifact: Info about the download.
            •  path: Path for an URL that downloads a file.
            •  sha1: The SHA1 of the file.
            •  size: The size of the file.
            •  url: The URL that the game should visit to download the file.
          •  classifiers: Appears only for some libraries.
            •  natives-linux: This tag has the same tags as the "artifact" tag. It is for Linux, but appears even if the game is not run in Linux. Appears only in some libraries.
            •  natives-macos: This tag has the same tags as the "artifact" tag. It is for MacOS, but appears even if the game is not run in MacOS. Appears only in some libraries.
            •  natives-windows: This tag has the same tags as the "artifact" tag. It is for Windows, but appears even if the game is not run in Windows. Appears only in some libraries.
            •  javadoc: This tag has the same tags as the "artifact" tag. It is for downloading a "java-objc-bridge-1.0.0-javadoc.jar" file. Appears only in one library.
            •  natives-osx: This tag has the same tags as the "artifact" tag. It is for OS X, but appears even if the game is not run in OS X. Appears only in one library.
            •  sources: This tag has the same tags as the "artifact" tag. It is for downloading a "java-objc-bridge-1.0.0-sources.jar" file. Appears only in one library.
        •  name: A name that looks like an APK name, but shows what is downloaded.
        •  natives: Appears only when there are classifiers for natives.
          • : This tag's name depends on the natives that appear in the classifiers, so it can be "linux", "macos", "windows" or "osx". Its value will be the corresponding classifier ("natives-linux" etc.).
        •  extract: Appears only in two libraries.
          •  exclude: Shows what to exclude from the extraction.
            • : Its value is "META-INF/".
        •  rules: Appears only in the last two libraries. Contains a compound with the tags "action" and "os", as shown above.
    •  logging:
      •  client:
        •  argument: Its value is "-Dlog4j.configurationFile=${path}".
        •  file:
          •  id: Its value is "client-1.12.xml", but may differ for older versions.[note 1]
          •  sha1: The SHA1 for this file.
          •  size: The size of the file.
          •  url: The URL the game should visit to download the file.
        •  type: Its value is "log4j2-xml".
    •  mainClass: The main game class; for modern versions, it is net.minecraft.client.main.Main, but it may differ for older or ancient versions.[note 2]
    •  minimumLauncherVersion: The minimum Launcher version that can run this version of the game.
    •  releaseTime: The release date and time.
    •  time: Same as "releaseTime".
    •  type: The type of this game version. It is shown in the version list when you create a new installation. The default values are "release" and "snapshot".

History[edit]

Java Edition
1.6.113w16aWith the new launcher, versions are now stored in .minecraft/versions and each version has its own folder with a minecraft.jar (client.jar in the new version) and a .json file, which is the client.json.
1.7.213w39aAdded the "logging" tag in the root tag.
1.1317w43aThe "arguments" compound tag replaced the old string tag "minecraftArguments".

Notes[edit]

  1. For instance, for Java Edition 1.10.2, the value is "client-1.7.xml".
  2. For instance, for rd-132211, the value is com.mojang.rubydung.RubyDung.