Minecraft Wiki

The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki's logo. Please read this announcement for more information.


Minecraft Wiki
Minecraft Wiki

JavaScript Object Notation (JSON) is a lightweight data-interchange format.[1]

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


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, and boolean. 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.


A string 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 (\).

  • "foo"
  • "Hello, world"
  • "An escaped \" quote within a string"


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.

  • 2
  • -0.5
  • 3e6 (=3×106)


An object, 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).

 1 {
 2     "Bob": {
 3         "ID": 1234,
 4         "lastName": "Ramsay"
 5     },
 6     "Alice": {
 7         "ID": 2345,
 8         "lastName": "Berg"
 9     }
10 }


Arrays 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.

["Bob", "Alice", "Carlos", "Eve"]


A Boolean can be either true or false.

1 {
2     "Steve": {
3         "isAlive": true
4     },
5     "Alex": {
6         "isAlive": false
7     }
8 }

See also[]