GroupeZ Docs
Configuration

Drawer Configuration

Configure drawer types and properties

Configure different drawer types in the drawer.drawers section of config.yml.

Basic Structure

drawer:
  drawers:
    single:                    # Drawer name (used in commands)
      type: SINGLE             # Drawer type
      limit: 2048              # Maximum items per slot
      enableHopper: true       # Allow hopper interaction
      viewRange: 0.5           # Display visibility range
      enableTextBackground: false

      dropContent:
        enable: false
        limit: 1024

      item:                    # Drawer item configuration
        material: BARREL
        name: "#22f54cDrawer"
        lore:
          - "&8Store items here"

      border:                  # Visual border
        enable: true
        item:
          material: SPRUCE_WOOD

      craft:                   # Crafting recipe
        enable: true
        # ...

Drawer Types

TypeSlotsDescription
SINGLE1One item type
DUO2Two item types
TRIO3Three item types
QUAD4Four item types

Properties

Basic Properties

PropertyTypeDescription
typeDrawerTypeSINGLE, DUO, TRIO, or QUAD
limitIntegerMaximum items per slot
enableHopperBooleanAllow hopper item transfer
viewRangeFloatDisplay entity visibility range
enableTextBackgroundBooleanShow background behind amount text

Drop Content

Configure behavior when drawer is broken:

dropContent:
  enable: false    # Drop items when broken
  limit: 1024      # Max items before preventing break

If enable is false, items stay inside the dropped drawer item. If enable is true and items exceed limit, the drawer cannot be broken.

Item Configuration

Configure the drawer item using zMenu item format:

item:
  material: BARREL
  name: "#22f54cDrawer"
  lore:
    - "&8&oStore a large number of items"
    - ""
    - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_0% %zdrawer_content_0%"
    - "#e3e3e3Upgrade&8: #baffff%zdrawer_upgrade%"

Available Placeholders

PlaceholderDescription
%zdrawer_content_<index>%Item name in slot
%zdrawer_amount_<index>%Amount in slot
%zdrawer_amount_formatted_<index>%Formatted amount
%zdrawer_upgrade%Applied upgrade name

Border Configuration

Display decorative borders around the drawer face:

border:
  enable: true
  scale:
    up: { x: 1.0, y: 0.05, z: 0.05 }
    down: { x: 1.0, y: 0.05, z: 0.05 }
    left: { x: 0.05, y: 0.9, z: 0.05 }
    right: { x: 0.05, y: 0.9, z: 0.05 }
  item:
    material: SPRUCE_WOOD

Craft Configuration

Define crafting recipe for the drawer:

craft:
  enable: true
  shade:
    - "ABA"
    - "BCB"
    - "ABA"
  ingredients:
    A:
      material: SPRUCE_WOOD
    B:
      material: SPRUCE_PLANKS
    C:
      material: CHEST

See Crafts Configuration for more details.

Complete Examples

Single Drawer

drawer:
  drawers:
    single:
      type: SINGLE
      limit: 2048
      enableHopper: true
      viewRange: 0.5
      enableTextBackground: false

      dropContent:
        enable: false
        limit: 1024

      item:
        material: BARREL
        name: "#22f54cDrawer"
        lore:
          - "&8&oStore a large number of the same item"
          - ""
          - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_0% %zdrawer_content_0%"
          - "#e3e3e3Upgrade&8: #baffff%zdrawer_upgrade%"

      border:
        enable: true
        scale:
          up: { x: 1.0, y: 0.05, z: 0.05 }
          down: { x: 1.0, y: 0.05, z: 0.05 }
          left: { x: 0.05, y: 0.9, z: 0.05 }
          right: { x: 0.05, y: 0.9, z: 0.05 }
        item:
          material: SPRUCE_WOOD

      craft:
        enable: true
        shade:
          - "ABA"
          - "BCB"
          - "ABA"
        ingredients:
          A:
            material: SPRUCE_WOOD
          B:
            material: SPRUCE_PLANKS
          C:
            material: CHEST

Quad Drawer

drawer:
  drawers:
    quad:
      type: QUAD
      limit: 512
      enableHopper: true
      viewRange: 0.5
      enableTextBackground: false

      dropContent:
        enable: false
        limit: 1024

      item:
        material: BARREL
        name: "#22f54cDrawer Quad"
        lore:
          - "&8&oStore multiple item types"
          - ""
          - "&8First slot:"
          - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_0% %zdrawer_content_0%"
          - "&8Second slot:"
          - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_1% %zdrawer_content_1%"
          - "&8Third slot:"
          - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_2% %zdrawer_content_2%"
          - "&8Fourth slot:"
          - "#e3e3e3Content&8: #baffffx%zdrawer_amount_formatted_3% %zdrawer_content_3%"
          - ""
          - "#e3e3e3Upgrade&8: #baffff%zdrawer_upgrade%"

      border:
        enable: true
        item:
          material: BIRCH_WOOD

      craft:
        enable: true
        shade:
          - "ABA"
          - "BCB"
          - "ABA"
        ingredients:
          A:
            material: SPRUCE_WOOD
          B:
            material: SPRUCE_PLANKS
          C:
            material: ENDER_CHEST

Size Configuration

Configure display positions for each drawer type and block face:

drawer:
  sizes:
    SINGLE:
      SOUTH:
        scale: { x: 1, y: 1, z: 1.0 }
        positions:
          1:
            item: { x: 0, y: 0.0, z: 0.0 }
            text: { x: 0, y: 0.0, z: 0.0 }

    DUO:
      SOUTH:
        scale: { x: 0.8, y: 0.8, z: 1.0 }
        positions:
          1:
            item: { x: 0.25, y: 0.0, z: 0.0 }
            text: { x: 0.25, y: 0.1, z: 0.0 }
          2:
            item: { x: -0.25, y: 0.0, z: 0.0 }
            text: { x: -0.25, y: 0.1, z: 0.0 }

Modifying size positions requires careful adjustment. Small changes can break the visual display. Only modify if you understand the coordinate system.

Main Configuration

zDrawer config.yml settings

Upgrades

Configure drawer upgrades

On this page

Basic StructureDrawer TypesPropertiesBasic PropertiesDrop ContentItem ConfigurationAvailable PlaceholdersBorder ConfigurationCraft ConfigurationComplete ExamplesSingle DrawerQuad DrawerSize Configuration
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.