Configuratiereferentie

Volledige YAML-referentie voor aangepaste ItemsAdder-voortgangen met weergave-eigenschappen, criteria, beloningen en voltooiingsacties in één configuratiebestand.

Elke voortgangsvermelding bevindt zich onder de advancements-sleutel op het hoogste niveau in elk ItemsAdder-inhoudsbestand. IAA haalt automatisch bestanden op die deze sleutel bevatten.

info:
  namespace: my_pack

advancements:
  <advancement_id>:
    # ... opties hieronder

Opties op het hoogste niveau

Sleutel	Type	Standaard	Beschrijving
`enabled`	bool	`true`	Stel dit in op `false` om deze voortgang over te slaan zonder deze uit het bestand te verwijderen.
`parent`	string	(geen)	ID van de bovenliggende voortgang. Laat weg om dit een hoofdvoortgang (tabblad) te maken. Zie Ouder.
`display`	section	(vereist)	Visuele instellingen. Zie Weergave.
`criteria`	section	(geen)	Voorwaarden die moeten worden vervuld om de voortgang te voltooien. Elk criterium heeft één trigger, triggerspecifieke voorwaarden en een optioneel `conditions.player`-predicaat. Zie Triggers en Spelerspredicaten.
`rewards`	section	(geen)	Ervaring en receptontgrendeling. Zie Beloningen.
`on_complete`	section	(geen)	Acties die worden uitgevoerd wanneer de voortgang volledig is voltooid. Zie Voltooiingsacties.

Ouder

parent: root              # dezelfde namespace als dit bestand, wordt opgelost als my_pack:root
parent: otherns:someroot  # expliciete namespace

Als parent geen dubbele punt bevat, wordt de namespace van het bestand eraan vooraf toegevoegd. Als parent helemaal wordt weggelaten, wordt deze voortgang een hoofdvoortgang en maakt een nieuw tabblad in het voortgangsscherm.

Weergave

display:
  title: "<gold>Eerste Robijnzwaard"
  description: "<gray>Verkrijg je eerste aangepaste zwaard."
  icon: my_pack:ruby_sword
  frame: task
  background: "minecraft:gui/advancements/backgrounds/adventure"
  show_toast: true
  announce_to_chat: true
  hidden: false

Sleutel	Type	Standaard	Beschrijving
`title`	string	(vereist)	Voortgangstitel. Ondersteunt MiniMessage.
`description`	string	`""`	Tooltip-beschrijving. Ondersteunt MiniMessage.
`icon`	`namespace:id`	`minecraft:barrier`	Item dat als pictogram wordt weergegeven. Accepteert ItemsAdder-item-ID's, MMOItems-ID's of vanilla-materiaal-ID's. Tags worden niet ondersteund, omdat het pictogram naar één concreet item moet verwijzen.
`frame`	string	`task`	Vorm van de pictogramrand: `task`, `goal` of `challenge`.
`background`	string	(geen)	Alleen hoofdvoortgangen. Tekstuurpad voor de tabblad-achtergrond (bijv. `minecraft:gui/advancements/backgrounds/adventure`).
`show_toast`	bool	`true`	Toon een toast-melding wanneer voltooid.
`announce_to_chat`	bool	`true`	Stuur de voltooiing naar alle spelers in de chat.
`hidden`	bool	`false`	Verberg deze voortgang totdat deze is voltooid.

background is wat maakt dat een voortgang een nieuw tabblad creëert. Het wordt alleen gebruikt op hoofdvoortgangen (geen parent).

Criteria

Elk criterium heeft een trigger en een optionele conditions-sectie. Triggerspecifieke opties staan direct onder conditions. Je kunt ook een player-predicaat toevoegen aan elke runtime-trigger om een extra spelerstatuscontrole te vereisen voordat het criterium wordt toegekend.

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

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

Sleutel	Type	Standaard	Beschrijving
`trigger`	string	`impossible`	Triggertype voor dit criterium. Zie de volledige triggerreferentie.
`conditions`	section	(geen)	Triggerspecifieke opties, plus optionele `player`-predicaten.
`conditions.player`	section of lijst	(elke speler)	Extra spelerspredicaat dat wordt gecontroleerd wanneer het criterium bijna wordt toegekend. Wordt genegeerd door de trigger `impossible`. Zie Spelerspredicaten.

Kindvoortgangen hebben minstens één geldig criterium nodig. Hoofdvoortgangen kunnen criteria weglaten; IAA maakt een intern hoofdcriterium aan en kent dit automatisch toe zodat het voortgangstabblad verschijnt.

Beloningen

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

Sleutel	Type	Standaard	Beschrijving
`experience`	integer	`0`	Ervaringspunten toegekend bij voltooiing.
`loot`	lijst van strings	`[]`	Loottabelsleutels die bij voltooiing worden gebruikt.
`recipes`	lijst van strings	`[]`	Receptsleutels om te ontgrendelen. Accepteert `namespace:id` of een `id` zonder namespace (gebruikt de bestandsnamespace).

Volledig voorbeeld

info:
  namespace: my_pack

advancements:

  root:
    display:
      title: "Mijn Server"
      description: "Aangepaste voortgangen voor Mijn Server."
      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: "Eerste Robijnzwaard"
      description: "Verkrijg je eerste aangepaste zwaard."
      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>Voortgang!"
        subtitle: "<gray>Eerste robijnzwaard verkregen."
      commands:
        reward:
          command: "give {player} gold_ingot 4"
          as_console: true

  master_crafter:
    parent: my_pack:root
    display:
      title: "Meestervakman"
      description: "Maak het zwaard, schild en drankje."
      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

Multi-criteria-voortgangen (zoals master_crafter hierboven) vereisen dat alle criteria worden voltooid. Elk criterium wordt onafhankelijk bijgehouden; voortgang wordt opgeslagen door vanilla en overleeft herladen.