JSON

De Minecraft Wiki
Aller à la navigation Aller à la recherche

Le JSON (pour JavaScript Object Notation, littéralement 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 :

Types de données

[modifier | modifier le wikicode]

Un fichier JSON doit contenir une seule valeur JSON, qui peut utiliser l'un des cinq types de données suivants : chaîne de caractères, nombre, objet, liste et booléen. Les fichiers JSON peuvent être écrits en une seule ligne, mais il est cependant souvent utile d'utiliser de l'indentation et des sauts de ligne pour rendre un long fichier JSON plus lisible.

Chaîne de caractères

[modifier | modifier le wikicode]

Une chaîne de caractères (nom anglais : string) est délimitée par des guillemets et peut contenir n'importe quelle combinaison de caractères. Quelques caractères spéciaux doivent être échappés, ce qui se fait avec un antislash (\).

  • "toto"
  • "Bonjour le monde"
  • "Un guillemet \" échappé dans une chaîne de caractères"

Un nombre (nom anglais : number) est défini en entrant n'importe quel nombre. Les nombres peuvent ne pas être entiers, si cela est indiqué par un point, et peuvent utiliser des exposants avec e.

  • 2
  • -0.5
  • 3e6 (=3×106)

Un objet (nom anglais : object), également appelé composé (nom anglais : compound), est délimité par des accolades ouvrante et fermante, et contient des paires clé/valeur. Les paires sont séparées par des virgules, et les clés et leur valeur associée sont séparées par des deux-points. Chaque clé contenue doit avoir un nom qui est unique dans l'objet. Une valeur peut être de n'importe quel type de données, y compris un autre objet.

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

Une liste (nom anglais : array) est délimitée par des crochets ouvrant et fermant, et peut contenir des valeurs de n'importe quel type de données, séparées par des virgules. Contrairement aux listes NBT, les valeurs dans une liste JSON peuvent utiliser différents types de données.

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

Un booléen (nom anglais : boolean) peut valoir soit true, soit false.

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