GroupeZ Docs
Configuration

Shop Items

Configure shop items with ZSHOP_ITEM button type

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

Shop items are configured using the ZSHOP_ITEM button type in zMenu inventory files.

Basic Structure

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

ZSHOP_ITEM Parameters

ParameterTypeRequiredDefaultDescription
buyPriceDoubleNo0.0Price to buy the item
sellPriceDoubleNo0.0Price to sell the item
economyStringNoDefaultEconomy to use
maxStackIntegerNo64Maximum stack size
loreListNoDefaultCustom lore lines
giveItemBooleanNotrueGive item on purchase
buyCommandsListNo-Commands on purchase
sellCommandsListNo-Commands on sale
enableLogBooleanNotrueLog transactions
affectByPriceModifierBooleanNotrueApply price modifiers
unstackableBooleanNofalsePrevent stacking
mobStringNo-Mob type for spawners
inventoryBuyStringNo-Custom buy inventory
inventorySellStringNo-Custom sell inventory

Examples

Basic Shop Item

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

Item with Custom Amount

items:
  coal_stack:
    type: ZSHOP_ITEM
    slot: 11
    item:
      material: COAL
      amount: 16  # Sell/buy 16 at a time
    buyPrice: 32.0
    sellPrice: 8.0

Buy-Only Item

items:
  enchanted_book:
    type: ZSHOP_ITEM
    slot: 12
    item:
      material: ENCHANTED_BOOK
      name: "&d&lSharpness V"
      enchantments:
        - SHARPNESS,5
    buyPrice: 5000.0
    # No sellPrice = cannot sell

Sell-Only Item

items:
  rotten_flesh:
    type: ZSHOP_ITEM
    slot: 13
    item:
      material: ROTTEN_FLESH
    sellPrice: 1.0
    # No buyPrice = cannot buy

Different Economy

items:
  special_item:
    type: ZSHOP_ITEM
    slot: 14
    item:
      material: NETHER_STAR
      name: "&6&lSpecial Item"
    buyPrice: 5.0
    sellPrice: 2.0
    economy: item_diamond  # Uses diamonds as currency

Custom Lore

items:
  custom_lore_item:
    type: ZSHOP_ITEM
    slot: 15
    item:
      material: GOLDEN_APPLE
    buyPrice: 500.0
    sellPrice: 100.0
    lore:
      - ""
      - "&7A rare golden apple!"
      - ""
      - "&eBuy: &a%buyPrice%"
      - "&eSell: &c%sellPrice%"
      - ""
      - "&7Stock: &fUnlimited"

Command Item (No Physical Item)

items:
  fly_permission:
    type: ZSHOP_ITEM
    slot: 16
    item:
      material: FEATHER
      name: "&b&l1 Hour of Flight"
      lore:
        - ""
        - "&7Purchase temporary flight!"
    buyPrice: 1000.0
    giveItem: false  # Don't give the feather
    buyCommands:
      - "lp user %player% permission settemp fly.use true 1h"
      - "msg %player% &aYou now have flight for 1 hour!"

Spawner with Mob Type

items:
  zombie_spawner:
    type: ZSHOP_ITEM
    slot: 17
    item:
      material: SPAWNER
      name: "&c&lZombie Spawner"
    buyPrice: 50000.0
    sellPrice: 10000.0
    mob: ZOMBIE

Unstackable Item

items:
  unique_tool:
    type: ZSHOP_ITEM
    slot: 18
    item:
      material: DIAMOND_PICKAXE
      name: "&a&lUnique Pickaxe"
      enchantments:
        - EFFICIENCY,10
    buyPrice: 10000.0
    unstackable: true  # Each purchase is separate

Item with Limits

items:
  limited_item:
    type: ZSHOP_ITEM
    slot: 19
    item:
      material: BEACON
    buyPrice: 100000.0
    sellPrice: 25000.0

    # Server-wide buy limit (resets weekly)
    serverBuyLimit:
      limit: 10
      schedulerType: WEEKLY
      day: MONDAY
      hour: 0
      minute: 0

    # Per-player sell limit (resets daily)
    playerSellLimit:
      limit: 5
      schedulerType: DAILY
      hour: 0
      minute: 0

See Limits for detailed limit configuration.

Ignore Price Modifiers

items:
  fixed_price_item:
    type: ZSHOP_ITEM
    slot: 20
    item:
      material: BEDROCK
    buyPrice: 1000000.0
    affectByPriceModifier: false  # VIP discounts don't apply

Custom Transaction Reasons

items:
  special_purchase:
    type: ZSHOP_ITEM
    slot: 21
    item:
      material: DIAMOND_BLOCK
    buyPrice: 900.0
    sellPrice: 800.0
    deposit-reason: "Sold diamond block at shop"
    withdraw-reason: "Purchased diamond block from shop"

Complete Category Example

# inventories/categories/ores.yml

name: "&7Ores Shop"
size: 54

patterns:
  - "zshop_decoration"
  - "zshop_return_home"

items:
  coal:
    type: ZSHOP_ITEM
    slot: 10
    item:
      material: COAL
      amount: 16
    buyPrice: 32.0
    sellPrice: 8.0

  iron_ingot:
    type: ZSHOP_ITEM
    slot: 11
    item:
      material: IRON_INGOT
    buyPrice: 15.0
    sellPrice: 5.0

  gold_ingot:
    type: ZSHOP_ITEM
    slot: 12
    item:
      material: GOLD_INGOT
    buyPrice: 50.0
    sellPrice: 25.0

  diamond:
    type: ZSHOP_ITEM
    slot: 13
    item:
      material: DIAMOND
    buyPrice: 500.0
    sellPrice: 250.0

  emerald:
    type: ZSHOP_ITEM
    slot: 14
    item:
      material: EMERALD
    buyPrice: 200.0
    sellPrice: 100.0

  lapis_lazuli:
    type: ZSHOP_ITEM
    slot: 15
    item:
      material: LAPIS_LAZULI
    buyPrice: 10.0
    sellPrice: 2.0

  redstone:
    type: ZSHOP_ITEM
    slot: 16
    item:
      material: REDSTONE
    buyPrice: 5.0
    sellPrice: 1.0

  netherite_ingot:
    type: ZSHOP_ITEM
    slot: 22
    item:
      material: NETHERITE_INGOT
    buyPrice: 10000.0
    sellPrice: 5000.0
    serverBuyLimit:
      limit: 5
      schedulerType: DAILY
      hour: 0
      minute: 0

Lore Placeholders

Available placeholders in item lore:

PlaceholderDescription
%buyPrice%Formatted buy price
%sellPrice%Formatted sell price
%maxStack%Maximum stack size
%economy%Economy name
%player%Player name

Plus all PlaceholderAPI placeholders.

Item Configuration

The item section follows zMenu item format:

item:
  material: DIAMOND_SWORD
  name: "&6&lLegendary Sword"
  lore:
    - "&7A powerful weapon"
  amount: 1
  model-id: 1001
  glow: true
  enchantments:
    - SHARPNESS,5
  flags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES

Economies

Configure economy systems in zShop

Limits

Configure purchase and sale limits in zShop

Sur cette page

Basic StructureZSHOP_ITEM ParametersExamplesBasic Shop ItemItem with Custom AmountBuy-Only ItemSell-Only ItemDifferent EconomyCustom LoreCommand Item (No Physical Item)Spawner with Mob TypeUnstackable ItemItem with LimitsIgnore Price ModifiersCustom Transaction ReasonsComplete Category ExampleLore PlaceholdersItem Configuration
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.