GroupeZ Docs
Configuration

Button Types

All zShop button types for inventory configuration

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

zShop adds several custom button types to zMenu for shop functionality.

ZSHOP_ITEM

The main shop item button for buying and selling items.

items:
  diamond:
    type: ZSHOP_ITEM
    slot: 10
    item:
      material: DIAMOND
    buyPrice: 100.0
    sellPrice: 50.0

Click Actions:

  • Left-click: Open buy menu
  • Right-click: Open sell menu
  • Middle-click / Drop key: Sell all of this item

See Shop Items for full documentation.

ZSHOP_SHOW

Displays the currently selected item in buy/sell menus.

items:
  show_item:
    type: ZSHOP_SHOW
    slot: 22
    item:
      material: BARRIER
      name: "&cError"
      lore:
        - "&cItem not found"
    lore:
      - ""
      - "&7Buying price: &e%buyPrice%"

The item section is a fallback shown only if there's an error.

ZSHOP_SHOW_CONFIRM

Displays the item in confirmation dialogs.

items:
  confirm_item:
    type: ZSHOP_SHOW_CONFIRM
    slot: 22
    item:
      material: BARRIER
      name: "&cError"

ZSHOP_CONFIRM_BUY

Confirms a purchase in the confirmation menu.

items:
  confirm_buy:
    type: ZSHOP_CONFIRM_BUY
    slot: 50
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&aConfirm Purchase"
      lore:
        - ""
        - "&7Click to confirm your purchase"

ZSHOP_CONFIRM_SELL

Confirms a sale in the confirmation menu.

items:
  confirm_sell:
    type: ZSHOP_CONFIRM_SELL
    slot: 50
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&aConfirm Sale"
      lore:
        - ""
        - "&7Click to confirm your sale"

ZSHOP_ADD

Adds items to the purchase/sale amount.

items:
  add_1:
    type: ZSHOP_ADD
    slot: 28
    amount: 1
    item:
      material: GREEN_STAINED_GLASS_PANE
      name: "&a+1"

  add_10:
    type: ZSHOP_ADD
    slot: 29
    amount: 10
    item:
      material: GREEN_STAINED_GLASS_PANE
      name: "&a+10"

  add_64:
    type: ZSHOP_ADD
    slot: 30
    amount: 64
    item:
      material: GREEN_STAINED_GLASS_PANE
      name: "&a+64"

Parameters:

  • amount: Number of items to add

ZSHOP_REMOVE

Removes items from the purchase/sale amount.

items:
  remove_1:
    type: ZSHOP_REMOVE
    slot: 34
    amount: 1
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-1"

  remove_10:
    type: ZSHOP_REMOVE
    slot: 33
    amount: 10
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-10"

  remove_64:
    type: ZSHOP_REMOVE
    slot: 32
    amount: 64
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-64"

Parameters:

  • amount: Number of items to remove

ZSHOP_BUY_MORE

Quick buy buttons for purchasing specific amounts.

items:
  buy_1:
    type: ZSHOP_BUY_MORE
    slot: 10
    amount: 1
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&aBuy x1"
      lore:
        - ""
        - "&7Price: &e%buyPrice%"

  buy_16:
    type: ZSHOP_BUY_MORE
    slot: 11
    amount: 16
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&aBuy x16"
      lore:
        - ""
        - "&7Price: &e%buyPrice%"

  buy_64:
    type: ZSHOP_BUY_MORE
    slot: 12
    amount: 64
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&aBuy x64"
      lore:
        - ""
        - "&7Price: &e%buyPrice%"

Parameters:

  • amount: Number of items to purchase

Standard zMenu Buttons

You can also use all standard zMenu button types:

TypeDescription
NONEStatic display item
INVENTORYOpen another inventory
BACKReturn to previous menu
HOMEReturn to main menu
NEXTNext page
PREVIOUSPrevious page

See zMenu Button Documentation.

Complete Buy Menu Example

# inventories/shop_buy.yml

name: "&7Purchase"
size: 54

patterns:
  - "zshop_decoration"
  - "zshop_back"

items:
  # Display item
  show_item:
    type: ZSHOP_SHOW
    slot: 22
    item:
      material: BARRIER
      name: "&cError"
    lore:
      - ""
      - "&7Price: &e%buyPrice%"

  # Add buttons
  add_1:
    type: ZSHOP_ADD
    slot: 28
    amount: 1
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&a+1"

  add_10:
    type: ZSHOP_ADD
    slot: 29
    amount: 10
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&a+10"

  add_64:
    type: ZSHOP_ADD
    slot: 30
    amount: 64
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&a+64"

  # Remove buttons
  remove_1:
    type: ZSHOP_REMOVE
    slot: 34
    amount: 1
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-1"

  remove_10:
    type: ZSHOP_REMOVE
    slot: 33
    amount: 10
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-10"

  remove_64:
    type: ZSHOP_REMOVE
    slot: 32
    amount: 64
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-64"

  # Confirm button
  confirm:
    type: ZSHOP_CONFIRM_BUY
    slot: 49
    item:
      material: EMERALD_BLOCK
      name: "&a&lConfirm Purchase"
      lore:
        - ""
        - "&7Click to buy!"

  # Buy more options
  buy_more:
    type: INVENTORY
    inventory: "buy_more"
    plugin: "zShop"
    slot: 50
    item:
      material: CHEST
      name: "&eBuy More Options"

Complete Sell Menu Example

# inventories/shop_sell.yml

name: "&7Sell"
size: 54

patterns:
  - "zshop_decoration"
  - "zshop_back"

items:
  show_item:
    type: ZSHOP_SHOW
    slot: 22
    item:
      material: BARRIER
      name: "&cError"
    lore:
      - ""
      - "&7Sell Price: &e%sellPrice%"

  add_1:
    type: ZSHOP_ADD
    slot: 28
    amount: 1
    item:
      material: LIME_STAINED_GLASS_PANE
      name: "&a+1"

  add_all:
    type: ZSHOP_ADD
    slot: 31
    amount: 9999  # Adds all available
    item:
      material: HOPPER
      name: "&aSell All"

  remove_1:
    type: ZSHOP_REMOVE
    slot: 34
    amount: 1
    item:
      material: RED_STAINED_GLASS_PANE
      name: "&c-1"

  confirm:
    type: ZSHOP_CONFIRM_SELL
    slot: 49
    item:
      material: GOLD_BLOCK
      name: "&6&lConfirm Sale"
      lore:
        - ""
        - "&7Click to sell!"

Confirmation Menu Example

# inventories/confirm.yml

name: "&7Confirm Purchase"
size: 54

patterns:
  - "zshop_decoration"
  - "zshop_back"

items:
  show_item:
    type: ZSHOP_SHOW_CONFIRM
    slot: 22
    item:
      material: BARRIER
      name: "&cError"

  confirm:
    type: ZSHOP_CONFIRM_BUY
    slot: 50
    item:
      material: LIME_CONCRETE
      name: "&a&lConfirm"
      lore:
        - ""
        - "&7Click to complete purchase"

  cancel:
    type: BACK
    slot: 48
    item:
      material: RED_CONCRETE
      name: "&c&lCancel"
      lore:
        - ""
        - "&7Click to go back"

Limits

Configure purchase and sale limits in zShop

Price Modifiers

Suivant

Sur cette page

ZSHOP_ITEMZSHOP_SHOWZSHOP_SHOW_CONFIRMZSHOP_CONFIRM_BUYZSHOP_CONFIRM_SELLZSHOP_ADDZSHOP_REMOVEZSHOP_BUY_MOREStandard zMenu ButtonsComplete Buy Menu ExampleComplete Sell Menu ExampleConfirmation Menu Example
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.