GroupeZ Docs
Configuration

Button Types

All zShop button types for inventory configuration

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

Next Page

On this 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

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

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

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.