Référence de configuration

Référence YAML complète pour les progrès ItemsAdder personnalisés avec propriétés d’affichage, critères, récompenses et actions d’achèvement dans un seul fichier de configuration.

Chaque entrée de progrès se trouve sous la clé de niveau supérieur advancements dans n’importe quel fichier de contenu ItemsAdder. IAA récupère automatiquement les fichiers qui contiennent cette clé.

info:
  namespace: my_pack

advancements:
  <advancement_id>:
    # ... options ci-dessous

Options de niveau supérieur

Clé	Type	Par défaut	Description
`enabled`	booléen	`true`	Définissez cette option sur `false` pour ignorer ce progrès sans le supprimer du fichier.
`parent`	chaîne	(aucun)	ID du progrès parent. Omettez pour créer un progrès racine (onglet). Voir Parent.
`display`	section	(requis)	Paramètres visuels. Voir Affichage.
`criteria`	section	(aucun)	Conditions qui doivent être remplies pour terminer le progrès. Chaque critère possède un déclencheur, des conditions propres au déclencheur et un prédicat `conditions.player` optionnel. Voir Déclencheurs et Prédicats de joueur.
`rewards`	section	(aucun)	Expérience et déverrouillage de recettes. Voir Récompenses.
`on_complete`	section	(aucun)	Actions exécutées lorsque le progrès est entièrement terminé. Voir Actions d’achèvement.

Parent

parent: root              # même espace de noms que ce fichier, se résout en my_pack:root
parent: otherns:someroot  # espace de noms explicite

Si parent ne contient pas de deux-points, l’espace de noms du fichier est ajouté. Si parent est omis entièrement, ce progrès devient une racine et crée un nouvel onglet dans l’écran des progrès.

Affichage

display:
  title: "<gold>Première Épée Rubis"
  description: "<gray>Obtenez votre première épée personnalisée."
  icon: my_pack:ruby_sword
  frame: task
  background: "minecraft:gui/advancements/backgrounds/adventure"
  show_toast: true
  announce_to_chat: true
  hidden: false

Clé	Type	Par défaut	Description
`title`	chaîne	(requis)	Titre du progrès. Prend en charge MiniMessage.
`description`	chaîne	`""`	Description de l’infobulle. Prend en charge MiniMessage.
`icon`	`namespace:id`	`minecraft:barrier`	Objet affiché en tant qu’icône. Accepte les IDs d’objets ItemsAdder, les IDs MMOItems ou les IDs de matériaux vanilla. Les tags ne sont pas pris en charge, car l’icône doit résoudre un objet concret.
`frame`	chaîne	`task`	Forme de la bordure de l'icône : `task`, `goal` ou `challenge`.
`background`	chaîne	(aucun)	Progrès racines uniquement. Chemin de texture pour l’arrière-plan de l’onglet (par exemple `minecraft:gui/advancements/backgrounds/adventure`).
`show_toast`	booléen	`true`	Affiche une notification toast une fois le progrès terminé.
`announce_to_chat`	booléen	`true`	Diffuser l'achèvement à tous les joueurs dans le chat.
`hidden`	booléen	`false`	Masque ce progrès jusqu’à ce qu’il soit terminé.

background est ce qui crée un nouvel onglet pour un progrès. Il n'est utilisé que sur les progrès racines (pas de parent).

Critères

Chaque critère possède un trigger et une section conditions optionnelle. Les options propres au déclencheur se placent directement sous conditions. Vous pouvez aussi ajouter un prédicat player à n’importe quel déclencheur d’exécution afin d’exiger une vérification supplémentaire de l’état du joueur avant l’attribution du critère.

criteria:
  sneaky_sleep:
    trigger: slept_in_bed
    conditions:
      player:
        flags:
          is_sneaking: true

  high_fall:
    trigger: fall_from_height
    conditions:
      distance:
        y:
          min: 30

Clé	Type	Par défaut	Description
`trigger`	chaîne	`impossible`	Type de déclencheur pour ce critère. Voir la référence complète des déclencheurs.
`conditions`	section	(aucun)	Options propres au déclencheur, plus les prédicats `player` optionnels.
`conditions.player`	section ou liste	(n’importe quel joueur)	Prédicat de joueur supplémentaire vérifié au moment où le critère est sur le point d’être attribué. Ignoré par le déclencheur `impossible`. Voir Prédicats de joueur.

Les progrès enfants ont besoin d’au moins un critère valide. Les progrès racines peuvent omettre criteria ; IAA crée un critère racine interne et l’accorde automatiquement afin que l’onglet du progrès apparaisse.

Récompenses

rewards:
  experience: 50
  recipes:
    - my_pack:ruby_sword_recipe
    - minecraft:golden_apple

Clé	Type	Par défaut	Description
`experience`	entier	`0`	Points d’expérience accordés à l'achèvement.
`loot`	liste de chaînes	`[]`	Clés de table de butin à utiliser à l'achèvement.
`recipes`	liste de chaînes	`[]`	Clés de recette à déverrouiller. Accepte `namespace:id` ou un `id` simple (utilise l’espace de noms du fichier).

Exemple complet

info:
  namespace: my_pack

advancements:

  root:
    display:
      title: "Mon Serveur"
      description: "Progrès personnalisés pour Mon Serveur."
      icon: minecraft:nether_star
      background: "minecraft:gui/advancements/backgrounds/adventure"
      show_toast: false
      announce_to_chat: false
      frame: task

  first_ruby_sword:
    parent: root
    display:
      title: "Première Épée Rubis"
      description: "Obtiens ta première épée personnalisée."
      icon: my_pack:ruby_sword
      frame: task
      show_toast: true
      announce_to_chat: true
    criteria:
      obtain:
        trigger: obtain_item
        conditions:
          items:
            - my_pack:ruby_sword
          amount: 1
    on_complete:
      sound:
        name: minecraft:entity.player.levelup
      title:
        title: "<gold>Progrès !"
        subtitle: "<gray>Première épée rubis obtenue."
      commands:
        reward:
          command: "give {player} gold_ingot 4"
          as_console: true

  master_crafter:
    parent: my_pack:root
    display:
      title: "Maître Artisan"
      description: "Fabrique l'épée, le bouclier et la potion."
      icon: minecraft:crafting_table
      frame: goal
    criteria:
      craft_sword:
        trigger: craft_recipe
        conditions:
          recipe: my_pack:ruby_sword_recipe
      craft_shield:
        trigger: craft_recipe
        conditions:
          recipe: my_pack:ruby_shield_recipe
      craft_potion:
        trigger: craft_recipe
        conditions:
          recipe: my_pack:ruby_potion_recipe
    rewards:
      experience: 100
      loot:
        - minecraft:chests/simple_dungeon

Les progrès à plusieurs critères (comme master_crafter ci-dessus) nécessitent que tous les critères soient terminés. Chaque critère est suivi indépendamment ; la progression est sauvegardée nativement par Minecraft et survit aux rechargements.