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[]