Tags personnalisés

Définir des groupes réutilisables d'objets, blocs, meubles et recettes dans le YAML de contenu ItemsAdder.

Les tags personnalisés vous permettent de regrouper des IDs de contenu une seule fois et de réutiliser ce groupe dans les fonctionnalités ItemsAdderAdditions prises en charge. Ils sont chargés depuis une section tags au niveau racine dans n'importe quel fichier YAML de contenu ItemsAdder.

Structure de base

info:
  namespace: my_pack

tags:
  ruby_tools:
    type: item
    values:
      - ruby_pickaxe
      - ruby_axe
      - mmoitems:tool:ruby_hammer

  decorative_blocks:
    type: block
    values:
      - ruby_lamp
      - minecraft:amethyst_block

  trading_stations:
    type: furniture
    values:
      - alchemy_table
      - forge_table

  ruby_recipes:
    type: recipe
    values:
      - ruby_sword
      - ruby_pickaxe

Référencez un tag avec #tag_id dans le même namespace ou #namespace:tag_id depuis un autre namespace. Consultez IDs pour les règles de référence de tags.

Types de tags

Type	Alias	Les valeurs peuvent contenir
`item`	`items`	Objets ItemsAdder, objets vanilla, objets MMOItems et tags d'objets imbriqués.
`block`	`blocks`	Blocs ItemsAdder, blocs vanilla et tags de blocs imbriqués.
`furniture`	`furnitures`	IDs de meubles ItemsAdder et tags de meubles imbriqués.
`recipe`	`recipes`	IDs de recettes et tags de recettes imbriqués.

Si type est omis, le tag est traité comme un tag d'objets.

Tags imbriqués

Les tags peuvent inclure d'autres tags du même type.

info:
  namespace: my_pack

tags:
  ruby_tools:
    type: item
    values:
      - ruby_pickaxe
      - ruby_axe

  mining_tools:
    type: item
    values:
      - "#ruby_tools"
      - minecraft:iron_pickaxe
      - minecraft:diamond_pickaxe

Les tags imbriqués sont résolus pendant le rechargement. Les références circulaires sont détectées et ignorées au lieu de bloquer le serveur.

Où fonctionnent les tags personnalisés

Les tags personnalisés sont pris en charge par les chemins de correspondance d'IDs à l'exécution, notamment :

conditions de progrès pour objets, blocs, meubles et recettes
prédicats de joueur pour objets, équipement, slots et vérifications de blocs
items du comportement stackable
ingrédients de recettes de craft (iaa_crafting_table)

Exemple complet

info:
  namespace: my_pack

tags:
  ruby_tools:
    type: item
    values:
      - ruby_pickaxe
      - ruby_axe

items:
  charged_ruby:
    display_name: "<red>Charged Ruby"
    behaviours:
      stackable:
        blocks:
          - charged_ruby_block
        items:
          - "#my_pack:ruby_tools"

advancements:
  collect_any_ruby_tool:
    display:
      title: "Ruby Tools"
      description: "Obtain any ruby tool."
      icon: my_pack:ruby_pickaxe
    criteria:
      collect:
        trigger: obtain_item
        conditions:
          items:
            - "#my_pack:ruby_tools"

Comportement au rechargement

Les tags personnalisés sont préparés avant le rechargement des actions, comportements, recettes, progrès et de la génération du monde. Exécutez /iareload après avoir modifié des tags.

Erreurs courantes

Mélanger les types de tags. Un tag de meubles ne peut pas contenir un tag d'objets.
Définir deux fois le même type et le même ID de tag. La première déclaration l'emporte.
S'attendre à ce que les tags personnalisés créent des piles d'objets. Utilisez des IDs d'objets concrets pour les sorties comme les résultats de recettes, toast.icon, clear_item.item et replace_item.item.
Remplacer un tag qui ressemble à un tag vanilla, comme #minecraft:planks. Les tags personnalisés sont résolus en premier lorsqu'un tag personnalisé avec cet ID existe.