Progrès/Format JSON

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 /tellraw et diverses autres commandes)
    • 
       frame (facultatif) : Le type de cadre pour l'icône : challenge pour un cadre sophistiqué, goal pour un cadre à bords arrondis ou task pour 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 /tellraw et 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 sur true, 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é:

1. Son progrès racine doit être un onglet valide.
2. 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 :
<div class="treeview">
* {{nbt|compound|conditions}}:
** {{nbt|compound|entity}}: L'entité tirée vers le joueur. Peut également être une liste de [[Prédicat|prédicats]] qui doivent être vérifiés pour que le déclencheur s'active.
*** {{Héritage de NBT/conditions/entité|indent=***}}
** {{nbt|compound|item}}: L'objet qui a été attrappé.
*** {{Héritage de NBT/conditions/objet|indent=***}}
** {{nbt|compound|rod}}: La canne à pêche utilisée.
*** {{Héritage de NBT/conditions/objet|indent=***}}
** {{nbt|list|player}}: Une liste de [[Prédicat|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.
</div>
<div class="collapsible collapsed collapsetoggle-inline" data-expandtext="afficher" data-collapsetext="masquer">
Un exemple
<div class="collapsible-content"><syntaxhighlight lang="json">
{
  "criteria": {
    "example": {
      "trigger": "minecraft:fishing_rod_hooked",
      "conditions": {
        "item": {
          "item": "minecraft:bamboo"
        }
      }
    }
  }
}