GroupeZ Docs
Configuration

Upgrades

Configure drawer upgrades

Upgrades increase the storage capacity of drawers. Configure them in the upgrades section of config.yml.

Basic Structure

upgrades:
  woodUpgrade:                    # Upgrade name
    displayName: "Wood Upgrade"   # Human-readable name
    limit: 4096                   # New item limit
    displayItem:                  # Item shown on drawer
      material: IRON_BLOCK
    craft:                        # Crafting recipe
      enable: true
      result:
        # ...
      shade:
        # ...
      ingredients:
        # ...

Properties

PropertyTypeDescription
displayNameStringName shown in messages
limitLongNew storage limit per slot
displayItemItemStackItem displayed on drawer when upgrade is applied
craftObjectCrafting recipe configuration

Display Item

Configure the item shown on the drawer face when the upgrade is applied:

displayItem:
  material: IRON_BLOCK

You can use any zMenu item configuration:

displayItem:
  material: PLAYER_HEAD
  url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."

Craft Configuration

Each upgrade has its own crafting recipe:

craft:
  enable: true
  result:
    url: "eyJ0ZXh0dXJlcyI6..."   # Player head texture
    name: "#cc7727Wood Upgrade"
    lore:
      - "&7Increases drawer capacity"
      - "&7New limit: &e4096 items"
  shade:
    - "AAA"
    - "BCB"
    - "AAA"
  ingredients:
    A:
      material: STICK
    B:
      material: BARREL
    C:
      customCraft: upgradeDisplay   # Reference to custom craft

Using Custom Crafts

You can reference custom crafts as ingredients:

ingredients:
  C:
    customCraft: upgradeDisplay

This requires defining upgradeDisplay in customCrafts section.

Example Upgrades

Iron Upgrade

upgrades:
  ironUpgrade:
    displayName: "Iron Upgrade"
    limit: 8192
    displayItem:
      material: IRON_BLOCK
    craft:
      enable: true
      result:
        material: PLAYER_HEAD
        url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
        name: "&7Iron Upgrade"
        lore:
          - "&7Limit: &f8192"
      shade:
        - "AAA"
        - "BCB"
        - "AAA"
      ingredients:
        A:
          material: IRON_INGOT
        B:
          material: BARREL
        C:
          customCraft: upgradeDisplay

Diamond Upgrade

upgrades:
  diamondUpgrade:
    displayName: "Diamond Upgrade"
    limit: 32768
    displayItem:
      material: DIAMOND_BLOCK
    craft:
      enable: true
      result:
        material: PLAYER_HEAD
        url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
        name: "&bDiamond Upgrade"
        lore:
          - "&7Limit: &f32768"
      shade:
        - "AAA"
        - "BCB"
        - "ADA"
      ingredients:
        A:
          material: DIAMOND
        B:
          material: BARREL
        C:
          customCraft: upgradeDisplay
        D:
          material: DIAMOND_BLOCK

Netherite Upgrade

upgrades:
  netheriteUpgrade:
    displayName: "Netherite Upgrade"
    limit: 2147483647   # Max int value (unlimited)
    displayItem:
      material: NETHERITE_BLOCK
    craft:
      enable: true
      result:
        material: PLAYER_HEAD
        url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6..."
        name: "&8Netherite Upgrade"
        lore:
          - "&7Limit: &fUnlimited"
      shade:
        - "ADA"
        - "BCB"
        - "ADA"
      ingredients:
        A:
          material: NETHERITE_INGOT
        B:
          material: NETHERITE_BLOCK
        C:
          customCraft: upgradeDisplay
        D:
          material: ANCIENT_DEBRIS

Applying Upgrades

Players apply upgrades by:

  1. Crafting the upgrade item
  2. Right-clicking on a placed drawer with the upgrade in hand

Upgrades can only increase the limit. If a drawer already has a higher limit upgrade, applying a lower one will fail.

Giving Upgrades

Admins can give pre-upgraded drawers:

/zdrawer give drawer single Steve ironUpgrade

Or give the upgrade item directly:

/zdrawer give craft ironUpgrade Steve

Drawer Configuration

Configure drawer types and properties

Custom Crafts

Configure custom crafting recipes

On this page

Basic StructurePropertiesDisplay ItemCraft ConfigurationUsing Custom CraftsExample UpgradesIron UpgradeDiamond UpgradeNetherite UpgradeApplying UpgradesGiving Upgrades
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.