Configuration des Catégories

Les catégories organisent les objets dans l'hôtel des ventes, facilitant la recherche pour les joueurs. Configurez-les dans categories.yml.

Structure de Base d'une Catégorie

categories:
  weapons:
    # Nom d'affichage
    name: "&cArmes"

    # Icône dans le menu des catégories
    icon:
      material: DIAMOND_SWORD
      name: "&cArmes"
      lore:
        - "&7Épées, arcs et plus"

    # Emplacement dans le menu des catégories (0-53)
    slot: 10

    # Règles pour correspondre aux objets (logique ET - toutes doivent correspondre)
    rules:
      - type: material
        values:
          - DIAMOND_SWORD
          - IRON_SWORD
          - NETHERITE_SWORD
          - BOW
          - CROSSBOW

Chaque catégorie peut aussi inclure des banned-rules optionnelles pour exclure des items spécifiques. Voir Règles d'Exclusion (Banned Rules) ci-dessous.

Types de Règles

Règle par Matériau

Correspondre aux objets par type de matériau :

rules:
  - type: material
    values:
      - DIAMOND_SWORD
      - DIAMOND_AXE
      - DIAMOND_PICKAXE

Vous pouvez utiliser des caractères génériques :

rules:
  - type: material
    values:
      - "*_SWORD"      # Toutes les épées
      - "*_AXE"        # Toutes les haches
      - "DIAMOND_*"    # Tous les objets en diamant

Règle par Nom

Correspondre aux objets par nom d'affichage :

rules:
  - type: name
    # Mode de correspondance : CONTAINS, EQUALS, STARTS_WITH, ENDS_WITH, REGEX
    mode: CONTAINS
    value: "Légendaire"
    # Correspondance sensible à la casse
    case-sensitive: false

Exemples :

# Correspondre aux objets avec "Épique" dans le nom
- type: name
  mode: CONTAINS
  value: "Épique"

# Correspondre aux objets commençant par "[Mythique]"
- type: name
  mode: STARTS_WITH
  value: "[Mythique]"

# Correspondre avec regex (objets avec chiffres romains)
- type: name
  mode: REGEX
  value: ".*[IVX]+$"

Règle par Lore

Correspondre aux objets par contenu du lore :

rules:
  - type: lore
    mode: CONTAINS
    value: "Lié à l'âme"
    # Vérifier une ligne spécifique (optionnel, -1 pour n'importe quelle ligne)
    line: -1

Règle par Tag NBT

Correspondre aux objets par tags NBT (utile pour les objets personnalisés) :

rules:
  - type: tag
    # Chemin NBT
    path: "CustomItem.type"
    value: "weapon"

Pour vérifier si un tag existe :

rules:
  - type: tag
    path: "Enchantments"
    exists: true

Règle par Custom Model Data

Correspondre aux objets par custom model data :

rules:
  - type: model-data
    # Valeur exacte
    value: 1001

# Ou plage
- type: model-data
  min: 1000
  max: 1999

Règle par Enchantement

Correspondre aux objets par enchantements :

rules:
  - type: enchantment
    # Nom de l'enchantement
    enchantment: SHARPNESS
    # Niveau minimum (optionnel)
    min-level: 1

Logique des Règles

Logique ET (Par Défaut)

Toutes les règles doivent correspondre pour que l'objet soit dans la catégorie :

categories:
  legendary-weapons:
    name: "&6Armes Légendaires"
    # L'objet doit être une épée ET avoir "Légendaire" dans le nom
    rules:
      - type: material
        values:
          - "*_SWORD"
      - type: name
        mode: CONTAINS
        value: "Légendaire"

Logique OU

Utilisez any-of pour la logique OU - l'objet correspond si une règle correspond :

categories:
  weapons:
    name: "&cArmes"
    any-of:
      - type: material
        values:
          - "*_SWORD"
      - type: material
        values:
          - BOW
          - CROSSBOW

Logique Combinée

Mélangez ET et OU :

categories:
  epic-gear:
    name: "&5Équipement Épique"
    # Doit correspondre à la règle de matériau ET au moins une dans any-of
    rules:
      - type: material
        values:
          - "*_SWORD"
          - "*_HELMET"
          - "*_CHESTPLATE"
    any-of:
      - type: name
        mode: CONTAINS
        value: "Épique"
      - type: lore
        mode: CONTAINS
        value: "Objet Rare"

Règles d'Exclusion (Banned Rules)

Vous pouvez ajouter une liste banned-rules à n'importe quelle catégorie pour exclure des items spécifiques, même s'ils correspondent aux règles d'inclusion. C'est utile quand une règle large (comme un suffixe de matériau) inclut des items qui devraient appartenir à une autre catégorie — par exemple, des items custom identifiés par leur CustomModelData.

Les banned rules utilisent les mêmes types de règles que les règles normales (material, material-suffix, tag, name, lore, custom-model-data, and/or, etc.).

Comment ça fonctionne

1. L'item est d'abord vérifié contre les banned-rules
2. Si une seule banned rule correspond, l'item est exclu de la catégorie
3. Ce n'est qu'ensuite que les rules normales sont évaluées

Exemple : Exclure des items custom d'une catégorie

Une houe en netherite apparaît normalement dans la catégorie "Outils". Mais une houe en netherite avec un CustomModelData de 300 (un item custom d'un resource pack) ne devrait pas y apparaître. Utilisez banned-rules pour l'exclure :

tools:
  display-name: "Outils"
  rules:
    - type: material-suffix
      suffixes:
        - "_PICKAXE"
        - "_AXE"
        - "_SHOVEL"
        - "_HOE"
    - type: material
      materials:
        - SHEARS
        - FLINT_AND_STEEL
        - FISHING_ROD

  # Les items correspondant à ces règles sont EXCLUS de la catégorie
  banned-rules:
    - type: custom-model-data
      values:
        - 300

Exemple : Exclure des matériaux spécifiques

weapons:
  display-name: "Armes"
  rules:
    - type: material-suffix
      suffixes:
        - "_SWORD"
    - type: material
      materials:
        - BOW
        - CROSSBOW
        - TRIDENT

  # Exclure les épées en bois de la catégorie armes
  banned-rules:
    - type: material
      materials:
        - WOODEN_SWORD

Exemple : Exclure par nom

armor:
  display-name: "Armures"
  rules:
    - type: material-suffix
      suffixes:
        - "_HELMET"
        - "_CHESTPLATE"
        - "_LEGGINGS"
        - "_BOOTS"

  # Exclure les items cosmétiques
  banned-rules:
    - type: name
      mode: CONTAINS
      values:
        - "Cosmétique"

astuce

Les banned rules fonctionnent aussi sur la catégorie divers (fallback). Vous pouvez les utiliser pour empêcher certains items d'apparaître dans la catégorie divers.

Exemple Complet de Catégories

# Catégorie par défaut pour les objets non correspondants
default-category: misc

categories:
  weapons:
    name: "&cArmes"
    icon:
      material: DIAMOND_SWORD
      name: "&cArmes"
      lore:
        - "&7Épées, haches, arcs et plus"
        - ""
        - "&eCliquez pour parcourir !"
    slot: 10
    rules:
      - type: material
        values:
          - "*_SWORD"
          - "*_AXE"
          - BOW
          - CROSSBOW
          - TRIDENT

  armor:
    name: "&9Armure"
    icon:
      material: DIAMOND_CHESTPLATE
      name: "&9Armure"
      lore:
        - "&7Casques, plastrons et plus"
    slot: 11
    rules:
      - type: material
        values:
          - "*_HELMET"
          - "*_CHESTPLATE"
          - "*_LEGGINGS"
          - "*_BOOTS"
          - SHIELD
          - ELYTRA

  tools:
    name: "&6Outils"
    icon:
      material: DIAMOND_PICKAXE
      name: "&6Outils"
      lore:
        - "&7Pioches, pelles et plus"
    slot: 12
    rules:
      - type: material
        values:
          - "*_PICKAXE"
          - "*_SHOVEL"
          - "*_HOE"
          - SHEARS
          - FISHING_ROD
          - FLINT_AND_STEEL

  potions:
    name: "&dPotions"
    icon:
      material: POTION
      name: "&dPotions"
      lore:
        - "&7Potions et matériaux d'alchimie"
    slot: 13
    rules:
      - type: material
        values:
          - POTION
          - SPLASH_POTION
          - LINGERING_POTION
          - TIPPED_ARROW

  enchanted:
    name: "&bObjets Enchantés"
    icon:
      material: ENCHANTED_BOOK
      name: "&bObjets Enchantés"
      lore:
        - "&7Tous les objets enchantés"
    slot: 14
    rules:
      - type: tag
        path: "Enchantments"
        exists: true

  blocks:
    name: "&aBlocs"
    icon:
      material: GRASS_BLOCK
      name: "&aBlocs"
      lore:
        - "&7Blocs de construction"
    slot: 15
    rules:
      - type: material
        values:
          - "*_BLOCK"
          - "*_BRICKS"
          - "*_PLANKS"
          - "*_SLAB"
          - "*_STAIRS"
          - "*_WALL"
          - "*_FENCE"

  food:
    name: "&6Nourriture"
    icon:
      material: GOLDEN_APPLE
      name: "&6Nourriture"
      lore:
        - "&7Nourriture et consommables"
    slot: 16
    rules:
      - type: material
        values:
          - APPLE
          - GOLDEN_APPLE
          - ENCHANTED_GOLDEN_APPLE
          - BREAD
          - COOKED_BEEF
          - COOKED_PORKCHOP
          - COOKED_CHICKEN
          - COOKED_SALMON
          - GOLDEN_CARROT
          - CAKE

  misc:
    name: "&7Divers"
    icon:
      material: CHEST
      name: "&7Divers"
      lore:
        - "&7Tout le reste"
    slot: 19
    # Pas de règles - attrape tout ce qui n'est pas dans d'autres catégories

Permissible de Catégorie

zAuctionHouse fournit un permissible zMenu personnalisé zauctionhouse_category qui permet d'afficher ou masquer des boutons selon la catégorie actuellement sélectionnée par le joueur. Utile pour afficher des boutons uniquement dans certaines catégories.

requirements:
  - type: zauctionhouse_category
    category: "weapons"

Le bouton ne sera visible que lorsque le joueur a sélectionné la catégorie weapons. Si aucune catégorie n'est sélectionnée, la valeur par défaut est main.

Priorité des Catégories

Quand un objet correspond à plusieurs catégories, il va dans la première catégorie correspondante. Ordonnez vos catégories de la plus spécifique à la moins spécifique :

categories:
  # Catégorie spécifique en premier
  legendary-weapons:
    name: "&6Armes Légendaires"
    rules:
      - type: material
        values: ["*_SWORD"]
      - type: name
        mode: CONTAINS
        value: "Légendaire"

  # Catégorie générale après
  weapons:
    name: "&cArmes"
    rules:
      - type: material
        values: ["*_SWORD"]