Tag
Les tags (aussi appeler tags de registre) des packs de données[Java] et des packs de comportement[Bedrock] permettent aux joueurs de regrouper différents éléments du jeu dans des fichiers JSON.
Utilisation
[modifier | modifier le wikicode]Édition Java
[modifier | modifier le wikicode]Les tags font partie de la structure de répertoire d'un pack de données, comme montré ci-dessous :
/
<nom du pack de données>
pack.mcmeta- data
- <espace de nom>
- tags
- function
- <nom>.json : Un tag de fonction.
- <nom du registre>
- <nom>.json : Un tag du registre correspondant.
- Plus de répertoires…
Minecraft définit de nombreux tag dans le pack de données vanilla dans l'espace de nom minecraft. Ces tags sont souvent référencés par le code ou d'autres fichiers du pack de données vanilla, et modifier ces tags par le biais d'un pack de données a donc un effet direct sur le jeu. Par exemple, les tags de bloc vanilla sont utilisés pour divers comportements des blocs, les tags d'objet vanilla sont utilisés pour divers comportements des objets et dans les fichiers de progrès et de recette vanilla, et les tags de type d'entité vanilla sont utilisés pour divers comportements des créatures. Voir la section § Liste des tags pour leurs utilisations.
Emplacement de ressource
[modifier | modifier le wikicode]L'emplacement de ressource d'un tag est également au format <espace de nom>:<chemin>, où l'espace de nom est le nom du répertoire dans lequel se trouve le dossier tags, et le chemin est le chemin du fichier JSON dans le dossier de tag correspondant.
Par exemple, le fichier JSON 'data/wiki/tags/block/toto/exemple.json' définit un tag de bloc ayant l'emplacement de ressource wiki:toto/exemple.
Pour distinguer le contenu normal des tags, un caractère # est généralement requis avant l'emplacement de ressource d'un tag.
Format JSON
[modifier | modifier le wikicode]- : L'objet racine.
- replace : Optionnel. Si le contenu de ce tag doit complètement remplacer ou non le contenu du tag ayant le même emplacement de ressource dans des packs de données de priorité inférieure. Lorsque la valeur est
false, le contenu du tag est ajouté au contenu des packs de données de priorité supérieure. Vautfalsepar défaut. - values : Une liste de combinaisons de noms d'éléments et de noms de tags. Pour les tags, une référence récursive est possible, mais une référence circulaire engendre un échec de chargement.
- : L'emplacement de ressource d'un élément.
- : L'ID d'un autre tag du même type, préfixé avec le caractère
#. - : Une entrée avec des options supplémentaires.
- id : Une chaîne de caractères dans un des formats de chaîne de caractères ci-dessus.
- required : Si charger ce tag doit échouer ou non si cette entrée n'est pas trouvée. Vaut
truepar défaut (comme pour les entrées en chaîne de caractères). Un tag qui ne parvient pas à être chargé peut toujours être référencé dans un pack de données et être (re)défini dans d'autres packs de données. Autrement dit, seules les entrées dans ce fichier JSON sont ignorées si cette entrée ne peut pas être trouvée.
- replace : Optionnel. Si le contenu de ce tag doit complètement remplacer ou non le contenu du tag ayant le même emplacement de ressource dans des packs de données de priorité inférieure. Lorsque la valeur est
Édition Bedrock
[modifier | modifier le wikicode]Les tags sont définis dans la définition des blocs, objets et biomes au format ci-dessous.
Format JSON
[modifier | modifier le wikicode]- : L'objet racine.
- minecraft:<définition> : Le type de définition. Peut valoir
block,itemoubiome.- components
- minecraft:tags (pour les objets et les biomes)
- tags : La liste des tags.
- : Un nom de tag.
- tags : La liste des tags.
- tag:<nom du tag> (pour les blocs) :
<nom du tag>est remplacé par le nom du tag. L'objet doit être vide.
- minecraft:tags (pour les objets et les biomes)
- components
- minecraft:<définition> : Le type de définition. Peut valoir
Un bloc, un objet ou un biome peut avoir plusieurs tags. Des tags vanilla et personnalisés sont autorisés.
Les tags peuvent être utilisés pour exécuter des requêtes dans les commandes et les packs de comportement.
Liste des tags
[modifier | modifier le wikicode]Cette section liste les tags qui sont utilisés par le jeu pour affecter son comportement de diverses manières, ainsi que ceux qui sont renseignés par défaut, même si le jeu ne les utilise pas pour contrôler certains comportements.
Édition Java
[modifier | modifier le wikicode]Il est possible de renseigner des tags pour tous les types dans le registre. La liste ci-dessous montre uniquement ceux utilisé par le jeu.
- Blocs
- Objets
- Fonctions
- Fluides
- Types d'entité
- Événements de jeu
- Biomes
- Préréglages de générateur de monde plat
- Préréglages de monde
- Structures
- Variantes de chat
- Types de point d'intérêt
- Variantes de tableau
- Motifs de bannière
- Instruments
- Types de dégât
- Enchantements
- Dialogues
Édition Bedrock
[modifier | modifier le wikicode]Historique
[modifier | modifier le wikicode]| Édition Java | |||||||
|---|---|---|---|---|---|---|---|
| 1.13 | 17w49a | Ajout du type de tags pour les blocs et les objets. | |||||
| 17w49b | Les fonction peuvent maintenant être regrouper dans des tags. | ||||||
| 18w19a | Ajout du type de tag pour les fluides. | ||||||
| 1.14 | 18w43a | Ajout des tags pour Types d'entité. | |||||
| 1.16.2 | 20w30a | Ajout de la propriété replace dans les tags. | |||||
| Release Candidate 1 | Les entrées peuvent maintenant être optionnel avec la propriété required. | ||||||
| 1.16.5 | 20w49a | Ajout du type de tag pour les événements de jeu. | |||||
| 1.18.2 | 22w06a | Les tags peuvent maintenant être renseignés pour tous les types dans le registre, au lieux de seulement pour les blocs, objets, fluides, types d'entité, événements de jeu et fonctions. | |||||
| 1.18.2 | 22w07a | Ajout de tag pour les biome. | |||||
| 1.19 | 22w11a | Ajout de tags pour les préréglages de générateur de monde plat. | |||||
| Ajout de tags pour les structures. | |||||||
| 22w14a | Ajout de tag pour les variantes de chat et les types de point d'intérêt. | ||||||
| 22w16a | Ajout de tags pour les variantes de tableau. | ||||||
| 22w18a | Ajout de tags pour les motifs de bannière et les instruments. | ||||||
| 1.19.4 | 23w06a | Ajout de tags pour les types de dégâts. | |||||
| 1.20.5 | Pre-Release 1 | Ajout de tags pour les enchantements. | |||||
| 1.21.6 | 25w20a | Ajout de tags pour les dialogues. | |||||
| Édition Bedrock | |||||||
| ? | Ajout de tags pour les blocks, items, et biomes. | ||||||
| 1.19.40 | Preview 1.19.40.22 | Ajout de nouveau tag d'objets. | |||||
| 1.20.50 | Preview 1.20.50.20 | La manière d'on les objets sont regrouper dans des tags a était changé. | |||||
| 1.20.60 | Preview 1.20.60.24 | La manière d'on les biomes sont regrouper dans des tags a était changé. | |||||
