GroupeZ Docs
Inventories

Patterns

Reusable pattern templates for zAuctionHouse inventories

Patterns are reusable inventory templates that add common elements. They are stored in plugins/zAuctionHouse/patterns/ and can be included in any inventory.

How Patterns Work

  • Patterns are applied in order; later patterns can override earlier ones
  • Items from patterns can be overridden by the including inventory
  • Multiple patterns can be combined in a single inventory

Using Patterns

Include patterns in your inventory files:

name: "My Inventory"
size: 54

patterns:
  - 'zauctionhouse-decoration'
  - 'zauctionhouse-pagination'
  - 'zauctionhouse-back'

items:
  # Your items here (override pattern slots as needed)

zauctionhouse-decoration

Adds decorative glass pane borders to the top and bottom rows.

File: plugins/zAuctionHouse/patterns/decoration.yml

Configuration:

name: "zauctionhouse-decoration"
size: 54

items:

  decoration:
    is-permanent: true
    slots:
      - '0-8'     # Top row
      - '45-53'   # Bottom row
    item:
      material: LIGHT_BLUE_STAINED_GLASS_PANE
      name: "<white>"

Visual:

┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
│ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │  ← Glass Panes
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │ ■ │  ← Glass Panes
└───┴───┴───┴───┴───┴───┴───┴───┴───┘

zauctionhouse-pagination

Adds previous and next page navigation buttons.

File: plugins/zAuctionHouse/patterns/pagination.yml

Configuration:

name: "zauctionhouse-pagination"
size: 54

items:

  previous:
    type: PREVIOUS
    is-permanent: true
    slot: 48
    item:
      url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjllYTFkODYyNDdmNGFmMzUxZWQxODY2YmNhNmEzMDQwYTA2YzY4MTc3Yzc4ZTQyMzE2YTEwOThlNjBmYjdkMyJ9fX0="
      name: "#2CCED2<bold>ᴘʀᴇᴠɪᴏᴜs ᴘᴀɢᴇ"
      lore:
        - "#92ffffGo to the previous page."
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto open"
    else:
      item:
        material: LIGHT_BLUE_STAINED_GLASS_PANE
        name: "<white>"

  next:
    type: NEXT
    is-permanent: true
    slot: 50
    item:
      url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODI3MWE0NzEwNDQ5NWUzNTdjM2U4ZTgwZjUxMWE5ZjEwMmIwNzAwY2E5Yjg4ZTg4Yjc5NWQzM2ZmMjAxMDVlYiJ9fX0="
      name: "#2CCED2<bold>ɴᴇxᴛ ᴘᴀɢᴇ"
      lore:
        - "#92ffffGo to the next page."
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto open"
    else:
      item:
        material: LIGHT_BLUE_STAINED_GLASS_PANE
        name: "<white>"

Visual:

┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │ < │   │ > │   │   │   │  ← Pagination
└───┴───┴───┴───┴───┴───┴───┴───┴───┘
             ↑       ↑
         Slot 48  Slot 50

Behavior:

  • Previous: Shows arrow head when on page 2+, glass pane on page 1
  • Next: Shows arrow head when more pages exist, glass pane on last page

zauctionhouse-back

Adds a back button to return to the previous inventory.

File: plugins/zAuctionHouse/patterns/back.yml

Configuration:

name: "zauctionhouse-back"
size: 54

items:

  previous:
    type: BACK
    is-permanent: true
    slot: 49
    item:
      material: BARRIER
      name: "#2CCED2<bold>ʙᴀᴄᴋ"
      lore:
        - "#92ffffGo to the previous inventory."
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto open"

Visual:

┌───┬───┬───┬───┬───┬───┬───┬───┬───┐
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │   │   │   │   │   │
├───┼───┼───┼───┼───┼───┼───┼───┼───┤
│   │   │   │   │ x │   │   │   │   │  ← Back
└───┴───┴───┴───┴───┴───┴───┴───┴───┘
                 ↑
             Slot 49

Creating Custom Patterns

You can create your own patterns in the patterns/ folder:

# patterns/my-custom-pattern.yml
name: "my-custom-pattern"
size: 54

items:
  my-element:
    is-permanent: true
    slots:
      - 0
      - 8
    item:
      material: DIAMOND
      name: "&bDecoration"

Then use it in your inventories:

patterns:
  - 'my-custom-pattern'

Pattern names must be unique across all pattern files.

Container Content

Container content preview inventory configuration

Admin History Main

Admin history main hub inventory configuration

On this page

How Patterns WorkUsing Patternszauctionhouse-decorationzauctionhouse-paginationzauctionhouse-backCreating Custom Patterns
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.