JSON

Запис об’єктів JavaScript (англ. JavaScript Object Notation) (JSON) — це легкий формат обміну даними.^[1] Він складається з пар ключів-значень та масивів значень і використовується для зберігання та передачі даних у Minecraft.

У Minecraft формат JSON використовується для зберігання наступних даних:

• Текст у командах /tellraw і /titleraw, книгах, на табличках, у назвах предметів, назвах сутностей, назвах світів, відображеннях табло та текстах, що відображаються через скриптові API в Bedrock Edition.
• Файл pack.mcmeta, що описує пакет ресурсів і пакет даних Java Edition.
• Файл manifest.json, що описує доповнення Bedrock Edition.
• Файли в пакеті ресурсів, які визначають моделі, мапи кольорів, звукові події, тексти, шрифти, GUI тощо.
• Файли в пакеті даних, які визначають досягнення, таблиці здобичі, теґи, рецепти, виміри, типи вимірів та предикати.‌^{[Тільки для Java Edition]}
• Файли в пакеті поведінки, які визначають поведінку сутностей, блоків, предметів тощо.‌^{[Тільки для Bedrock Edition]}
• Файли в пакеті скінів, які ідентифікують використовувані скіни.‌^{[Тільки для Bedrock Edition]}
• Досягнення та статистика (як .minecraft/saves/*/data/stats/*.json)
• Дані профілю для запускача (як launcher_profiles.json)
• Інформація про завантажені версії (як version.json)
• Усередині Base64 закодовано дані текстур голів гравця та гравців.‌^{[Тільки для Java Edition]}

JSON-файл повинен містити одне JSON-значення, яке може використовувати будь-який з наступних п’яти типів даних: рядок, число, об’єкт, масив і логічний тип даних. JSON-файли можуть містити один рядок, проте часто корисно використовувати відступи та переноси рядків, щоб зробити довгий JSON-файл більш читабельним.

Рядок обмежується лапками й може містити будь-яку комбінацію символів. Деякі спеціальні символи потрібно екранувати; це робиться за допомогою оберненої скісної риски (\).

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

Число задається введенням довільної цифри. Числа можуть бути нецілими, що позначається крапкою, і можуть використовувати експоненти з e.

• 2
• -0.5
• 3e6 (=3×10⁶)

Об’єкт, який також називається складеним, обмежується фігурними дужками, що відкриваються й закриваються, і містить пари ключів/значень. Пари відокремлюються комами, ключі та пов’язані з ними значення відокремлюються двокрапкою. Кожен ключ, що міститься, повинен мати унікальне ім’я в межах об’єкта. Значення також може бути будь-якого типу даних (включно з іншим об’єктом).

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

Масиви обмежуються відкритими й закритими квадратними дужками та можуть містити значення будь-якого типу даних, розділені комами. На відміну від списків в NBT, значення в масиві JSON можуть використовувати різні типи даних.

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

Логічний тип даних може бути true або false.

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

• JSON на Вікіпедії