Commande
/data
Lit, modifie et retire les données stockées (NBT) des entités de bloc, des entités et du stockage de commandes.
Syntaxe
| /data get (block <target>|entity <target>|storage <target>) [<path> [<scale>]] |
| /data merge (block <target>|entity <target>|storage <target>) <nbt> |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> (append|merge|prepend|set) compute (block <computePos>|entity <computeTarget>) (float <provider>|integer <provider>) |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> (append|merge|prepend|set) compute default (float <provider>|integer <provider>) |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> (append|merge|prepend|set) from (block <source>|entity <source>|storage <source>) [<sourcePath>] |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> (append|merge|prepend|set) string (block <source>|entity <source>|storage <source>) [<sourcePath> [<start> [<end>]]] |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> (append|merge|prepend|set) value <value> |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> insert <index> compute (block <computePos>|entity <computeTarget>) (float <provider>|integer <provider>) |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> insert <index> compute default (float <provider>|integer <provider>) |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> insert <index> from (block <source>|entity <source>|storage <source>) [<sourcePath>] |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> insert <index> string (block <source>|entity <source>|storage <source>) [<sourcePath> [<start> [<end>]]] |
| /data modify (block <target>|entity <target>|storage <target>) <targetPath> insert <index> value <value> |
| /data remove (block <target>|entity <target>|storage <target>) <path> |
Arguments
| Argument | Type de valeur | Quoi saisir |
|---|---|---|
| <target> | Position de bloc | Ce qu'il faut lire ou modifier. Après block, il s'agit d'une position de bloc, après entity d'une seule entité, après storage d'un ID avec espace de noms comme example:config. |
| <path> | Chemin de données | L’emplacement d’une valeur dans les données, par exemple Pos[1] ou Items[0].id. |
| <scale> | Nombre décimal | Pour get : un nombre par lequel la valeur est multipliée avant d'être arrondie à l'inférieur et renvoyée. |
| <nbt> | Données entre accolades | Pour merge : un composé écrit entre accolades, par exemple {NoAI:1b}. |
| <targetPath> | Chemin de données | Pour modify : l'emplacement dans les données de la cible qui est modifié. |
| <computePos> | Position de bloc | Pour une source compute avec block : la position du bloc que regarde le calcul. |
| <provider> | Fournisseur de nombres décimaux | Pour une source compute : le fournisseur de nombre à calculer, sous forme d'id ou écrit en ligne. |
| <computeTarget> | Sélecteur de cible | Pour une source compute avec entity : l'entité que regarde le calcul. Une seule entité. |
| <source> | Position de bloc | Pour from et string : d'où les données sont copiées. Une position de bloc, une seule entité ou un ID de stockage. |
| <sourcePath> | Chemin de données | L’emplacement de la valeur à copier dans la source. Sans cela, toutes les données de la source sont utilisées. |
| <start> | Nombre entier | Pour string : l'indice du premier caractère conservé. Les valeurs négatives comptent depuis la fin. |
| <end> | Nombre entier | Pour string : l'indice où le texte s'arrête, non inclus. Les valeurs négatives comptent depuis la fin. |
| <value> | Valeur de données | Pour une source value : les données à utiliser, comme un nombre, du texte entre guillemets, une liste ou un composé. |
| <index> | Nombre entier | Pour modify insert : la position dans la liste où la valeur est ajoutée. 0 est le début. |
Détails
| Niveau de permission | 2 : opérateurs, mondes avec triche activée, blocs de commande et fonctions |
| Fonctionne dans | Solo avec les cheats activés et serveurs multijoueur. Demande le niveau de permission 2 (maîtres de jeu) : opérateurs du serveur, joueurs avec triches, blocs de commande et fonctions peuvent tous l'exécuter. |
| Résultat | get indique les données trouvées. Le nombre que /execute store enregistre est 1 pour une cible entière, le nombre arrondi à l’inférieur pour un nombre, la longueur pour un texte et le nombre d’entrées pour une liste ou un composé. Avec une échelle, c'est le nombre multiplié par l'échelle et arrondi à l'inférieur. merge renvoie 1. remove renvoie le nombre de valeurs retirées. modify renvoie le nombre de valeurs modifiées. |
| Cibles | block est un bloc qui stocke des données, comme Coffre ou Pancarte, à une position chargée. entity est une seule entité. storage est un stockage de données nommé conservé avec le monde, que les commandes peuvent utiliser librement ; il est créé la première fois qu'on y écrit. |
| get | Affiche toutes les données de la cible, ou seulement la valeur à un chemin. Avec une échelle, la valeur au chemin doit être un nombre. Le chemin doit pointer vers exactement une valeur. |
| merge | Fusionne le composé indiqué avec les données de la cible, en écrasant les clés nommées. Échoue avec « Rien n'a changé » si les données ont déjà ces valeurs. |
| remove | Supprime la ou les valeurs au chemin indiqué. Échoue si rien n'a été retiré. |
| modify set | Remplace la valeur du chemin cible par la valeur source. |
| modify append et prepend | Ajoute la valeur source à la fin ou au début de la liste au chemin cible. |
| modify insert | Ajoute la valeur source à la liste au chemin cible, à l'index donné. |
| modify merge | Fusionne le composé source dans le composé situé au chemin cible. Les deux doivent être des composés. |
| Source : value | Utilise les données écrites directement dans la commande. |
| Source : from | Copie des données d'un autre bloc, d'une autre entité ou d'un autre stockage, soit en entier, soit la valeur d'un chemin source. |
| Source : string | Copie une valeur d'un bloc, d'une entité ou d'un stockage sous forme de texte. Les paramètres facultatifs start et end découpent une partie du texte : start est le premier caractère à conserver, compté à partir de 0, et end est l’endroit où s’arrêter. Les nombres négatifs comptent depuis la fin du texte. Seules les valeurs de texte et les valeurs numériques sont utilisables. |
| Source : compute | Utilise le résultat d'un fournisseur de nombres, comme /compute le calcule : default, block avec une position ou entity avec une cible, suivi de integer ou float et du fournisseur. |
| Modification impossible : Joueur | Les données de Joueur peuvent être lues mais pas modifiées. Tenter de le modifier échoue avec « Impossible de modifier les données du joueur ». |
| Raisons d'échec | Échoue si le bloc ne stocke pas de données (« Le bloc ciblé n'est pas une entité de bloc »), si le chemin n'existe pas ou si une commande modify laisse les données inchangées. |
Exemples
/data get entity @sAffiche toutes vos propres données.
/data get entity @s Pos[1]Affiche votre hauteur (coordonnée Y) et la renvoie arrondie à l'inférieur.
/data get block ~ ~-1 ~ ItemsAffiche les objets stockés dans le conteneur situé sous vous.
/data merge entity @e[type=minecraft:zombie,limit=1,sort=nearest] {NoAI:1b}Définit NoAI sur l'entité la plus proche de type Zombie pour qu'elle cesse de se déplacer seule.
/data modify storage example:config counter set value 5Stocke le nombre 5 sous counter dans le stockage example:config.
/data remove storage example:config counterSupprime counter du stockage example:config.
