GroupeZ Docs

Supported Plugins

List of all plugins officially supported by zMenu

zMenu integrates with many popular Minecraft plugins to extend its functionality. This page lists all officially supported plugins and what features they enable.

Placeholder Plugins

PlaceholderAPI

Download: SpigotMC

PlaceholderAPI is highly recommended for zMenu. It allows you to display dynamic values in your inventories, such as player statistics, economy balances, and much more.

Features enabled:

  • Use %placeholder% syntax in item names, lore, and messages
  • Thousands of available expansions
  • Cached placeholder parsing for performance

Example:

item:
  material: DIAMOND
  name: "&6%player_name%'s Menu"
  lore:
    - "&7Balance: &a$%vault_eco_balance%"
    - "&7Playtime: &e%statistic_hours_played%h"

Economy Plugins

Vault

Download: SpigotMC

Vault provides a unified economy API that zMenu uses for currency-based actions.

Features enabled:

  • deposit action
  • withdraw action
  • Economy placeholders

ExcellentEconomy

Download: SpigotMC

ExcellentEconomy provides a multi-currency economy system with custom currencies support.

Features enabled:

  • deposit action
  • withdraw action
  • Multi-currency support via economy parameter

Permission Plugins

LuckPerms

Download: https://luckperms.net/

LuckPerms integration allows for advanced permission-based features.

Features enabled:

  • luckperm requirement type
  • luckperm-set action to modify player groups
  • Group-based view requirements

Example:

click-requirement:
  vip-check:
    clicks:
      - ALL
    requirements:
      - type: luckperm
        group: vip
        deny:
          - type: message
            messages:
             - "&cYou need VIP rank to use this!"

Custom Item Plugins

ItemsAdder

Download: SpigotMC

ItemsAdder allows you to use custom items with textures in your menus.

Usage:

item:
  material: ITEMSADDER:namespace:item_id

Oraxen

Download: SpigotMC

Oraxen support for custom items and models.

Usage:

item:
  material: ORAXEN:item_id

HeadDatabase

Download: SpigotMC

HeadDatabase provides thousands of custom player head textures.

Usage:

item:
  material: hdb:12345

Correct prefix

The material prefix is hdb: (case-insensitive). The previously documented HEAD_DATABASE: prefix is incorrect and will not resolve.

Slimefun

Download: GitHub

Use Slimefun items in your menus.

Usage:

item:
  material: SLIMEFUN:ITEM_ID

MythicMobs

Download: SpigotMC

MythicMobs integration for custom items.

Usage:

item:
  material: mythicmobs:item_id

MMOItems

MMOItems integration for RPG items.

Usage:

item:
  material: mmoitems:<type>:<item_id>

Nexo

Nexo integration for custom items (successor to Oraxen).

Usage:

item:
  material: nexo:<item_name>

CraftEngine

CraftEngine integration for custom items.

Usage:

item:
  material: craftengine:<item_id>

Nova

Nova integration for custom items.

Usage:

item:
  material: nova:<item_or_block_name>

NextGens

NextGens generator integration.

Usage:

item:
  material: nextgens_generators:<generator_id>

zItems

Download: SpigotMC

zItems integration by the same developer as zMenu.

Usage:

item:
  material: zitems:<item_id>

ExecutableItems

Download: SpigotMC

ExecutableItems support for special items.

Usage:

item:
  material: ei:item_id

Correct prefix

The material prefix is ei: (case-insensitive). The previously documented EXECUTABLE_ITEM: prefix is incorrect and will not resolve.

ExecutableBlocks

Download: SpigotMC

ExecutableBlocks support for special blocks as items.

Usage:

item:
  material: eb:block_id

BreweryX

Download: SpigotMC

BreweryX integration for brewing system items.

Usage:

item:
  material: BREWERYX:recipe_name

Denizen

Download: SpigotMC

Denizen integration is available through the item rules system. You can match Denizen items by their script name using the denizen rule type (for example with the item_drag button).

Usage:

rule:
  type: denizen
  items:
    - "my_denizen_item"

Head Plugins

zHead

Download: SpigotMC

Another head texture plugin by the same developer.

Usage:

item:
  material: zhd:category:head_name

Correct prefix

The material prefix is zhd: (case-insensitive). The previously documented ZHEAD: prefix is incorrect and will not resolve.

HMCCosmetics

Download: SpigotMC

HMCCosmetics integration for cosmetic items.

Usage:

item:
  material: hmc_cosmetics:<type>
  # or for a specific player's cosmetic:
  material: hmc_cosmetics:<type>-<player>

MagicCosmetics

MagicCosmetics integration for cosmetic items.

Usage:

item:
  material: magic_cosmetics:<cosmetic_id>

Job Plugins

Jobs Reborn

Download: SpigotMC

Jobs Reborn integration for job-based requirements.

Features enabled:

  • job requirement type to check job levels

Example:

click-requirement:
  job-check:
    clicks:
      - ALL
    requirements:
      - type: job
        job: Miner
        level: 10

Shopkeeper Plugins

Shopkeepers

Integration with Shopkeepers plugin.

Features enabled:

  • shopkeeper action type

Bedrock Compatibility

Geyser / Floodgate

Download: GeyserMC

Geyser and Floodgate allow Bedrock Edition players to join Java Edition servers. When detected, zMenu enables the Bedrock Forms system, which provides native Bedrock UI forms instead of chest-based inventories.

Features enabled:

  • Native Bedrock forms (Simple, Modal, Custom)
  • bedrock action type to open forms
  • Automatic inventory replacement for Bedrock players
  • /zm bedrock commands
  • zmenu.open.bedrock and zmenu.reload.bedrock permissions

Example:

# In a button action
actions:
  - type: bedrock
    bedrock: "feedback-form"

See Bedrock Forms for complete documentation.

Packet Plugins

PacketEvents

Download: SpigotMC

PacketEvents is required for the Dialog system (Minecraft 1.20.5+).

Features enabled:

  • Dialog system support
  • Advanced UI features

Built-in Material Loaders

These loaders are built into zMenu and do not require any external plugin.

armor

Returns the item the player currently has equipped in the specified armor slot.

item:
  material: armor:HEAD       # Helmet
  # material: armor:CHEST    # Chestplate
  # material: armor:LEGS     # Leggings
  # material: armor:FEET     # Boots

base64

Deserialises a Base64-encoded ItemStack (Bukkit serialisation format).

item:
  material: base64:<base64_encoded_itemstack>

Supported Plugin Summary Table

PluginCategoryMaterial PrefixFeature
PlaceholderAPIPlaceholders-Dynamic values
VaultEconomy-Currency actions
ExcellentEconomyEconomy-Multi-currency actions
LuckPermsPermissions-Group requirements
ItemsAdderCustom Itemsitemsadder:Custom items/textures
OraxenCustom Itemsoraxen:Custom items/models
NexoCustom Itemsnexo:Custom items/models
CraftEngineCustom Itemscraftengine:Custom items
HeadDatabaseHeadshdb:Custom heads
SlimefunCustom Itemsslimefun:Slimefun items
MythicMobsCustom Itemsmythicmobs:MythicMobs items
MMOItemsCustom Itemsmmoitems:RPG items
ExecutableItemsCustom Itemsei:EI items
ExecutableBlocksCustom Itemseb:EB items
BreweryXCustom Itemsbreweryx:Brewing items
DenizenItem Rules-denizen item rule
zHeadHeadszhd:Custom heads
zItemsCustom Itemszitems:Custom items
NovaCustom Itemsnova:Nova items
NextGensCustom Itemsnextgens_generators:Generator items
HMCCosmeticsCosmeticshmc_cosmetics:Cosmetic items
MagicCosmeticsCosmeticsmagic_cosmetics:Cosmetic items
Jobs RebornJobs-Job requirements
Geyser/FloodgateBedrock-Native Bedrock forms
PacketEventsPackets-Dialog system / click limiter
(built-in)Materialarmor:Player's equipped item
(built-in)Materialbase64:Base64-encoded ItemStack

Using Custom Materials

When using custom item plugins, the material format typically follows this pattern:

item:
  material: PLUGIN_PREFIX:item_identifier

Examples:

# ItemsAdder
item:
  material: itemsadder:my_namespace:ruby

# Oraxen / Nexo
item:
  material: oraxen:emerald_sword
  # material: nexo:emerald_sword

# HeadDatabase
item:
  material: hdb:1234

# Slimefun
item:
  material: slimefun:ELECTRIC_MOTOR

# MythicMobs
item:
  material: mythicmobs:SkeletonKingSword

# MMOItems
item:
  material: mmoitems:SWORD:LEGENDARY_BLADE

# ExecutableItems / ExecutableBlocks
item:
  material: ei:my_custom_item
  # material: eb:my_custom_block

# zItems
item:
  material: zitems:my_item_id

# Player's equipped item (built-in)
item:
  material: armor:HEAD

Plugin Detection

zMenu automatically detects installed plugins and enables their features. You don't need to configure anything - just install the plugins and restart your server.

To verify which plugins zMenu detected, check the console output when the server starts or use the /zm version command.

Hot Reload

Edit your inventories and see the result instantly in game, without any command

zMenu+

The premium addon for zMenu with advanced features

On this page

Placeholder PluginsPlaceholderAPIEconomy PluginsVaultExcellentEconomyPermission PluginsLuckPermsCustom Item PluginsItemsAdderOraxenHeadDatabaseSlimefunMythicMobsMMOItemsNexoCraftEngineNovaNextGenszItemsExecutableItemsExecutableBlocksBreweryXDenizenHead PluginszHeadHMCCosmeticsMagicCosmeticsJob PluginsJobs RebornShopkeeper PluginsShopkeepersBedrock CompatibilityGeyser / FloodgatePacket PluginsPacketEventsBuilt-in Material Loadersarmorbase64Supported Plugin Summary TableUsing Custom MaterialsExamples:Plugin Detection
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.