JSON
JSON (JavaScript Object Notation – Notation Objet issue de JavaScript) est un format léger d'échange de données.[1]
Dans Minecraft, le format JSON est utilisé pour stocker les données suivantes :
- Texte des livres édités, des pancartes, noms personnalisés et les commandes
/tellraw
,/title
,/bossbar
,/scoreboard
et/team
.[Version Java uniquement] - Le fichier
pack.mcmeta
qui décrit un pack de ressources et un pack de données.[Version Java uniquement] - Le fichier
manifest.json
qui décrit un add-on.[Version Bedrock uniquement] - Les fichiers dans un pack de ressources qui définissent les modèles,
sounds.json
et les interfaces utilisateur.[Version Bedrock uniquement] - Les fichiers dans un pack de comportement qui définissent le comportement des entités.[Version Bedrock uniquement]
- Les progrès et statistiques (
.minecraft/saves/*/data/stats/*.json
).[Version Java uniquement] - Les données de profil(en) pour le lanceur (
.minecraft/launcher_profiles.json
). - Informations à propos des versions téléchargées (
.minecraft/versions/*/*.json
). - Les fichiers dans un pack de données qui définissent les avancements, tables de butin, tags, dimensions personnalisées(en) et prédicats(en).[Version Java uniquement]
Sommaire
Syntaxe[modifier | modifier le wikicode]
Types de données[modifier | modifier le wikicode]
Un fichier JSON ne peut contenir qu'une seule valeur JSON, qui peut utiliser n'importe lequel des types de données suivants : chaîne, nombre, objet, tableau, et booléen. Les fichiers JSON peuvent être écrits en une seule ligne, il est cependant souvent utile d'utiliser l'indentation et les sauts de lignes pour rendre un long fichier JSON plus lisible.
Chaîne[modifier | modifier le wikicode]
Une chaîne est délimitée par des guillemets et peut contenir n'importe quelle combinaison de caractères et d'espaces. Quelques caractères spéciaux nécessitent d'être échappés avec \
.
"Hello, world"
"Un guillemet échappé \" dans une citation"
Nombre[modifier | modifier le wikicode]
Un nombre est défini en entrant n'importe quel nombre. Les nombres peuvent ne pas être entiers, si indiqués avec un point .
, et peuvent utiliser les exposants avec e
.
2
-0.5
3e6
Objet[modifier | modifier le wikicode]
Un objet, également appelé combinaison (compound en anglais), est délimité par des accolades ouvrante et fermante qui contiennent des paires clef/valeur. Les paires sont séparées par des virgules, les clefs et leurs valeurs associées par des deux-points. Chaque clef doit avoir un nom qui est unique dans l'objet. La valeur peut-être de n'importe quel type, y compris un autre objet.
{
"Bob": {
"ID": 47182,
"NomDeFamille": "Ramsay"
},
"Alice": {
"ID": 47183,
"NomDeFamille": "Berg"
}
}
Tableau[modifier | modifier le wikicode]
Les tableaux sont délimités par des crochets ouvrant et fermant et peuvent contenir des valeurs de n'importe quel type (contrairement aux listes NBT), séparées par des virgules.
["Bob", "Alice", "Carlos", "Eve"]
Booléen[modifier | modifier le wikicode]
Un booléen peut être true
ou bien false
.
{
"Alice": {
"isMale": false
},
"Bob": {
"isMale": true
}
}