imported>RedX: you either link the json wikipedia article or remove this ref entirely

2026-03-04T21:03:15Z

you either link the json wikipedia article or remove this ref entirely

New page

'''JavaScript Object Notation''' ('''JSON''') is a lightweight data-interchange format. It consists of key-value pairs and arrays values, and is used for storing and transmitting data in ''Minecraft''.

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

* [[Minecraft:Text]] in the {{cmd|tellraw}} and {{cmd|titleraw}} commands, [[Minecraft:book]]s, [[Minecraft:sign]]s, item names, entity names, world names, [[Minecraft:scoreboard]] displays, and text that is displayed through [[Minecraft:script API]]s in {{BE}}.
* The <code>[[Minecraft:pack.mcmeta]]</code> file that describes a {{el|je}} [[Minecraft:resource pack]] and [[Minecraft:data pack]].
* The <code>[[Minecraft:manifest.json]]</code> file that describes a {{el|be}} [[Minecraft:add-on]].
* Files in a [[Minecraft:resource pack]] that define [[Minecraft:model]]s, [[Minecraft:colormap]]s, [[Minecraft:sounds.json|sound events]], [[Minecraft:text]]s, [[Minecraft:font]]s, [[Minecraft:Resource pack#GUI|GUI]], etc.
* Files in a [[Minecraft:data pack]] that define [[Minecraft:advancements]], [[Minecraft:loot table]]s, [[Minecraft:tags]], [[Minecraft:recipes]], [[Minecraft:Custom dimension|dimensions]], [[Minecraft:Custom dimension|dimension types]] and [[Minecraft:predicates]].{{only|java}}
* Files in a [[Minecraft:behavior pack]] that define [https://docs.microsoft.com/en-us/minecraft/creator/reference/content/entityreference/ entity behaviors], [https://docs.microsoft.com/en-us/minecraft/creator/reference/content/blockreference/ block behaviors], item behaviors, etc.{{only|bedrock}}
* Files in a [[Minecraft:skin pack]] that identify the skins being used.{{only|bedrock}}
* [[Minecraft:Advancements]] and [[Minecraft:statistics]] (as <code>.minecraft/saves/*/data/stats/*.json</code>)
* The profile data for the [[Minecraft:launcher]] (as [[Minecraft:launcher_profiles.json]])
* Information about downloaded [[Minecraft:version]]s (as [[Minecraft:version.json]])
* Inside the {{w|Base64}} encoded textures data of [[Minecraft:player head]]s and players.{{only|java}}

== Syntax ==
=== 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.

==== String ====
A {{w|String (computer science)|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 (<code>\</code>).

* {{cd|"foo"}}
* {{cd|"Hello, world"}}
* {{cd|"An escaped \" quote within a string"}}

==== Number ====
A number is defined by entering in any number. Numbers can be non-whole, as indicated with a period, and can use exponents with <code>e</code>.

* {{cd|2}}
* {{cd|-0.5}}
* {{cd|3e6}} (=3×10<sup>6</sup>)

==== Object ====
An {{w|Object (computer science)|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).

<syntaxhighlight lang="json" line="1">
{
"Bob": {
"ID": 1234,
"lastName": "Ramsay"
},
"Alice": {
"ID": 2345,
"lastName": "Berg"
}
}
</syntaxhighlight>

==== Array ====
{{w|Array (data type)|Array}}s are delimited by opening and closing square brackets and can contain values of any data type, separated by commas. Unlike lists in [[Minecraft:NBT format|NBT]], values in a JSON array can use different data types.

<syntaxhighlight lang="json">
["Bob", "Alice", "Carlos", "Eve"]
</syntaxhighlight>

==== Boolean ====
A {{w|Boolean data type|boolean}} can be either <code>true</code> or <code>false</code>.

<syntaxhighlight lang="json" line="1">
{
"Steve": {
"isAlive": true
},
"Alex": {
"isAlive": false
}
}
</syntaxhighlight>

== See also ==
* [[Minecraft:w:JSON|JSON on Wikipedia]]

==References==
{{Reflist}}
== Navigation ==
{{Navbox Java Edition technical|general}}
{{Navbox Bedrock Edition}}

[[Category:Development]]

[[Minecraft:de:JSON]]
[[Minecraft:es:JSON]]
[[Minecraft:fr:JSON]]
[[Minecraft:ja:JSON]]
[[Minecraft:lzh:JSON]]
[[Minecraft:pt:JSON]]
[[Minecraft:ru:Команды консоли#JSON-текст]]
[[Minecraft:th:JSON]]
[[Minecraft:uk:JSON]]
[[Minecraft:zh:JSON]]

Minecraft:JSON - Revision history

imported>RedX: you either link the json wikipedia article or remove this ref entirely