Skip to main content

Supported Plugins

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.

Copyright © 2026 GroupeZ|Build #loading...|-