GroupeZ Docs
ConfigurationsButtonsButton Types

INVENTORY Button

Button that opens another inventory

The INVENTORY button type opens another inventory when clicked.

Usage

items:
  open-shop:
    type: INVENTORY
    slot: 13
    inventory: "shop"
    item:
      material: GOLD_INGOT
      name: "&e&lShop"
      lore:
        - "&7Click to open the shop"

Properties

inventory

Required. The name of the inventory to open.

items:
  open-menu:
    type: INVENTORY
    slot: 0
    inventory: "my_other_menu"

The inventory name corresponds to the file name (without .yml) in the inventories/ folder.

plugin

Specify which plugin's inventory to open (for cross-plugin support).

items:
  open-external:
    type: INVENTORY
    slot: 0
    inventory: "external_menu"
    plugin: "OtherPlugin"

arguments

Pass arguments to the target inventory.

items:
  open_with_args:
    type: INVENTORY
    slot: 0
    inventory: "category_menu"
    arguments:
      - "swords"
      - "%player%"

to-page

Open the inventory at a specific page.

items:
  open_page_3:
    type: INVENTORY
    slot: 0
    inventory: "paginated_menu"
    to-page: 3

Examples

Basic Menu Navigation

items:
  shop:
    type: INVENTORY
    slot: 11
    inventory: "shop"
    item:
      material: GOLD_INGOT
      name: "&e&lShop"
      lore:
        - "&7Buy and sell items"
        - ""
        - "&e▸ Click to open"

  warps:
    type: INVENTORY
    slot: 13
    inventory: "warps"
    item:
      material: ENDER_PEARL
      name: "&5&lWarps"
      lore:
        - "&7Teleport around the world"
        - ""
        - "&e▸ Click to open"

  settings:
    type: INVENTORY
    slot: 15
    inventory: "settings"
    item:
      material: COMPARATOR
      name: "&c&lSettings"
      lore:
        - "&7Configure your preferences"
        - ""
        - "&e▸ Click to open"

Category Selection

# Main menu
items:
  swords:
    type: INVENTORY
    slot: 10
    inventory: "shop_swords"
    item:
      material: DIAMOND_SWORD
      name: "&b&lSwords"

  armor:
    type: INVENTORY
    slot: 12
    inventory: "shop_armor"
    item:
      material: DIAMOND_CHESTPLATE
      name: "&9&lArmor"

  tools:
    type: INVENTORY
    slot: 14
    inventory: "shop_tools"
    item:
      material: DIAMOND_PICKAXE
      name: "&a&lTools"

  food:
    type: INVENTORY
    slot: 16
    inventory: "shop_food"
    item:
      material: GOLDEN_APPLE
      name: "&6&lFood"

With Requirements

items:
  vip-shop:
    type: INVENTORY
    slot: 22
    inventory: "vip_shop"
    item:
      material: DIAMOND_BLOCK
      name: "&b&lVIP Shop"
      lore:
        - "&7Exclusive VIP items"
    view-requirement:
      requirements:
        - type: permission
          permission: "server.vip"
    else:
      item:
        material: COAL_BLOCK
        name: "&8&lVIP Shop"
        lore:
          - "&cRequires VIP rank"

Opening at Specific Page

items:
  page_1:
    type: INVENTORY
    slot: 10
    inventory: "items_catalog"
    to-page: 1
    item:
      material: PAPER
      name: "&7Page 1"

  page_2:
    type: INVENTORY
    slot: 11
    inventory: "items_catalog"
    to-page: 2
    item:
      material: PAPER
      name: "&7Page 2"

  page_3:
    type: INVENTORY
    slot: 12
    inventory: "items_catalog"
    to-page: 3
    item:
      material: PAPER
      name: "&7Page 3"

Alternative: Using Actions

You can also open inventories using the inventory action with a NONE button:

items:
  open-shop:
    slot: 13
    item:
      material: GOLD_INGOT
      name: "&e&lShop"
    actions:
      - type: inventory
        inventory: "shop"

The INVENTORY button type is shorthand for this common pattern.

When using INVENTORY buttons, zMenu maintains a navigation history. This allows BACK buttons to return to the previous menu.

The history is automatically managed - you don't need to configure anything special.

Best Practices

  1. Use clear naming for inventory files to easily identify them
  2. Add visual feedback with sounds when opening menus
  3. Use requirements to restrict access to certain menus
  4. Provide locked states with else for restricted menus
  5. Organize in folders for complex menu structures

Next Steps

NONE Button

The default button type with no special behavior

BACK Button

Button that returns to the previous inventory

On this page

UsagePropertiesinventorypluginargumentsto-pageExamplesBasic Menu NavigationCategory SelectionWith RequirementsOpening at Specific PageAlternative: Using ActionsNavigation HistoryBest PracticesNext Steps
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.