GroupeZ Docs

Placeholders

Available placeholders in zDrawer

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

On this page

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