Les progrès situés dans le dossier data/advancements d'un monde stockent les données des progrès pour ce monde en tant que fichiers JSON distincts.
Format d'un fichier[]
L'un de ces fichiers JSON est structuré selon le format suivant :
La balise racine.
display (facultatif) : Les données d'affichage.
icon: La donnée pour l'icône.
item : L'ID de l'objet.
nbt: Les données NBT de l'objet.
title : Le titre du progrès.
title : Un composant de texte JSON (contenant des textes et un formatage comme utilisé dans la commande/tellrawet diverses autres commandes)
frame (facultatif) : Le type de cadre pour l'icône :challengepour un cadre sophistiqué,goalpour un cadre à bords arrondis outaskpour un cadre normal (par défaut).
background (facultatif) : Le chemin de l’arrière-plan utilisé pour l’onglet de ces progrès (seulement pour le progrès racine).
description: La description du progrès.
description: Un composant de texte JSON (contenant des textes et un formatage comme utilisé dans la commande/tellrawet diverses autres commandes).
show_toast: Affiche ou non la fenêtre de notification (par défaut: true).
announce_to_chat: Affiche ou non la notification dans le tchat (par défaut: true).
hidden : Si défini surtrue, le progrès est caché jusqu'à ce qu'il soit réalisé (par défaut: false).
parent (facultatif) : Le chemin du progrès parent de ce progrès. Si ce champ est absent, ce progrès est un progrès racine. Les références circulaires provoquent une erreur lors du chargement.
criteria : Les critères nécessaires à satisfaire.
<nomDuCritère> : Un nom donné au critère (peut être n’importe quelle chaîne de caractères, mais doit être unique).
trigger : Ce qui déclenche le progrès, spécifie ce que le jeu doit vérifier.
conditions : Toutes les conditions nécessaires à satisfaire lorsque le trigger est déclenché.
requirements (facultatif) : Une liste des critères (les <nomDuCritère>) nécessaires. Si tous les critères sont nécessaires, ceci peut être omis. S’il y a plusieurs critères (criteria) : les requirements contiennent une liste de listes avec les critères (tous les critères doivent être mentionnés). Si au moins un critère est satisfait dans chaque liste, le progrès sera octroyé (groupage AND de groupes OR).
rewards (facultatif) : Une collection des récompenses fournies lorsque ce progrès est réalisé.
recipes : Une liste de recettes (chaînes de code).
loot : Une liste de tables de butin (chaînes de code).
experience : Une quantité d'expérience.
function: Une fonction à exécuter. Les tags de fonctions ne sont pas autorisés.
Affichage[]
Dans la balise racine d'un progrès, le champ
display et le champ
parent, tous deux optionnels, contrôlent l'affichage du progrès.
Si la balise
display est présente, elle doit contenir les champs
title et
description pour que les données d'affichage du progrès soient valide.
La balise
parent, bien qu'elle ne soit pas associée avec l'affichage d'un progrès directement, n'affecte que son affichage. Quand ni un progrès ni ses enfants n'a pas de données d'affichage, le parent du progrès n'a pas d'effet sur le progrès lui-même.
Création d'onglets[]
Pour créer un onglet dans l'écran des progrès, créez un progrès racine (un avancement sans parent) avec un affichage. Quand le data pack contenant le progrès est chargé, le progrès racine affiche un onglet dans l'écran des progrès quand le joueur regardant l'écran obtient ce progrès ou n'importe lequel de ses descendants.
Quand l'arrière-plan (
background) d'un progrès racine n'est pas spécifié, l'onglet est toujours créé, mais l'arrière-plan de l'onglet apparaît avec la texture manquante (échiquier noir et violet).
Présence[]
Pour un progrès qui n'est pas le progrès racine (c'est à dire, un progrès avec un parent défini), ces conditions doivent être remplies pour qu'il soit affiché dans un onglet une fois débloqué:
- Son progrès racine doit être un onglet valide.
- Il doit avoir un affichage (
display).
Position[]
Le jeu dispose automatiquement les progrès, les positionne lorsque des progrès sont chargés depuis un data pack, et envoie la disposition des progrès au client. Chaque progrès a une flèche allant de son ancêtre visible le plus proche (i.e. si son parent n'a pas d'affichage, il a un lien vers le progrès grand-parent, etc.). Le progrès racine est affiché sur la colonne la plus à gauche et chaque flèche pointe vers un progrès dans la colonne suivante. La disposition des progrès dans une colonne dépend des noms des fichiers.
Absence d'affichage[]
Quelques progrès, par exemple les progrès débloquant les recettes par défaut, peuvent ne pas définir d'affichage pour utiliser des déclencheurs et des récompenses. Ces progrès doivent ne pas avoir de balise
display afin de ne pas pouvoir être affichés aux utilisateurs.
Liste de déclencheurs[]
minecraft:bee_nest_destroyed[]
Se déclenche quand le joueur détruit une ruche ou un nid d'abeilles. Conditions disponibles :
conditions:
block: L'ID du bloc détruit.
item: L'item utilisé pour détruire le bloc.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
num_bees_inside: Le nombre d'abeilles présentes dans la ruche/le nid d'abeilles avant d'être détruit(e).
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:bee_nest_destroyed",
"conditions": {
"block": "minecraft:beehive",
"item": {
"item": "minecraft:wooden_axe"
},
"num_bees_inside": 3
}
}
}
}
minecraft:bred_animals[]
Se déclenche après qu'un joueur fait se reproduire deux animaux. Conditions disponibles :
conditions:
child: L'enfant résultant de la reproduction. Peut aussi être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
parent: Le parent. Peut aussi être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
partner: Le partenaire. (L'entité avec laquelle le parent s'est reproduit) Peut aussi être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:bred_animals",
"conditions": {
"child": {
"type": "minecraft:mule"
},
"parent": {
"location": {
"biome": "minecraft:beach"
}
},
"partner": {
"effects": {
"minecraft:speed": {
"amplifier": {
"min": 2
}
}
}
}
}
}
}
}
minecraft:brewed_potion[]
Se déclenche dès que le joueur sort un item d'un alambic. Conditions disponibles :
conditions:
potion: Une potion.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:brewed_potion",
"conditions": {
"potion": "minecraft:strong_swiftness"
}
}
}
}
minecraft:changed_dimension[]
Se déclenche dès que le joueur voyage entre deux dimensions. Conditions disponibles :
conditions:
from: La dimension d'où vient le joueur. Accepte ces 3 valeurs.
to: La dimension où le joueur est allé. Mêmes valeurs que ci-dessus.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:changed_dimension",
"conditions": {
"from": "minecraft:the_end",
"to": "minecraft:overworld"
}
}
}
}
minecraft:channeled_lightning[]
Se déclenche lorsque le joueur utilise avec succès l'enchantement Canalisation sur une entité. Conditions disponibles :
conditions:
victims: Les victimes frappées par la foudre provoquée par l'enchantement Canalisation. Toutes les entités dans cette liste doivent être frappées. Chaque entrée peut également être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent à la victime.
- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:channeled_lightning",
"conditions": {
"victims": [
{
"type": "minecraft:skeleton_horse",
"nbt": "{SkeletonTrap: true}"
}
]
}
}
}
}
minecraft:construct_beacon[]
Se déclenche quand le joueur change la structure d'une balise (Quand la balise se met à jour). Conditions disponibles:
conditions:
level: Le stade de la balise une fois mise à jour.
level:
max: La valeur maximale.
min: La valeur minimale.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un example
{
"criteria": {
"example": {
"trigger": "minecraft:construct_beacon",
"conditions": {
"level": {
"min": 3
}
}
}
}
}
minecraft:consume_item[]
Se déclenche quand le joueur consomme un objet (nourriture, potions...). Conditions disponibles :
conditions:
item: L'objet qui a été consommé.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:consume_item",
"conditions": {
"item": {
"item": "minecraft:enchanted_golden_apple",
"nbt": "{display:{Name:\"Exemple\"}}"
}
}
}
}
}
minecraft:cured_zombie_villager[]
Se déclenche quand le joueur guérit un zombie-villageois. Conditions disponibles :
conditions:
villager: Le villageois qui résulte de la conversion. La balise 'type' est redondante car ce sera toujours "villager". Peut également être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
zombie: Le zombie-villageois juste avant que la conversion soit complète (et non pas au moment où la guérison commence). La balise 'type' est redondante car ce sera toujours "zombie_villager". Peut également être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:cured_zombie_villager",
"conditions": {
"villager": {
"location": {
"biome": "minecraft:plains"
}
},
"zombie": {
"distance": {
"horizontal": {
"max": 10
}
}
}
}
}
}
}
minecraft:effects_changed[]
Se déclenche lorsque le joueur obtient ou perd un effet de potion. Conditions disponibles :
conditions:
effects: Une liste d'effets que le joueur a.
<minecraft:effect_name>: Un effet de potion; la clé est le nom de l'effet.
amplifier: L'amplifieur de l'effet.
amplifier:
max: La valeur maximale.
min: La valeur minimale
duration: La durée de l'effet en ticks.
duration:
max: La valeur maximale.
min: La valeur minimale.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:effects_changed",
"conditions": {
"effects": {
"minecraft:weakness": {},
"minecraft:slowness": {
"amplifier": 2,
"duration": {
"min": 100,
"max": 500
}
}
}
}
}
}
}
minecraft:enchanted_item[]
Se déclenche lorsque le joueur enchante un objet en utilisant une table d'enchantement (ne se déclenche pas lorsque le joueur utilise une enclume ou des commandes). Conditions disponibles :
conditions:
item: L'objet une fois enchanté.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
levels: Les niveaux d'expérience dépensés pour enchanter l'objet.
levels:
max: La valeur maximale.
min: La valeur minimale.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:enchanted_item",
"conditions": {
"item": {
"item": "minecraft:wooden_sword",
"enchantments": [
{
"enchantment": "minecraft:sharpness",
"levels": {
"min": 2
}
}
]
},
"levels": {
"min": 3
}
}
}
}
}
minecraft:enter_block[]
Se déclenche quand le joueur est dans un bloc. Teste à chaque tick et se déclenche pour chaque bloc détecté (au plus huit fois, le nombre maximum de blocs dans lequel le joueur peut être), ce qui ne fonctionne uniquement si le progrès lui est retiré depuis le progrès par une fonction exécutée en récompense. Conditions disponibles :
conditions:
block: Le bloc dans lequel le joueur est. Accepte les IDs de blocs.
state: Les états du bloc.
<state_name>
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:enter_block",
"conditions": {
"block": "minecraft:rose_bush",
"state": {
"half": "lower"
}
}
}
}
}
minecraft:entity_hurt_player[]
Se déclenche quand le joueur prend des dégâts. Il n'est pas nécessaire qu'une entité soit la source des dégâts. Conditions disponibles :
conditions:
damage: Détecte les dégâts infligés au joueur.- Modèle:Héritage de NBT/conditions/dégâts
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:entity_hurt_player",
"conditions": {
"damage": {
"source_entity": {
"type": "minecraft:skeleton",
"direct_entity": {
"type": "minecraft:arrow"
}
},
"taken": {
"min": 4.0
}
}
}
}
}
}
minecraft:entity_killed_player[]
Se déclenche quand une entité tue un joueur. Conditions disponibles :
conditions:
entity: Détecte l'entité qui est la source des dégâts qui ont tué le joueur (par exemple: le squelette qui a tiré la flèche). Peut également être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
killing_blow: Détecte le type de dégâts qui ont tué le joueur.- Modèle:Héritage de NBT/conditions/type de dégâts
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:entity_killed_player",
"conditions": {
"entity": {
"type": "minecraft:skeleton"
},
"killing_blow": {
"is_projectile": true
}
}
}
}
}
minecraft:filled_bucket[]
Se déclenche quand le joueur remplit un seau. Conditions disponibles :
conditions:
item: L'objet résultant du remplissage du seau.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:filled_bucket",
"conditions": {
"item": {
"item": "minecraft:lava_bucket"
}
}
}
}
}
minecraft:fishing_rod_hooked[]
Se déclenche quand le joueur attrappe un objet ou tire vers lui une entité avec une canne à pêche. Conditions disponibles :
conditions:
entity: L'entité tirée vers le joueur. Peut également être une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
item: L'objet qui a été attrappé.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
rod: La canne à pêche utilisée.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:fishing_rod_hooked",
"conditions": {
"item": {
"item": "minecraft:bamboo"
}
}
}
}
}
minecraft:hero_of_the_village[]
Se déclenche quand le joueur when the player sort victorieux d'une invasion. Conditions disponibles :
conditions:
location: La position du joueur.- Balises communes à toutes les positions see Modèle:Héritage de NBT/conditions/position/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:hero_of_the_village",
"conditions": {
"location": {
"biome": "minecraft:plains",
"dimension": "minecraft:overworld",
"position": {
"x": 0,
"y": 60,
"z": {
"min": -10,
"max": 10
}
}
}
}
}
}
}
minecraft:impossible[]
Peut seulement être déclenché à l'aide de commandes.
Un exemple
{
"criteria": {
"example": {
"trigger": "minecraft:impossible"
}
}
}
minecraft:inventory_changed[]
Se déclenche lors de tout changement de l'inventaire du joueur. Conditions disponibles :
conditions:
items: Une liste d'items dans l'inventaire du joueur. Tous les items de la liste doivent être dans l'inventaire du joueur après l'opération, mais tous les items de l'inventaire du joueur ne doivent pas nécessairement être dans cette liste.
:- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
slots:
empty: Le nombre de cases vides dans l'inventaire.
empty:
max: La valeur maximale.
min: La valeur minimale.
full: Le nombre de cases complètement remplies dans l'inventaire.
full:
max: La valeur maximale.
min: La valeur minimale.
occupied: Le nombre de cases occupées dans l'inventaire.
occupied:
max: La valeur maximale.
min: La valeur minimale.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
An example
{
"criteria": {
"example": {
"trigger": "minecraft:inventory_changed",
"conditions": {
"items": [
{
"items": ["minecraft:polished_granite"],
"count": {
"min": 5,
"max": 10
}
},
{
"items": ["minecraft:lime_wool"]
},
{
"items": ["minecraft:wooden_sword"],
"durability": {
"min": 50
},
"nbt": "{display:{Name:\"Example\"}}"
}
],
"slots": {
"occupied": 3
}
}
}
}
}
minecraft:item_durability_changed[]
Se déclenche quand un objet de l'inventaire du joueur prend des dégâts ou change de durabilité. Conditions disponibles :
conditions:
delta: La différence de durabilité. Les nombres négatifs indiquent une diminution de la durabilité de l'objet.
delta:
max: La valeur maximale.
min: La valeur minimale.
durability: La durabilité restante de l'item.
durability:
max: La valeur maximale.
min: La valeur minimale.
item: L'objet avant qu'il soit endommagé.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
An example
{
"criteria": {
"example": {
"trigger": "minecraft:item_durability_changed",
"conditions": {
"delta": -2,
"item": {
"items": ["minecraft:wooden_axe"],
"durability": {
"max": 1
}
}
}
}
}
}
minecraft:item_used_on_block[]
Se déclenche quand un joueur interagit avec un bloc en utilisant sa main ou un objet. Conditions disponibles :
conditions:
location: La position au centre du bloc avec lequel le joueur interagit.- Balises communes à toutes les positions see Modèle:Héritage de NBT/conditions/position/modèle
item: L'objet utilisé sur le bloc.- Balises communes à tous les objets see Modèle:Héritage de NBT/conditions/objet/modèle
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
An example
{
"criteria": {
"example": {
"trigger": "minecraft:item_used_on_block",
"conditions": {
"location": {
"biome": "minecraft:modified_gravelly_mountains",
"block": {
"tag": "minecraft:campfires"
}
},
"item": {
"items": ["minecraft:porkchop"]
}
}
}
}
}
minecraft:killed_by_crossbow[]
Se déclenche quand un joueur tue une créature ou un joueur avec une arbalète. Conditions disponibles :
conditions:
unique_entity_types: Le nombre d'entités tuées.
unique_entity_types:
max: La valeur minimale.
min: La valeur maximale.
victims: Teste si l'une des entités tuées vérifie un prédicat.- Balises communes à toutes les entités see Modèle:Héritage de NBT/conditions/entité/modèle
victims: Teste si chacune des listes de prédicats est vérifiée par une entité tuée. Toutes les listes de prédicats doivent être vérifiées, et une entité tuée ne peut vérifier qu'une seule liste de prédicats.
: Une liste de prédicats qui doivent être vérifiés par une des entités tuées.
player: Une liste de prédicats qui doivent être vérifiés pour que le déclencheur s'active. Les tests s'appliquent au joueur qui obtiendrait le progrès.
An example
{
"criteria": {
"example": {
"trigger": "minecraft:killed_by_crossbow",
"conditions": {
"victims": [
{
"type": "minecraft:phantom"
},
{
"type": "minecraft:phantom"
}
],
"unique_entity_types": 5
}
}
}
}