Minecraft:Client.json: Difference between revisions

Latest revision as of 11:08, 25 October 2026

Template:Mono is the file that accompanies Template:Mono in Minecraft:.minecraft/versions/<version> and lists the version's attributes. When using the latest version of the Minecraft:Minecraft Launcher, it is named Template:Mono (e.g., Template:Mono). The JSON file for specific versions is located in the Template:Mono file.

JSON format

This is the JSON format for Template:Mono.

Template:Nbt The root tag.
- Template:Nbt:
  - Template:Nbt: Contains default values for a launcher's custom JVM arguments field.
    - Template:Nbt A conditional argument.
      - Template:Nbt: A list of rules.
        Template:Nbt A rule.
        Template:Nbt: One of "allow" or "disallow".
        
        Template:Nbt:
        Template:Nbt: One of "windows", "osx" or "linux".
        
        Template:Nbt:
        Template:Nbt: The minimum OS version satisfying the rule.
        
        Template:Nbt: The maximum OS version satisfying the rule.
      - Template:Nbt: A list of arguments that is added when the condition is matched.
  - Template:Nbt: Contains arguments supplied to the game, such as information about the username and the version.
    - Template:Nbt An argument.
    - Template:Nbt A conditional argument.
      - Template:Nbt: A list of rules.
        Template:Nbt A rule.
        Template:Nbt: One of "allow" or "disallow".
        
        Template:Nbt: Includes a set of features that can be checked.
        Template:Nbt: Appears only in the first appearance of the compound tag.
        
        Template:Nbt: Appears only in the second appearance of the compound tag.
        
        Template:Nbt: Appears only in the third appearance of the compound tag.
        
        Template:Nbt: Appears only in the fourth appearance of the compound tag.
        
        Template:Nbt: Appears only in the fifth appearance of the compound tag.
        
        Template:Nbt: Appears only in the sixth appearance of the compound tag.
      - Template:Nbt Template:Nbt: An argument or a list of arguments that is added when the condition is matched.
  - Template:Nbt: Contains JVM arguments, such as information about memory allocation, garbage collector selection, or environment variables.
    - Template:Nbt: A conditional argument.
      - Template:Nbt: A list of rules.
        Template:Nbt: A rule.
        Template:Nbt: One of "allow" or "disallow".
        
        Template:Nbt: The launcher can detect this, but it's currently unused.
        
        Template:Nbt:
        Template:Nbt: One of "windows", "osx" or "linux".
        
        Template:Nbt: Contains a regex<ref group="note">Template:Cite</ref> intended to be checked against System.getProperty("os.version").
        
        Template:Nbt: Appears only in the fourth appearance of the compound tag. Its value is "x86".
      - Template:Nbt Template:Nbt: An argument or a list of arguments that is added when the condition is matched.
- Template:Nbt:
  - Template:Nbt: The assets version.
  - Template:Nbt: The SHA1 hash of the assets file.
  - Template:Nbt: The size of the version.
  - Template:Nbt: The total size of the version.
  - Template:Nbt: The URL that the game should visit to download the assets.
- Template:Nbt: The assets version.
- Template:Nbt: 0 until Minecraft:1.16.4-pre2, and 1 for all versions after. A value of 0 causes the official launcher to warn the player about missing player safety features when this version is selected.
- Template:Nbt:
  - Template:Nbt: The Minecraft:client.jar download information.
    - Template:Nbt: The SHA1 hash of the jar.
    - Template:Nbt: The size of the jar in bytes.
    - Template:Nbt: The URL the launcher should visit to download the file.
  - Template:Nbt: The obfuscation maps for this client version. Added in Minecraft:Java Edition 19w36a but got included in 1.14.4 also. Repeats the structure of the client download information.
  - Template:Nbt: The server download information. Repeats the structure of the client download information.
  - Template:Nbt: The obfuscation maps for this server version. Added in Minecraft:Java Edition 19w36a but got included in 1.14.4 also. Repeats the structure of the client download information.
  - Template:Nbt: The Windows server download information. Removed in Minecraft:Java Edition 16w05a, but is still present in prior versions. Repeats the structure of the client download information.
- Template:Nbt: The name of this version client (e.g. 1.14.4).
- Template:Nbt:
  - Template:Nbt: The build of OpenJDK to download and use with the game. Its value is "jre-legacy" until Minecraft:21w18a, "java-runtime-alpha" until Minecraft:1.18-pre1, "java-runtime-beta" until Minecraft:22w17a, "java-runtime-gamma" until Minecraft:24w13a, "java-runtime-delta" until Minecraft:1.21.11, and "java-runtime-epsilon" since Minecraft:26.1 Snapshot 1.
  - Template:Nbt: The version of the Java Runtime Environment to use. Its value is 8 until Minecraft:21w18a, 16 until Minecraft:1.18-pre1, 17 until Minecraft:24w13a, 21 until Minecraft:1.21.11, and 25 since Minecraft:26.1 Snapshot 1.
- Template:Nbt: A list of libraries.
  - Template:Nbt: A library.
    - Template:Nbt: The library's download information.
      - Template:Nbt: Info about the artifact.
        Template:Nbt: Path to store the downloaded artifact, relative to the "libraries" directory in Minecraft:.minecraft.
        
        Template:Nbt: The SHA1 hash of the file.
        
        Template:Nbt: The size of the file in bytes.
        
        Template:Nbt: The URL that the game should visit to download the file.
      - Template:Nbt: Appears until Minecraft:1.19-pre1, only for some libraries.
        Template:Nbt: Specifies the artifact information for the artifact with this specific classifier. Repeats the artifact structure above.
    - Template:Nbt: A maven name for the library, in the form of "groupId:artifactId:version" for Java libraries and, since Minecraft:22w18a, "groupId:artifactId:version:natives-platform" for native libraries.
    - Template:Nbt: The URL of the Maven repository (used by Forge).
    - Template:Nbt: Information about native libraries (in C) bundled with this library. Appears until Minecraft:1.19-pre1, only when there are classifiers for natives.
      - Template:Nbt: This tag's name depends on the natives that appear in the classifiers, it will be one of "windows", "osx" or "linux".
    - Template:Nbt: Rules to follow when extracting natives from a library.
      - Template:Nbt: Paths to exclude.
        Template:Nbt: Its value is "META-INF/".
    - Template:Nbt: Contains a compound with the tags "action" and "os", as shown above.
- Template:Nbt: Information about Log4j log configuration.
  - Template:Nbt:
    - Template:Nbt: The JVM argument for adding the log configuration. Its value is "-Dlog4j.configurationFile=${path}".
    - Template:Nbt: The Log4j2 XML configuration used by this version for the launcher for launcher's log screen.
      - Template:Nbt: Its value is "client-1.7.xml" until Minecraft:17w14a, "client-1.12.xml" until Minecraft:24w36a, and "client-1.21.2.xml" since Minecraft:24w37a.
      - Template:Nbt: The SHA1 hash for this file.
      - Template:Nbt: The size of this file in bytes.
      - Template:Nbt: The URL the launcher should visit to download the file.
    - Template:Nbt: Its value is "log4j2-xml".
- Template:Nbt: The main class.
- Template:Nbt: The minimum Launcher version that can run this version of the game.
- Template:Nbt: The release date-time in ISO-8601<ref group="note">https://www.iso.org/iso-8601-date-and-time-format.html</ref> extended offset format.
- Template:Nbt: Same as "releaseTime".
- Template:Nbt: The type of this game version. One of "release", "snapshot", "unobfuscated", "old_beta" or "old_alpha"

History

Template:HistoryTable

Notes

Template:Notelist

Navigation

Template:Navbox Java Edition technical

Minecraft:de:Client.json Minecraft:es:Client.json Minecraft:fr:Client.json Minecraft:ja:Client.json Minecraft:pt:Client.json Minecraft:zh:Client.json

@@ Line 10: / Line 10: @@
 * {{nbt|compound}} The root tag.
 **{{nbt|compound|arguments}}:
+*** {{nbt|list|default-user-jvm}}: Contains default values for a launcher's custom JVM arguments field.
+**** {{nbt|compound}} A conditional argument.
+***** {{nbt|list|rules}}: A list of rules.
+****** {{nbt|compound}} A rule.
+******* {{nbt|string|action}}: One of "allow" or "disallow".
+******* {{nbt|compound|os}}:
+******** {{nbt|string|name}}: One of "windows", "osx" or "linux".
+******** {{nbt|string|versionRange}}:
+********* {{nbt|string|min}}: The minimum OS version satisfying the rule.
+********* {{nbt|string|max}}: The maximum OS version satisfying the rule.
+***** {{nbt|list|value}}: A list of arguments that is added when the condition is matched.
 *** {{nbt|list|game}}: Contains arguments supplied to the game, such as information about the username and the version.
 **** {{nbt|string}} An argument.
@@ Line 64: / Line 75: @@
 ****** {{nbt|int|size}}: The size of the file in bytes.
 ****** {{nbt|string|url}}: The URL that the game should visit to download the file.
-***** {{nbt|compound|classifiers}}: Appears only for some libraries.
+***** {{nbt|compound|classifiers}}: Appears until [[Minecraft:1.19-pre1]], only for some libraries.
 ****** {{nbt|compound|<classifier>}}: Specifies the artifact information for the artifact with this specific classifier. Repeats the artifact structure above.
-**** {{nbt|string|name}}: A [https://maven.apache.org/guides/mini/guide-naming-conventions.html maven name] for the library, in the form of "''groupId'':''artifactId'':''version''".
+**** {{nbt|string|name}}: A [https://maven.apache.org/guides/mini/guide-naming-conventions.html maven name] for the library, in the form of "''groupId'':''artifactId'':''version''" for Java libraries and, since [[Minecraft:22w18a]], "''groupId'':''artifactId'':''version'':natives-''platform''" for native libraries.
 **** {{nbt|string|url}}: The URL of the [https://maven.apache.org Maven] repository (used by [[Minecraft:Mods/Forge|Forge]]).
-**** {{nbt|compound|natives}}: Information about native libraries (in C) bundled with this library. Appears only when there are classifiers for natives.
+**** {{nbt|compound|natives}}: Information about native libraries (in C) bundled with this library. Appears until [[Minecraft:1.19-pre1]], only when there are classifiers for natives.
 ***** {{nbt|string}}: This tag's name depends on the natives that appear in the classifiers, it will be one of "windows", "osx" or "linux".
 **** {{nbt|compound|extract}}: Rules to follow when extracting natives from a library.
@@ Line 78: / Line 89: @@
 **** {{nbt|string|argument}}: The JVM argument for adding the log configuration. Its value is "-Dlog4j.configurationFile=${path}".
 **** {{nbt|compound|file}}: The [https://logging.apache.org/log4j/2.x/manual/configuration.html#XML Log4j2 XML configuration] used by this version for the launcher for launcher's log screen.
-***** {{nbt|string|id}}: Its value is "client-1.12.xml", but may differ for older versions.<ref group=note>For instance, for [[Minecraft:Java Edition 1.10.2]], the value is "client-1.7.xml".</ref>
+***** {{nbt|string|id}}: Its value is "client-1.7.xml" until [[Minecraft:17w14a]], "client-1.12.xml" until [[Minecraft:24w36a]], and "client-1.21.2.xml" since [[Minecraft:24w37a]].
 ***** {{nbt|string|sha1}}: The SHA1 hash for this file.
 ***** {{nbt|int|size}}: The size of this file in bytes.
@@ Line 93: / Line 104: @@
 {{HistoryTable
 |{{HistoryLine|java}}
-|{{HistoryLine||1.6.1|dev=13w16a|With the new launcher, versions are now stored in <samp>[[Minecraft:.minecraft]]/versions</samp> and each version has its own folder with a {{mono|[[Minecraft:client.jar|minecraft.jar]]}} (which is now called {{mono|[[Minecraft:client.jar]]}}) and a {{mono|<''client''>.json}} file.}}
+|{{HistoryLine||1.6.1|dev=13w16a|With the new launcher, versions are now stored in <samp>[[Minecraft:.minecraft]]/versions</samp> and each version has its own folder with a {{mono|[[Minecraft:client.jar|minecraft.jar]]}} (which is now called {{mono|[[Minecraft:client.jar]]}}) and a {{mono|<''client''>.json}} file.
-|{{HistoryLine||1.7.2|dev=13w39a|Added the {{nbt|compound|logging}} tag in the root tag.}}
+|{{nbt|integer|minimumLauncherVersion}} is initially 4.}}
+|{{HistoryLine||1.7.2|dev=13w38a|{{nbt|integer|minimumLauncherVersion}} is bumped to 7.}}
+|{{HistoryLine|||dev=13w39a|Added the {{nbt|compound|logging}} tag in the root tag.}}
+|{{HistoryLine|||dev=13w42a|{{nbt|integer|minimumLauncherVersion}} is bumped to 9.}}
+|{{HistoryLine||1.7.4|dev=13w47a|{{nbt|integer|minimumLauncherVersion}} is bumped to 10.}}
+|{{HistoryLine|||dev=13w48b|{{nbt|integer|minimumLauncherVersion}} is bumped to 11.}}
+|{{HistoryLine|||dev=13w49a|{{nbt|integer|minimumLauncherVersion}} is bumped to 12.}}
+|{{HistoryLine|||dev=release|{{nbt|integer|minimumLauncherVersion}} is bumped to 13.}}
+|{{HistoryLine||1.8|dev=14w07a|{{nbt|integer|minimumLauncherVersion}} is bumped to 14.}}
 |{{HistoryLine||1.9|dev=16w05a|Removed the {{nbt|compound|windows_server}} tag, however, it remains present for versions that already have it.}}
+|{{HistoryLine|||dev=16w05b|{{nbt|integer|minimumLauncherVersion}} is bumped to 18.}}
 |{{HistoryLine||1.13|dev=17w43a|The {{nbt|compound|arguments}} tag replaced the old {{nbt|string|minecraftArguments}} tag.}}
+|{{HistoryLine|||dev=17w43b|{{nbt|integer|minimumLauncherVersion}} is bumped to 21.}}
 |{{HistoryLine||1.15|dev=19w36a|Obfuscation mappings are now listed in the {{nbt|compound|downloads}} tag. They are implemented in 1.14.4 also.}}
 |{{HistoryLine||1.16|dev=20w21a|Added two new arguments: {{cd|disableChat}}, which disables the chat in-game, and {{cd|disableMultiplayer}}, which disables the "Multiplayer" and "Minecraft Realms" buttons.}}
 |{{HistoryLine||1.17|dev=20w45a|Added the {{nbt|compound|javaVersion}} tag with all its children.}}
+|{{HistoryLine||1.19|dev=22w18a|A new maven name form, "''groupId'':''artifactId'':''version'':natives-''platform''", is used for Windows on ARM natives.}}
+|{{HistoryLine|||dev=1.19-pre1|The new maven name form is used for natives of other platforms as well. As such, {{nbt|compound|natives}} and {{nbt|compound|downloads.classifiers}} is no longer present in {{nbt|list|libraries}}.}}
 |{{HistoryLine||1.20|dev=23w14a|In {{nbt|list|game}}, added {{nbt|boolean|has_quick_plays_support}}, {{nbt|boolean|is_quick_play_singleplayer}}, {{nbt|boolean|is_quick_play_multiplayer}}, and {{nbt|boolean|is_quick_play_realms}} to {{nbt|list|rules}}.}}
+|{{HistoryLine||1.21.11|dev=25w45a|Obfuscation mappings are not listed in {{nbt|compound|downloads}} for non-obfuscated builds of [[Minecraft:1.21.11]] and development versions.}}
+|{{HistoryLine||26.1|dev=snap1|Due to removal of obfuscation, obfuscation mappings are no longer listed in listed in {{nbt|compound|downloads}}.}}
+|{{HistoryLine|||dev=snap2|Added {{nbt|list|default-user-jvm}} to {{nbt|compound|arguments}}.}}
 }}