← Tous les articles

Les composants à la place du NBT : ce qui remplace chaque tag, et ce qui a changé après la 1.20.5

Jusqu’en 1.20.4, un objet portait un seul bloc de NBT libre, où l’on pouvait mettre n’importe quoi. La 1.20.5 l’a remplacé par des composants d’objet : des morceaux nommés et typés comme custom_name, lore ou enchantments. Deux versions plus tard en ont encore modifié plusieurs, donc une conversion doit savoir quelle version elle vise.

Vérifié pour les versions : Java Edition 1.20 à 26.3.

Ce qui a vraiment changé

Un objet est désormais son identifiant plus une liste de composants. Chaque composant a une forme fixe que le jeu vérifie à la lecture de la commande : une faute que le NBT avalait autrefois arrête maintenant la commande. L’autre grande différence : il n’y a plus de clés libres. Un tag que vous inventiez, comme role:"guard", doit vivre dans custom_data.

Le même objet avant la 1.20.5 et en 1.21.5 – 26.x :

/give @p minecraft:paper{display:{Name:'{"text":"Guild Pass","italic":false}'},CustomModelData:12,role:"guard"} 1
/give @p minecraft:paper[minecraft:custom_name={text:"Guild Pass",italic:false},minecraft:custom_model_data={floats:[12f]},minecraft:custom_data={role:"guard"}] 1

Ancien tag → composant

Avant 1.20.5Depuis 1.20.5Changement ultérieur
display.Namecustom_name ou item_name1.21.5 : écrit en texte SNBT, {text:"…"}
display.Lorelore1.21.5 : chaque ligne en texte SNBT
CustomModelData:12custom_model_data1.21.4 : {floats:[12f]}, avec les listes flags, strings et colors
Enchantmentsenchantments1.21.5 : {"minecraft:sharpness":3} sans l’enveloppe levels
AttributeModifiersattribute_modifiers1.21 : id avec espace de noms ; 1.21.2 : sans generic. ; 1.21.5 : une simple liste
Unbreakable:1bunbreakable={}
HideFlagschamps show_in_tooltip, hide_additional_tooltip1.21.5 : tooltip_display={hidden_components:[…]}
Vos propres tags, ex. role:"guard"custom_data={role:"guard"}Seul endroit pour des clés personnelles
display.colordyed_color1.21.5 : dyed_color=12345 au lieu de {rgb:12345}
Potion, CustomPotionEffectspotion_contents
SkullOwnerprofile
BlockEntityTag, EntityTagblock_entity_data, entity_data

Quand un monde est ouvert dans une version plus récente, le jeu convertit les objets qu’il contient. Les commandes ne le sont pas : blocs de commande, fichiers de fonction et notes gardent l’ancienne syntaxe jusqu’à réécriture.

Les deux changements suivants

La 1.21.4 a changé le choix des modèles. custom_model_data est devenu quatre listes typées (floats, flags, strings, colors), et le resource pack choisit un modèle via une item definition dans assets/<namespace>/items/, vers laquelle l’objet pointe avec le composant item_model. Les anciens overrides des modèles d’objet ne marchent plus.

La 1.21.5 a changé l’écriture des composants. Les composants de texte sont en SNBT et non plus en chaînes JSON, plusieurs composants ont perdu leur enveloppe (enchantments, attribute_modifiers, dyed_color), et tous les champs show_in_tooltip ont rejoint un seul composant tooltip_display.

Pourquoi custom_data compte sur un serveur

Un nom visible se falsifie facilement à l’enclume. Si une boutique, une porte ou une quête vérifie une valeur cachée dans custom_data, un objet vanilla renommé ne passe pas. Depuis la 1.20.5, les échanges de villageois comparent les composants indiqués dans le prix : un échange qui demande custom_data={currency:"guild_voucher"} n’accepte que le vrai bon.

Migrer un serveur sans tout casser

  1. Listez tous les endroits où des objets sont créés : blocs de commande, fonctions, tables de butin, offres de villageois, configurations de plugins.
  2. Convertissez d’abord noms, lore et tags inventés (custom_data), car boutiques et quêtes les lisent.
  3. Si vous passez en 1.21.4 ou plus, réécrivez les hooks de modèle et le resource pack ensemble : la commande remplit une case, l’item definition la lit.
  4. Testez chaque objet en jeu avant qu’il n’arrive aux joueurs, et gardez la liste là où toute l’équipe la voit.

Questions fréquentes

custom_name ou item_name ?

custom_name agit comme un renommage à l’enclume et s’affiche en italique sauf avec italic:false. item_name est le nom propre de l’objet, sans italique, et l’enclume ne peut pas l’enlever.

Peut-on encore ajouter ses propres données ?

Oui, dans custom_data. Il accepte n’importe quel compound, et commandes, prédicats et échanges de villageois peuvent le vérifier.

Existe-t-il une liste officielle des composants ?

Le jeu les propose dans l’autocomplétion de /give, et la page « Data component format » du Minecraft Wiki documente chacun avec son historique.