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.5 | Depuis 1.20.5 | Changement ultérieur |
|---|---|---|
display.Name | custom_name ou item_name | 1.21.5 : écrit en texte SNBT, {text:"…"} |
display.Lore | lore | 1.21.5 : chaque ligne en texte SNBT |
CustomModelData:12 | custom_model_data | 1.21.4 : {floats:[12f]}, avec les listes flags, strings et colors |
Enchantments | enchantments | 1.21.5 : {"minecraft:sharpness":3} sans l’enveloppe levels |
AttributeModifiers | attribute_modifiers | 1.21 : id avec espace de noms ; 1.21.2 : sans generic. ; 1.21.5 : une simple liste |
Unbreakable:1b | unbreakable={} | |
HideFlags | champs show_in_tooltip, hide_additional_tooltip | 1.21.5 : tooltip_display={hidden_components:[…]} |
Vos propres tags, ex. role:"guard" | custom_data={role:"guard"} | Seul endroit pour des clés personnelles |
display.color | dyed_color | 1.21.5 : dyed_color=12345 au lieu de {rgb:12345} |
Potion, CustomPotionEffects | potion_contents | |
SkullOwner | profile | |
BlockEntityTag, EntityTag | block_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
- Listez tous les endroits où des objets sont créés : blocs de commande, fonctions, tables de butin, offres de villageois, configurations de plugins.
- Convertissez d’abord noms, lore et tags inventés (
custom_data), car boutiques et quêtes les lisent. - 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.
- 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.