The Gamepedia and Fandom account systems have now been merged. If your username is incorrect, you have accounts on both platforms that weren't merged, or you have trouble signing in, please submit a support ticket.

JSON

From Minecraft Wiki
Jump to: navigation, search

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

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

Syntax[edit]

Data types[edit]

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.

String[edit]

A string is delimited by quotes and can contain any combination of characters or spaces. Some special characters need to escape.

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

Number[edit]

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

Object[edit]

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

{
    "Bob": {
        "ID": 47182,
        "lastName": "Ramsay"
    },
    "Alice": {
        "ID": 47183,
        "lastName": "Berg"
    }
}

Array[edit]

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

Boolean[edit]

A boolean can be either true or false.

{
    "Alice": {
        "isMale": false
    },
    "Bob": {
        "isMale": true
    }
}

See also[edit]

References[edit]