GroupeZ Docs

Combined Items

Combined inventory showing selling, expired, and purchased items together

The combined items inventory merges multiple item views (selling, expired, purchased) into a single paginated list. You can configure which storage types to include.

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

Features

  • Combine selling, expired, and purchased items in one view
  • Each item type uses its own lore configuration (from config.yml item-lore section)
  • Click action automatically adapts to the item's storage type:
    • Selling items: removes/cancels the listing
    • Expired items: claims the item back
    • Purchased items: claims the purchased item
  • Individually toggle each source with include-selling, include-expired, include-purchased

Default Configuration

name: '#0c1719My Items (%page%/%max-page%)'
size: 54

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

items:

  items:
    type: ZAUCTIONHOUSE_COMBINED_ITEMS
    empty-slot: 22
    include-selling: true
    include-expired: true
    include-purchased: true
    slots:
      - 9-17
      - 18-26
      - 27-35
      - 36-44
    item:
      material: BARRIER
      name: '#ff0000&nNo items found'

Buttons Used

ButtonTypeDescription
itemsZAUCTIONHOUSE_COMBINED_ITEMSDisplays combined items from multiple storage types

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

The click action adapts automatically based on the item's storage type:

Item TypeClick Action
Selling (active listing)Removes/cancels the listing, item moves to expired
ExpiredClaims the item back to the player's inventory
PurchasedClaims the purchased item to the player's inventory

Configuration Options

PropertyTypeDefaultDescription
include-sellingBooleantrueInclude items the player currently has listed for sale
include-expiredBooleantrueInclude items that expired without being sold
include-purchasedBooleantrueInclude items the player has bought but not yet claimed
empty-slotNumber-1Slot for the "no items" placeholder (-1 to disable)

Examples

Show only expired and purchased items:

items:
  type: ZAUCTIONHOUSE_COMBINED_ITEMS
  include-selling: false
  include-expired: true
  include-purchased: true
  slots:
    - 9-17
    - 18-26

Show only selling items (equivalent to ZAUCTIONHOUSE_SELLING_ITEMS):

items:
  type: ZAUCTIONHOUSE_COMBINED_ITEMS
  include-selling: true
  include-expired: false
  include-purchased: false
  slots:
    - 9-17
    - 18-26

Custom Economy

Create custom economy implementations for zAuctionHouse

On this page

FeaturesDefault ConfigurationButtons UsedPatterns UsedPlaceholdersClick ActionsConfiguration OptionsExamples
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.