GroupeZ Docs

Drawer Configuration

Configure drawer types and properties

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

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.

Sur cette page

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.