GroupeZ Docs
Inventories

Purchased Items

Purchased items inventory configuration

The purchased items inventory displays items the player has bought but not yet claimed.

File: plugins/zAuctionHouse/inventories/purchased-items.yml

Access: /ah purchased or click the "Purchased Items" button in the main auction

Description

Item Delivery Behavior

The behavior depends on give-item in config.yml:

  • give-item: true - Items go directly to player's inventory (if space available)
  • give-item: false - Items always go to this inventory for manual claiming

Items here also have an expiration time before permanent deletion.

Default Configuration

name: '#0c1719Purchased items (%page%/%max-page%)'
size: 54

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

items:

  items:
    type: ZAUCTIONHOUSE_PURCHASED_ITEMS
    empty-slot: 22
    slots:
      - 9-17
      - 18-26
      - 27-35
      - 36-44
    item:
      material: BARRIER
      name: '#ff0000&nNo items found'

  remove-all:
    type: ZAUCTIONHOUSE_REMOVE_ALL_PURCHASED
    is-permanent: true
    slot: 47
    item:
      material: CHEST
      name: "#2CCED2<bold>Retrieve All"
      lore:
        - "#92ffffRetrieve all purchased items."
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto retrieve all"

Buttons Used

ButtonTypeDescription
itemsZAUCTIONHOUSE_PURCHASED_ITEMSDisplays purchased items
remove-allZAUCTIONHOUSE_REMOVE_ALL_PURCHASEDRetrieves all purchased items at once

Patterns Used

PatternDescription
zauctionhouse-decorationGlass pane borders
zauctionhouse-paginationPrevious/Next page buttons
zauctionhouse-backBack button to return

Placeholders

PlaceholderDescription
%page%Current page number
%max-page%Total number of pages

Click Actions

When a player clicks a purchased item:

  • The item is added to the player's inventory
  • If the player's inventory is full, the item remains unclaimed

On this page

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.