JSON

JSON（JavaScript Object Notation，JavaScript对象表示法）是一种轻量的数据交换格式。

Minecraft使用它来储存以下数据：

• 在成书、告示牌、自定义名称以及/tellraw、/title和/bossbar‌‌^[仅Java版]命令里的文本。
• 描述Java版资源包和数据包的pack.mcmeta文件‌‌^[仅Java版]。
• 描述基岩版附加包的manifest.json。
• 在资源包里定义模型、声音事件和UI‌‌^{[仅基岩版]}的文件。
• 在行为包中定义实体行为的文件。
• 成就和统计（例如.minecraft/saves/*/data/stats/*.json）。
• 用于启动器的档案数据（例如.minecraft/launcher profiles.json）。
• 关于已下载的版本的信息（例如.minecraft/versions/<VERSION>/<VERSION>.json）。
• 在数据包中定义成就、战利品表和标签‌‌^[仅Java版]的文件。

语法

JSON文件必须始终包含用于封装文件数据的大括号。

{
    "string": "Hi",
    "number": 1,
    "object": {"stuff": "foobar", "digit": 13},
    "array": ["spam", "foo"]
}

JSON文件内所有元素的名称必须用引号引起。要定义值，便需要在名称后面添加一个冒号，并在冒号后写上值。

{
    "name": "value"
}

除了最后一个元素，所有包含在对象或数组中的元素需要在它们的值后面添加一个逗号。

数据类型

JSON中有5种不同的数据类型：字符串（string）、数值（number）、对象（object）、数组（array）和布尔值（boolean）。

字符串

字符串由单引号或双引号定义，可以包含任何字符或空格的组合。

{
    "foo": "bar",
    "spam": "eggs"
}

数值

数值由输入的任何数字定义。

{
    "two": 2,
    "one": 1,
    "second": 1
}

对象

对象由一对大括号定义，且可以包含其他数据类型。文件开头和结尾处的大括号会组成一个对象。

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

数组

数组由一对中括号定义，且同样可以包含其他数据类型。

{
    "people": ["Bob", "Alice", "Carlos", "Eve"]
}

布尔值

布尔值使用“true”（真）或“false”（假）定义。

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

这是一个消歧义页面，列出了有相同或相近的标题，但内容不同的条目。如果您是通过某条目的内部链接而转到本页，希望您能协助修正该处的内部链接，将它指向正确的条目。