GroupeZ Docs
Inventories

Catégories

Configuration de l'inventaire de sélection des catégories

L'inventaire des catégories permet aux joueurs de filtrer les objets de l'hôtel des ventes par catégorie.

Fichier : plugins/zAuctionHouse/inventories/categories.yml

Description

Aperçu

L'inventaire des catégories inclut :

  • Boutons de catégorie pour chaque catégorie définie
  • Catégorie "Tous les objets" (affiche tout)
  • Bouton retour vers les enchères

Configuration par Défaut

name: "#0c1719Categories"
size: 54

patterns:
  - 'zauctionhouse-decoration'
  - 'zauctionhouse-back'

items:

  all-items:
    type: ZAUCTIONHOUSE_CATEGORY
    category: all
    slot: 4
    item:
      material: CHEST
      name: "#2CCED2<bold>ᴀʟʟ ɪᴛᴇᴍs"
      lore:
        - "#92ffffView all auction listings"
        - ""
        - "#92ffffTotal items#8c8c8c: #2CCED2%zauctionhouse_category_count_all%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  blocks:
    type: ZAUCTIONHOUSE_CATEGORY
    category: blocks
    slot: 19
    item:
      material: GRASS_BLOCK
      name: "#7a7a7a<bold>ʙʟᴏᴄᴋs"
      lore:
        - "#92ffffAll building blocks"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_blocks%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  weapons:
    type: ZAUCTIONHOUSE_CATEGORY
    category: weapons
    slot: 20
    item:
      material: DIAMOND_SWORD
      name: "#ff5555<bold>ᴡᴇᴀᴘᴏɴs"
      lore:
        - "#92ffffCombat equipment"
        - "#92ffffSwords, bows, crossbows..."
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_weapons%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  armor:
    type: ZAUCTIONHOUSE_CATEGORY
    category: armor
    slot: 21
    item:
      material: DIAMOND_CHESTPLATE
      name: "#55ffff<bold>ᴀʀᴍᴏʀ"
      lore:
        - "#92ffffProtective equipment"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_armor%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  tools:
    type: ZAUCTIONHOUSE_CATEGORY
    category: tools
    slot: 22
    item:
      material: DIAMOND_PICKAXE
      name: "#ffff55<bold>ᴛᴏᴏʟs"
      lore:
        - "#92ffffMining and farming tools"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_tools%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  consumables:
    type: ZAUCTIONHOUSE_CATEGORY
    category: consumables
    slot: 23
    item:
      material: GOLDEN_APPLE
      name: "#55ff55<bold>ᴄᴏɴsᴜᴍᴀʙʟᴇs"
      lore:
        - "#92ffffFood and potions"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_consumables%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  resources:
    type: ZAUCTIONHOUSE_CATEGORY
    category: resources
    slot: 24
    item:
      material: DIAMOND
      name: "#ffaa00<bold>ʀᴇsᴏᴜʀᴄᴇs"
      lore:
        - "#92ffffOres and materials"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_resources%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  enchanted-books:
    type: ZAUCTIONHOUSE_CATEGORY
    category: enchanted-books
    slot: 25
    item:
      material: ENCHANTED_BOOK
      name: "#ff55ff<bold>ᴇɴᴄʜᴀɴᴛᴇᴅ ʙᴏᴏᴋs"
      lore:
        - "#92ffffBooks with enchantments"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_enchanted-books%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

  misc:
    type: ZAUCTIONHOUSE_CATEGORY
    category: misc
    slot: 31
    item:
      material: CHEST
      name: "#555555<bold>ᴍɪsᴄᴇʟʟᴀɴᴇᴏᴜs"
      lore:
        - "#92ffffOther items"
        - ""
        - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_misc%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto browse"

Boutons Utilisés

BoutonTypeDescription
all-itemsZAUCTIONHOUSE_CATEGORYAffiche tous les objets
blocksZAUCTIONHOUSE_CATEGORYFiltre par blocs
weaponsZAUCTIONHOUSE_CATEGORYFiltre par armes
armorZAUCTIONHOUSE_CATEGORYFiltre par armures
toolsZAUCTIONHOUSE_CATEGORYFiltre par outils
consumablesZAUCTIONHOUSE_CATEGORYFiltre par consommables
resourcesZAUCTIONHOUSE_CATEGORYFiltre par ressources
enchanted-booksZAUCTIONHOUSE_CATEGORYFiltre par livres enchantés
miscZAUCTIONHOUSE_CATEGORYFiltre par divers

Placeholders

PlaceholderDescription
%zauctionhouse_category_count_all%Nombre total d'objets en vente
%zauctionhouse_category_count_<name>%Nombre d'objets dans une catégorie spécifique

Permissible de Catégorie

zAuctionHouse fournit un permissible zMenu personnalisé zauctionhouse_category qui permet la visibilité conditionnelle des boutons en fonction de la catégorie actuellement sélectionnée par le joueur. Cela est utile pour afficher/masquer des boutons selon le filtre de catégorie actif.

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.

Ajouter des Catégories Personnalisées

Pour ajouter une nouvelle catégorie :

  1. Définissez la catégorie dans categories.yml (voir Configuration des Catégories)

  2. Ajoutez le bouton à cet inventaire :

my-custom-category:
  type: ZAUCTIONHOUSE_CATEGORY
  category: my-custom-category  # Must match categories.yml key
  slot: 32
  item:
    material: EMERALD
    name: "#00ff00<bold>ᴍʏ ᴄᴀᴛᴇɢᴏʀʏ"
    lore:
      - "#92ffffCustom category description"
      - ""
      - "#92ffffItems#8c8c8c: #2CCED2%zauctionhouse_category_count_my-custom-category%"
      - ""
      - "#8c8c8c• #2CCED2Click #92ffffto browse"

La valeur category doit correspondre exactement à la clé définie dans categories.yml.

Enchères

Configuration de l'inventaire principal de l'hôtel des ventes

Vente

Configuration de l'inventaire de vente pour mettre des objets en vente

Sur cette page

AperçuConfiguration par DéfautBoutons UtilisésPlaceholdersPermissible de CatégorieAjouter des Catégories Personnalisées
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.