Minecraft:JSON

JavaScript Object Notation (JSON) is a lightweight data-interchange format. It consists of key-value pairs and arrays values, and is used for storing and transmitting data in Minecraft.

Occurrences

In Minecraft, JSON format is used to store the following data:

• Text in the Template:Cmd and Template:Cmd commands, Minecraft:books, Minecraft:signs, item names, entity names, world names, Minecraft:scoreboard displays, and text that is displayed through Minecraft:script APIs in Template:BE.
• The Minecraft:pack.mcmeta file that describes a Template:El Minecraft:resource pack and Minecraft:data pack.
• The Minecraft:manifest.json file that describes a Template:El Minecraft:add-on.
• Files in a Minecraft:resource pack that define Minecraft:models, Minecraft:colormaps, sound events, texts, Minecraft:fonts, GUI, etc.
• Files in a Minecraft:data pack that define Minecraft:advancements, Minecraft:loot tables, Minecraft:tags, Minecraft:recipes, dimensions, dimension types and Minecraft:predicates.Template:Only
• Files in a Minecraft:behavior pack that define entity behaviors, block behaviors, item behaviors, etc.Template:Only
• Files in a Minecraft:skin pack that identify the skins being used.Template:Only
• Minecraft:Advancements and Minecraft:statistics (as .minecraft/saves/*/data/stats/*.json)
• The profile data for the Minecraft:launcher (as Minecraft:launcher_profiles.json)
• Information about downloaded Minecraft:versions (as Minecraft:version.json)
• Inside the Template:W encoded textures data of Minecraft:player heads and players.Template:Only

Syntax

Data types

A JSON file must contain a single JSON value, which can use any of the following five data types: string, number, object, array, boolean, and null. JSON files can be contained in a single line, however it is often useful to use indentation and line breaks to make a long JSON file more readable.

String

A Template:W is delimited by quotes and can contain any combination of characters. Some special characters need to be escaped; this is done with a back slash (\).

• Template:Cd
• Template:Cd
• Template:Cd

Number

A number is defined by entering in any number. Numbers can be non-whole, as indicated with a period, and can use exponents with e.

• Template:Cd
• Template:Cd
• Template:Cd (=3×10⁶)

Object

An Template:W, also referred to as a compound, is delimited by opening and closing curly brackets and contains key/value pairs. Pairs are separated with commas, keys and associated values are separated with colons. Each contained key needs to have a name that is unique within the object. A value can be of any data type as well (including another object).

<syntaxhighlight lang="json" line="1"> {

   "Bob": {
       "ID": 1234,
       "lastName": "Ramsay"
   },
   "Alice": {
       "ID": 2345,
       "lastName": "Berg"
   }

} </syntaxhighlight>

Array

Template:Ws are delimited by opening and closing square brackets and can contain values of any data type, separated by commas. Unlike lists in NBT, values in a JSON array can use different data types.

<syntaxhighlight lang="json"> ["Bob", "Alice", "Carlos", "Eve"] </syntaxhighlight>

Boolean

A Template:W can be either true or false.

<syntaxhighlight lang="json" line="1"> {

   "Steve": {
       "isAlive": true
   },
   "Alex": {
       "isAlive": false
   }

} </syntaxhighlight>Null.

Null is used to represent an unknown value.<syntaxhighlight lang="json" line="1"> {

   "player1": {
       "isdead": false
   },
   "player2": {
       "isdead": null
   }

} </syntaxhighlight>

See also

• JSON on Wikipedia