[Tutoriel] Le /summon et les NBT-tags

S’il y a bien un commande qui peut sembler simple d’usage, c’est le /summon. Mais quand on cherche à faire des créatures un peu poussées, on se rend vite compte qu’il faut connaître énormément de choses. Heureusement, voici un tutoriel complet à ce sujet, qui vous aidera à mieux connaître le fonctionnement détaillé de cette commande, et notamment celui des NBT-tags, ces variables qui font peur.

Construction de la commande /summon :

/summon <entité> <x> <y> <z> <nbt-tags>

Simple à première vue, mais ce qui est complexe pour beaucoup, c’est la construction des nbt-tags. Notez que si vous ne précisez pas les coordonnées, ce sont les coordonnées de l’endroit où est exécutée la commande qui sont utilisées.

Exemple de /summon simple :

/summon minecraft:zombie ~ ~ ~2

Les NBT-tags :

Parfois appelés data-tags, les NBT-tags sont des variables qui vont définir les points de vie d’un mob, ses caractéristiques, son nom ou encore ses compétences. Le nombre de tags qu’il est possible de définir est énorme et les possibilités pour créer des créatures customisées, infinies. Bien entendu, il existe des générateurs en ligne (il en existe d’autres), mais il arrive qu’ils ne soient pas à jour ou tout simplement qu’ils ne permettent pas de faire exactement ce que vous souhaitez. Cependant, une page reste toujours à jour et regroupe tout ce qu’il est possible de faire. Je parle bien évidemment de la page Gamepedia.

http://minecraft.gamepedia.com/Chunk_format

(sa version française est un peu plus difficile à lire)

Cette page, vous pouvez l’imprimer, la mettre en fond d’écran, la tatouer ou même la graver dans votre bureau tellement elle est utile (ce tutoriel aussi, mais je ne présenterai que les tags les plus couramment utilisés). Encore faut-il pouvoir comprendre comment s’en servir. Vous pourrez remarquer que si j’introduis cette article avec le /summon, de nombreuses commandes utilisent les NBT-tags (/entitydata, /blockdata, /give, /replaceitem, /testfor, /setblock ou encore le /testforblock)

Le début de la page concerne la construction des chunks. Ce genre d’info est assez difficile à modifier manuellement et ce n’est pas spécialement intéressant (hormis la difficulté locale peut-être qui détermine les chances d’apparition des monstres avec de l’équipement ou d’araignée avec des effets de potion). Mais en descendant plus bas, il y a toute une section dédiée au format de entités (Entity Format). Devant chaque nom de variable vous pouvez voir un petit symbole. Voici leur signification.

 Le compound. Quand vous voyez ceci, cela veut dire que votre commande va comporter des accolades « {} ». Tous les tags d’une entité sont mis dans un compound, c’est pour cela que les data-tags se mettent entre accolades. Il peut y avoir plusieurs informations de types différents dans un compound. Dans ce cas, elles sont séparées par des virgules.

Exemple : « /summon ender_crystal ~ ~ ~ {BeamTarget:{X:0,Y:0,Z:0}} »

BeamTarget est un compound, je lui met donc des accolades. Le contenu du compound est précisé sur la page.

Les listes. Celles-ci se mettent entre crochet (« [] ») et un second format est généralement précisé après (on peut faire des listes de nombres, des listes de chaînes de caractères ou encore des listes de compound). Il peut y a voir plusieurs éléments dans une liste, chaque élément est séparé par une virgule mais ils seront toujours du même type.

Exemple : « /summon boat ~ ~ ~ {Passengers:[{id: »villager »},{id: »pig »}]} »

Passengers est une liste de compound. La liste est donc délimitée par des crochets, chaque compound est entre accolades et ils sont séparés entre eux par des virgules.

Les chaînes de caractères (String). Il s’agit de texte et doivent être mises entre guillemets. Oublier les guillemets n’est pas grave dans le cas du /summon, le jeu va reconnaître que ce ne sont pas des chiffres qui sont entrés.

Exemple : « /summon zombie ~ ~ ~ {CustomName:« Hector Zam« } »

CustomName est une chaîne de caractère, le nom qui suit doit être mis entre guillemets.

Le Byte. Ce sont des petits nombres entiers compris entre -127 et 128. Minecraft n’utilise pas de booléen et ils sont remplacés par des bytes (valeur 0 et 1). Pour préciser que c’est un byte, on ajoute un ‘b’ après le nombre.

Exemple : « /summon zombie {Invulnerable:1b,Glowing:0b} »

Invulnerable et Glowing sont tout deux des variables de type « Byte ». Le 1b signifie « vrai » (mon zombie sera invincible) et le 0b, « faux » (mon zombie ne brillera pas).

Le Double. Ces variables supportent les nombres décimaux. Dans Minecraft, les Doubles n’ont généralement qu’un ou deux chiffres après la virgule. On ajoute un ‘d‘ après le nombre pour préciser le format. Il est assez peu utilisé.

Exemple : « /summon arrow ~ ~ ~ {damage:5.5d} »

Le tag damage est de type « double« , je peux donc indiquer un chiffre après la virgule.

Le Float. Ces variables supportent un grand nombre de chiffres après la virgule. Ils sont très utilisés pour tout ce qui demande un peu de précision ou des petits nombres (comme les probabilités de drop qui sont entre 0 et 1). On ajoute un ‘f‘ après le nombre.

Exemple : « /summon zombie ~ ~ ~ {Health:6.489f} »

Ce n’est généralement pas pour cette variable que l’on a besoin de la plus grande précision, mais il faut le savoir ; vos points de vies peuvent être des nombres avec des virgules même si c’est arrondi une fois affiché dans votre barre.

L’Integer. C’est un nombre entier mais contrairement au byte, il peut être beaucoup plus grand. Il est cependant toujours positif. Pour celui-ci, on ne précise jamais le format. On se contente d’écrire le chiffre simplement.

Exemple : « /summon armor_stand ~ ~ ~ {DisabledSlots:1087} »

Le cas du DisabledSlots des supportes pour armures est extrêmement complexe. Je vous invite à regarder ce générateur pour générer plus facilement les bonnes valeurs.

Les Longs. Pour les nombres très longs, c’est le format idéal. Pour préciser ce format, il faut ajouter un ‘L‘ à la fin du nombre (attention à bien le mettre en majuscule). Principalement utilisé pour les UUID (Universal Unique IDentifier) permettant d’éviter les doublons.

Exemple : « /summon skeleton ~ ~ ~ {UUIDMost:84618941894L} »

UUIDMost est un tag de type Long, on précise son format en ajoutant un L à la fin.

Les Shorts. Ce sont des nombres entiers, positifs ou négatifs qui ont l’avantage d’être plus grands que le Byte. Pour indiquer qu’il s’agit d’une variable de type short, on ajoute un ‘s‘ après le nombre.

NBT-tags fréquemment utilisés :

La page gamepedia est très bien faite, mais voici tout de même une explication pour les NBT-tags les plus utilisés avec quelques exemples aux applications très pratiques.

/summon zombie ~ ~ ~ {ArmorItems:[],HandItems:[]}

/summon zombie ~ ~ ~ {ArmorItems:[{},{},{},{id:"minecraft:iron_helmet",Count:1b}]}

/summon skeleton ~ ~ ~ {HandItems:[{id:"minecraft:bow",Count:1b},{id:"minecraft:iron_sword",Count:1b}]}

/summon zombie ~ ~ ~ {HandItems:[{id:"minecraft:carrot",Count:1b}],ArmorItems:[{id:"minecraft:iron_boots",Count:1b},{},{id:"minecraft:iron_chestplate",Count:1b},{id:"minecraft:iron_helmet",Count:1b}]}

/summon zombie ~ ~ ~ {HandItems:[{id:"minecraft:iron_sword",Count:1b},{id:"minecraft:carrot",Count:1b}],HandDropChances:[1.0f,0.10f],ArmorItems:[{id:"minecraft:iron_boots",Count:1b},{},{id:"minecraft:iron_chestplate",Count:1b},{id:"minecraft:iron_helmet",Count:1b}],ArmorDropChances:[0.0f,0.0f,0.0f,0.24f]}

/summon zombie ~ ~ ~ {ArmorItems:[{},{},{id:"minecraft:diamond",Count:2b},{id:"minecraft:diamond_ore",Count:1b}],ArmorDropChances:[0.00f,0.00f,0.10f,0.00f]}

Les attributs d'une entité

Les caractéristiques des créatures sont déterminées par l’équipement mais aussi par des variables propres à l’entité telles que le nombre de point de vie ou les dégâts que peut infliger l’entité. Et il est possible de modifier ces attributs dans le /summon.

Chaque entité possède une liste de Compound « Attributes » qui se mettra donc entre crochets. Chaque attribut quant à lui sera mis entre accolades.

Les attributs disponibles pour toutes les entités sont les suivant:

• generic.maxHealth – Permet de modifier le nombre de point de vie maximal de l’entité (attention à bien définir le tag « Health » quand vous le changez)
• generic.followRange – Permet de déterminer la distance à laquelle l’entité peut voir le joueur (attention, une valeur trop grande cause des soucis)
• generic.knockbackResistance – Permet de changer la chance de ne pas se faire propulser par une explosion
• generic.movementSpeed – Permet de modifier la vitesse de déplacement
• generic.attackDamage – Permet de modifier les dégâts des attaques
• generic.armor – Permet de changer la valeur de l’armure
• generic.armorToughness – Permet de changer la robustesse de l’armure (résistance aux coups critiques)

Chaque attribut se compose de la manière suivante: le nom (Name) et la valeur de base (Base)

Exemple d’un zombie très lent mais qui ferait beaucoup de dégâts :

/summon zombie ~ ~ ~ {Attributes:[{Name:"generic.movementSpeed",Base:0.1d},{Name:"generic.attackDamage",Base:50.0d}]}

Quand vous modifiez le nombre de point de vie maximal d’une entité, elle garde son nombre de point de vie par défaut au moment où elle apparaît. Il faut donc définir son nombre de point de vie manuellement via le tag « Health« .

Exemple d’une araignée avec 150/200 points de vie (il sera donc possible, avec une potion de régénération, de lui redonner 50 points de vie) :

/summon Spider ~ ~ ~ {Attributes:[{Name:"generic.maxHealth",Base:200.0d}],Health:150.0f}

Des NBT-tags existent pour les objets permettant d’influencer les Attributs d’une entité (en ajoutant 50% de vitesse de déplacement par exemple). Ces tags sont appelés AttributeModifiers et sont un peu plus complexes.

La commande pour le faire apparaître si ça vous intéresse :

/summon zombie ~ ~ ~ {CustomName:"Hector Zam",HandDropChances:[0.10f,0.20f],HandItems:[{id:"minecraft:feather",Count:1b,Damage:0s},{id:"minecraft:shears",Count:1b,Damage:0s}],ArmorDropChances:[0.00f,0.00f,0.00f,0.1f],CanBreakDoors:1b,ArmorItems:[{id:"minecraft:leather_boots",Count:1b,tag:{display:{color:9979333}},Damage:0s},{id:"minecraft:leather_leggings",Count:1b,tag:{display:{color:9979333}},Damage:0s},{id:"minecraft:leather_chestplate",Count:1b,tag:{display:{color:9979333}},Damage:0s},{id:"minecraft:end_rod",Count:1b,Damage:0s}]}
			

Faire apparaître des objets au sol

Lorsque vous jetez un objet de votre inventaire, celui-ci se transforme en entité. Et comme toute entité qui se respecte, on peut la faire apparaître avec le /summon.

/summon item ~ ~ ~ {Item:{id:"minecraft:gold_ingot",Count:1b}}

Attention à toujours préciser le « Count » sinon vous ne pourrez pas récupérer l’objet… mais peut-être est-ce justement votre but ? Il existe un autre tag permettant de définir le temps nécessaire après apparition pour pouvoir récupérer l’objet, le tag « PickupDelay« .

/summon item ~ ~ ~ {Item:{id:"minecraft:apple",Count:3b},PickupDelay:600s}

Vous devez attendre 600 ticks (30 secondes) pour pouvoir récupérer les trois pommes. Si vous utilisez 32767 comme valeur, vous ne pourrez jamais prendre l’objet.

Un autre tag bien pratique permet de déterminer le temps avant que l’objet ne disparaisse, le tag « Age« . Par défaut, les objets disparaissent après 6000 ticks (5 minutes).

/summon item ~ ~ ~ {Item:{id:"minecraft:diamond",Count:20b},Age:5800s}

Il reste ici 200 ticks (10 secondes) avant que le tag Age n’atteigne 6000. Les diamants disparaîtrons donc 10 secondes après leur apparition. Si vous utilisez -32768 comme valeur, l’objet ne disparaîtra jamais.

Pour compléter le tout, un objet qui ne disparaît pas et que vous ne pouvez pas prendre.

/summon item ~ ~ ~ {Item:{id:"minecraft:book",Count:1s},Age:-32768s,PickupDelay:32767s}

Les objets au sol peuvent avoir d’autres tags comme des noms customisés ou être rendus invulnerables de la même manière que toutes les autres entités.

/summon item ~ ~ ~ {Item:{id:"minecraft:book",Count:1s},CustomName:"Prenez-moi !",CustomNameVisible:1b,Invulnerable:1b,Age:-32768s}

/summon armor_stand ~ ~ ~ {NoGravity:1b,Invulnerable:1b,CustomName:"Texte flottant",CustomNameVisible:1b,Invisible:1b,Marker:1b}

/kill @e[type=armor_stand,r=3,c=1]

Les entités qui se chevauchent

Dans une grotte un peu sombre, vous avez peut-être déjà vu des squelettes chevaucher des araignées. Sachez qu’il est possible de les faire apparaître. Et de faire apparaître un bébé zombie qui chevauche un poulet qui chevauche une araignée elle même dans un bateau est aussi possible. Dites bonjour au tag « Passengers« . Ce tag est une liste de compound, Il est donc délimité par des crochets et chaque élément à l’intérieur est entre accolades. Voici par exemple la commande pour faire apparaître un squelette sur une araignée.

/summon spider ~ ~ ~ {Passengers:[{id:"skeleton"}]}

Il est possible de mettre plusieurs passagers sur une seule entité, c’est comme cela que fonctionnent les bateaux.

/summon boat ~ ~ ~ {Passengers:[{id:"creeper"},{id:"creeper"}]}

Ou on peut aussi envisager des entités sur des entités sur des entités.

/summon spider ~ ~ ~ {Passengers:[{id:"zombie",Passengers:[{id:"chicken"}]}]}

Vos no-mods utilisent ce principe quand vous les installez !

/summon villager ~ ~ ~ {Silent:1b,Invulnerable:1b}

/summon creeper ~ ~ ~ {ExplosionRadius:0b,Fuse:1s}

/summon slime ~ ~ ~ {Size:5}

/summon boat ~ ~ ~ {NoGravity:1b}

/summon falling_sand ~ ~10 ~ {Block:"minecraft:gold_block",Time:1}

Connaître les NBT-tags d’une entité déjà créée :

Ce qui peut être frustrant parfois, c’est de créer une entité parfaite… mais de ne plus avoir la commande pour la replacer. Il existe cependant une solution toute simple en jeu permettant de récupérer ses NBT-tags.

Par exemple, j’ai créé ce zombie en utilisant la commande /replaceitem pour lui donner de l’équipement et j’aimerais le faire apparaître tel quel avec la commande /summon. Je vais, dans le bloc situé juste en dessous, entrer la commande suivante :

/entitydata @e[type=zombie,c=1] {}

Cela va cibler le zombie le plus proche (avec le c=1) et envoyer un message d’erreur dans le champ « Previous Output » parce que je n’ai pas fait de modification sur l’entité.

Il ne me reste plus qu’à sélectionner tout ce qui se trouve dans ce champ (en utilisant shift+contrôle+flèche) et à copier (contrôle + c) puis à coller le tout dans un /summon.

/summon zombie ~ ~1 ~ {HurtByTimestamp:0,ZombieType:0,Attributes:[0:{Base:20.0d,Name:"generic.maxHealth"},1:{Base:0.0d,Name:"generic.knockbackResistance"},2:{Base:0.23000000417232513d,Name:"generic.movementSpeed"},3:{Base:2.0d,Name:"generic.armor"},4:{Base:0.0d,Name:"generic.armorToughness"},5:{Base:35.0d,Name:"generic.followRange"},6:{Base:3.0d,Name:"generic.attackDamage"},7:{Base:0.07481863599766836d,Name:"zombie.spawnReinforcements"}],Invulnerable:1b,FallFlying:0b,PortalCooldown:0,AbsorptionAmount:0.0f,FallDistance:0.0f,DeathTime:0s,HandDropChances:[0:0.085f,1:0.085f],PersistenceRequired:0b,ConversionTime:-1,Motion:[0:0.0d,1:-0.0784000015258789d,2:0.0d],Leashed:0b,UUIDLeast:-7454321581964268780L,Health:20.0f,Silent:1b,LeftHanded:0b,Air:300s,OnGround:1b,Dimension:0,NoAI:1b,Rotation:[0:0.0f,1:0.0f],HandItems:[0:{id:"minecraft:golden_carrot",Count:1b,Damage:0s},1:{}],ArmorDropChances:[0:0.085f,1:0.085f,2:0.085f,3:0.085f],UUIDMost:-4045650954812109390L,Pos:[0:-288.5d,1:66.0d,2:326.5d],CanBreakDoors:1b,Fire:-1s,ArmorItems:[0:{},1:{},2:{},3:{id:"minecraft:diamond_helmet",Count:1b,tag:{ench:[]},Damage:18s}],CanPickUpLoot:0b,HurtTime:0s,ActiveEffects:[0:{Ambient:0b,ShowParticles:0b,Duration:9732,Id:24b,Amplifier:0b}]}

La commande est très longue, mais elle permet de faire apparaître exactement le même zombie. Il sera tellement identique qu’il ne sera pas possible de le faire apparaître deux fois car il y aurait alors deux entités avec le même UUID (ils sont censés être uniques). Si vous souhaitez vous servir de cette commande plusieurs fois, il faut penser à retirer les tags UUIDMost et UUIDLeast (ils seront générés aléatoirement par le jeu). Notez que cette méthode peut aussi servir à récupérer seulement une partie des tags pour éviter d’avoir des commandes trop longues ou tout simplement pour voir certains tags particuliers (par exemple les dégâts que fait l’entité ou le nombre de dégât qu’elle subit à chaque coup).

À vous de jouer !

Image de Une réalisée par Biboush

Dernière mise à jour de l’article : 2/06/2017 (Pour Minecraft 1.12)