GroupeZ Docs

Placeholders

Available placeholders in zDrawer

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

zDrawer provides placeholders for use in drawer item lore and with PlaceholderAPI.

Internal Placeholders

These placeholders work in drawer item configuration (lore):

PlaceholderDescription
%zdrawer_content_<index>%Item name stored in slot
%zdrawer_amount_<index>%Raw amount in slot
%zdrawer_amount_formatted_<index>%Formatted amount (e.g., 1.5K)
%zdrawer_upgrade%Applied upgrade name

Index Values

The <index> is 0-based:

IndexSlot
0First slot
1Second slot
2Third slot
3Fourth slot

Usage in Drawer Lore

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

Multi-Slot Drawer Lore

# For a QUAD drawer
item:
  lore:
    - "&8First slot:"
    - "  #e3e3e3x%zdrawer_amount_formatted_0% %zdrawer_content_0%"
    - "&8Second slot:"
    - "  #e3e3e3x%zdrawer_amount_formatted_1% %zdrawer_content_1%"
    - "&8Third slot:"
    - "  #e3e3e3x%zdrawer_amount_formatted_2% %zdrawer_content_2%"
    - "&8Fourth slot:"
    - "  #e3e3e3x%zdrawer_amount_formatted_3% %zdrawer_content_3%"

PlaceholderAPI Integration

When PlaceholderAPI is installed, these placeholders are available for the drawer the player is currently interacting with:

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

Usage Examples

In a scoreboard plugin:

lines:
  - "&6Drawer Contents"
  - "&7Slot 1: %zdrawer_content_0%"
  - "&7Amount: %zdrawer_amount_formatted_0%"

In a hologram:

lines:
  - "&eDrawer Info"
  - "&7%zdrawer_content_0%"
  - "&7x%zdrawer_amount_formatted_0%"

Default Values

When a drawer slot is empty or no upgrade is applied:

PlaceholderDefault Value
%zdrawer_content_<index>%Empty
%zdrawer_amount_<index>%0
%zdrawer_upgrade%X (or custom icon)

Configure the empty upgrade display in messages:

# In messages
EMPTY_DRAWER: "Empty"
EMPTY_UPGRADE: "#e32f1b✘"

Number Formatting

The %zdrawer_amount_formatted_<index>% placeholder uses the number format configuration:

numberFormat:
  enable: true
  formats:
    - format: ""
      maxAmount: 1000
    - format: "%.1fK"
      maxAmount: 1000000
    - format: "%.1fM"
      maxAmount: 1000000000
AmountFormatted
500500
15001.5K
25000002.5M
12345678901.2B

Testing Placeholders

Test PlaceholderAPI placeholders:

/papi parse me %zdrawer_content_0%
/papi parse me %zdrawer_amount_formatted_0%

PlaceholderAPI placeholders only work when a player has recently interacted with a drawer.

Custom Crafts

Configure custom crafting recipes

Sur cette page

Internal PlaceholdersIndex ValuesUsage in Drawer LoreMulti-Slot Drawer LorePlaceholderAPI IntegrationUsage ExamplesDefault ValuesNumber FormattingTesting Placeholders
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.