Regles d'items

Les regles d'items sont un systeme flexible de correspondance d'items. Au lieu de comparer un item a un seul item fixe, une regle decrit un ensemble de conditions qu'un item doit respecter (son materiau, son nom, son lore, une plage de custom-model-data, l'identifiant d'un item de plugin, etc.).

Les regles sont principalement utilisees par le bouton item_drag pour decider si un joueur a le droit de deposer un item dans un slot.

Definir une regleCopier le lien vers ce titre

Une regle se definit avec une section rule. Chaque regle possede un type et ses propres options :

rule:
  type: material
  materials:
    - DIAMOND
    - EMERALD

Vous pouvez combiner plusieurs regles avec les types composites and / or (voir Combiner des regles).

Le bouton item_dragCopier le lien vers ce titre

Le bouton item_drag permet a un joueur de placer (deposer) un item dans un slot. Vous pouvez valider l'item depose avec une rule, afficher un item indicatif check-item et afficher un error-item lorsque l'item est refuse.

items:
  deposer-ici:
    slot: 13
    type: item_drag

    # Optionnel : item affiche dans le slot quand il est vide
    check-item:
      type: full
      item:
        material: LIGHT_GRAY_STAINED_GLASS_PANE
        name: "&7Deposez un diamant ici"

    # Optionnel : item affiche brievement quand l'item depose est refuse
    error-item:
      duration: 20      # En ticks (defaut : 20)
      use_cache: true   # Defaut : true
      item:
        material: RED_STAINED_GLASS_PANE
        name: "&cItem invalide !"

    # Seuls les items correspondant a cette regle sont acceptes
    rule:
      type: material
      materials:
        - DIAMOND

Types de reglesCopier le lien vers ce titre

materialCopier le lien vers ce titre

Correspond a un materiau exact.

rule:
  type: material
  materials:
    - DIAMOND
    - EMERALD_BLOCK

material-contains / material-prefix / material-suffixCopier le lien vers ce titre

Correspondance sur le nom du materiau par sous-chaine, prefixe ou suffixe. Utile pour accepter des familles entieres de materiaux (toutes les laines, tous les rondins, etc.).

rule:
  type: material-contains
  patterns:
    - "WOOL"        # correspond a WHITE_WOOL, RED_WOOL, ...

rule:
  type: material-prefix
  prefixes:
    - "DIAMOND_"    # correspond a DIAMOND_SWORD, DIAMOND_PICKAXE, ...

rule:
  type: material-suffix
  suffixes:
    - "_LOG"        # correspond a OAK_LOG, BIRCH_LOG, ...

nameCopier le lien vers ce titre

Correspondance sur le nom d'affichage de l'item.

rule:
  type: name
  match-type: CONTAINS   # EXACT (defaut), PREFIX, SUFFIX ou CONTAINS
  ignore-case: true      # Defaut : true
  names:
    - "Legendaire"

loreCopier le lien vers ce titre

Correspondance sur le lore de l'item.

rule:
  type: lore
  match-type: CONTAINS   # CONTAINS (defaut) ou EQUALS
  ignore-case: true      # Defaut : true
  values:
    - "Lie a l'ame"

tagCopier le lien vers ce titre

Correspondance sur un tag de materiau vanilla Minecraft (par exemple minecraft:planks, minecraft:wool).

rule:
  type: tag
  tags:
    - "planks"
    - "wool"

Alias : tag, material-tag, material_tag, tags.

custom-model-dataCopier le lien vers ce titre

Correspondance sur le custom model data de l'item, par valeur exacte ou par plage.

rule:
  type: custom-model-data
  values:
    - 1001
    - 1002
  ranges:
    - min: 2000
      max: 2999

Regles d'items de pluginsCopier le lien vers ce titre

Ces regles font correspondre un item personnalise par son identifiant de plugin. Elles supportent les jokers (wildcards) et une option ignore-case (defaut true), et necessitent que le plugin correspondant soit installe.

rule:
  type: itemsadder
  ignore-case: true
  items:
    - "myitems:ruby"
    - "myitems:*"      # joker

Types de regles de plugins disponibles : craftengine, denizen, eco, executableblocks, executableitems, headdatabase, itemsadder, mmoitems, nexo, nextgens, nova, oraxen, slimefun.

Combiner des reglesCopier le lien vers ce titre

Utilisez and / or pour combiner plusieurs regles.

and — l'item doit correspondre a toutes les sous-regles :

rule:
  type: and
  rules:
    - type: material
      materials:
        - DIAMOND_SWORD
    - type: name
      match-type: CONTAINS
      names:
        - "Legendaire"

or — l'item doit correspondre a au moins une sous-regle :

rule:
  type: or
  rules:
    - type: material
      materials:
        - DIAMOND
    - type: material
      materials:
        - EMERALD

Voir aussiCopier le lien vers ce titre

• Validation item_drag avec check-inventory
• Plugins supportes