Advancement Generator Minecraft : créer des progrès personnalisés

Outil Minecraft

Créer des progrès personnalisés dans Minecraft Java permet d’ajouter une vraie progression à une map, un serveur ou un datapack : quêtes, objectifs secondaires, récompenses, recettes à débloquer ou simplement une notification bien placée au bon moment. Le système existe depuis Minecraft 1.12, mais son format a évolué avec les versions et les vieux générateurs ne sont plus toujours adaptés.

L’ancien Advancements Generator de Destru7ion reste accessible, mais il indique une compatibilité allant de Minecraft 1.12 à 1.16. Pour travailler sur les versions récentes de Minecraft Java, il vaut mieux utiliser le générateur de Misode, qui produit le JSON actuel d’un progrès et permet de choisir directement la version visée.

Ancienne interface du générateur de progrès Advancements Generator pour Minecraft — Ancienne interface d’Advancements Generator, un outil prévu pour les versions 1.12 à 1.16.

À noter : Ce guide concerne Minecraft Java Edition. Les progrès sont des données de datapack. Ils ne fonctionnent pas de la même manière que les succès de Bedrock Edition.

Quel générateur utiliser aujourd’hui ?

Le générateur historique de Destru7ion a rendu de nombreux services à l’époque de Minecraft 1.12, notamment grâce à son aperçu sous forme d’arbre. Il n’est toutefois plus pensé pour le format des versions modernes. Certaines syntaxes qu’il propose, comme "item" dans l’icône, ne correspondent plus au JSON généré par les outils récents.

Pour un datapack actuel, utilisez plutôt Misode Advancement Generator. L’outil fonctionne dans le navigateur et permet de générer le fichier JSON d’un progrès à partir des champs principaux : affichage, critères, conditions de validation, parent et récompenses. Il ne remplace pas une vérification en jeu, mais évite une grande partie des erreurs de syntaxe.

Ouvrir Misode Advancement Generator

Conseil : Choisissez la version de Minecraft avant de commencer. Le générateur adapte alors les identifiants, les objets et les formats attendus par cette version.

Les éléments d’un progrès personnalisé

Un progrès est un fichier JSON placé dans un datapack. Il peut être visible dans l’interface des progrès ou rester totalement invisible pour servir de déclencheur technique. Dans les deux cas, le principe reste le même : le jeu surveille un ou plusieurs critères, valide le progrès lorsque les conditions sont remplies, puis applique éventuellement une récompense.

Display : l’apparence du progrès

Réglages d’affichage d’un progrès Minecraft dans l’ancien générateur — Les réglages d’affichage : titre, description, icône et type de cadre.

La partie display contient ce que le joueur voit : une icône, un titre, une description et le type de cadre. Trois cadres sont disponibles :

task pour une tâche classique ;
goal pour un objectif plus important ;
challenge pour un défi, généralement associé à une récompense plus notable.

Vous pouvez aussi décider si la notification apparaît à l’écran avec show_toast, si le progrès est annoncé dans le chat avec announce_to_chat et s’il reste caché jusqu’à son obtention avec hidden. Un progrès racine peut recevoir une texture de fond et ouvrir son propre onglet dans le menu.

Criteria : la condition à remplir

Configuration des critères d’un progrès Minecraft dans l’ancien générateur — Les critères définissent l’action qui permet de valider le progrès.

Les critères correspondent aux actions observées par le jeu. Ils peuvent suivre l’obtention d’un objet, l’entrée dans une dimension, la mort d’une créature, l’utilisation d’un objet, une position précise ou encore l’accomplissement d’un autre progrès. Chaque critère possède un nom interne, puis un trigger et, selon le déclencheur, des conditions supplémentaires.

Un critère simple peut par exemple vérifier que le joueur possède une longue-vue. Un autre peut demander qu’il se trouve dans un biome donné. Pour des mécaniques plus poussées, les critères peuvent aussi s’appuyer sur des prédicats, des fonctions et des tags de datapack.

Requirements : choisir entre ET et OU

Réglages des exigences d’un progrès Minecraft dans l’ancien générateur — Les exigences déterminent quels critères doivent être validés ensemble.

Si un progrès contient plusieurs critères et que vous ne précisez rien, Minecraft demande généralement de tous les remplir. La clé requirements sert à modifier cette logique. Chaque ligne correspond à un groupe OU, tandis que les lignes entre elles sont liées par un ET.

Exemple de logique

[["A"], ["B"]] demande A et B.
[["A", "B"]] accepte A ou B.
[["A", "B"], ["C"]] demande C, plus A ou B.

Rewards : donner une récompense

Réglages des récompenses d’un progrès Minecraft dans l’ancien générateur — Les récompenses peuvent donner de l’expérience, des recettes, un butin ou lancer une fonction.

La section rewards n’est pas obligatoire. Elle permet de donner de l’expérience, de débloquer des recettes, de faire tirer une table de butin ou de lancer une fonction .mcfunction. La fonction est souvent la solution la plus souple pour les maps : elle peut donner un objet personnalisé, modifier un score, afficher un message ou démarrer l’étape suivante d’une quête.

Créer un premier progrès avec Misode

Pour débuter sans vous perdre dans un arbre entier, créez d’abord un progrès enfant rattaché à l’onglet de progression vanilla. Dans Misode, choisissez votre version de jeu, puis renseignez un parent tel que minecraft:story/root. Votre progrès apparaîtra alors dans l’onglet Minecraft, à la suite de la progression de base.

Dans Display, choisissez une icône, un titre, une description et le cadre task.
Dans Criteria, ajoutez un déclencheur minecraft:inventory_changed et sélectionnez l’objet à détecter.
Dans Rewards, ajoutez quelques points d’expérience si le progrès mérite une récompense.
Copiez le JSON généré dans un nouveau fichier, puis donnez-lui un nom simple, en minuscules et sans espace.

Un progrès racine fonctionne sur le même principe, mais n’a pas de parent. Il doit posséder un affichage valide et une texture de fond si vous souhaitez créer un onglet distinct. C’est la bonne méthode pour une série de quêtes indépendante, par exemple sur une map aventure ou un serveur roleplay.

Exemple JSON actuel

L’exemple ci-dessous donne un progrès lorsque le joueur obtient une longue-vue. Il est rattaché à l’onglet Minecraft et récompense le joueur avec cinq points d’expérience.

{
  "parent": "minecraft:story/root",
  "display": {
    "icon": {
      "id": "minecraft:spyglass"
    },
    "title": "À l’horizon",
    "description": "Obtenir une longue-vue",
    "frame": "task",
    "show_toast": true,
    "announce_to_chat": false,
    "hidden": false
  },
  "criteria": {
    "obtenir_longue_vue": {
      "trigger": "minecraft:inventory_changed",
      "conditions": {
        "items": [
          {
            "items": "minecraft:spyglass"
          }
        ]
      }
    }
  },
  "rewards": {
    "experience": 5
  }
}

La ligne "icon": { "id": "minecraft:spyglass" } est importante : les versions modernes attendent un identifiant d’objet dans id. Les anciens exemples qui utilisent "item" ne doivent pas être repris tels quels.

Installer et tester le progrès

Placez le fichier dans votre datapack, dans le chemin suivant :

votre_monde/datapacks/mon_pack/data/mon_pack/advancement/a_l_horizon.json

Le dossier important est advancement, au singulier. Après avoir ajouté ou modifié le fichier, ouvrez votre monde et utilisez /reload. Minecraft recharge alors les données du datapack. La commande suivante permet de vérifier que le pack est bien détecté :

/datapack list

Pour tester l’affichage sans attendre de remplir le critère, vous pouvez temporairement donner le progrès à votre joueur :

/advancement grant @s only mon_pack:a_l_horizon

La commande /advancement permet aussi de retirer un progrès, de l’accorder avec ses parents ou de ne valider qu’un critère précis. Pour aller plus loin sur la structure des fichiers et les déclencheurs, consultez notre guide pour créer des progrès personnalisés dans Minecraft.

Erreurs fréquentes

Attention : Un progrès peut ne pas apparaître dans le menu sans que le jeu affiche un message très clair. Vérifiez d’abord le chemin du fichier, le namespace, le JSON et la présence d’un affichage valide.

Utiliser advancements au pluriel : le dossier actuel s’appelle advancement.
Oublier title, description ou icon : un progrès visible doit disposer de ces trois champs.
Conserver une ancienne syntaxe : les exemples de Minecraft 1.12 à 1.16 utilisent parfois des formats désormais dépassés.
Mettre des majuscules ou des espaces dans le chemin : utilisez des noms comme ma_quete ou premier_objectif.
Oublier /reload : le jeu ne relit pas automatiquement votre JSON après une modification.

En cas de doute, ouvrez latest.log dans le dossier logs de Minecraft après un /reload. Une virgule en trop, une accolade manquante ou un identifiant erroné y est généralement signalé avec le nom du fichier concerné.

Questions fréquentes

Advancements Generator fonctionne-t-il encore avec Minecraft récent ?

Le générateur historique de Destru7ion indique une compatibilité de Minecraft 1.12 à 1.16. Pour les versions actuelles, utilisez plutôt le générateur de progrès Misode et vérifiez toujours le JSON obtenu en jeu.

Peut-on créer un nouvel onglet de progrès ?

Oui. Créez un progrès racine sans parent, ajoutez un affichage complet et une texture de fond. Les progrès enfants rattachés à ce fichier formeront votre arbre personnalisé.

Un progrès peut-il donner des objets ?

Oui. Vous pouvez utiliser une table de butin dans rewards ou lancer une fonction .mcfunction qui exécute les commandes nécessaires.

Comment retirer un progrès déjà obtenu ?

Utilisez la commande /advancement revoke avec le joueur, le mode de retrait voulu et l’identifiant du progrès. Cette commande est pratique pour tester plusieurs fois la même quête.

Un datapack peut-il modifier les progrès vanilla ?

Oui, à condition de reprendre l’identifiant et le chemin du progrès concerné dans le namespace minecraft. Cette méthode remplace toutefois une donnée vanilla : utilisez-la avec prudence et testez-la après chaque mise à jour.

Pour mieux comprendre les progrès visibles dans le jeu et leurs différentes branches, retrouvez aussi notre guide complet des progrès de Minecraft Java.