GroupeZ Docs
Inventories

History

Sales history inventory configuration

The history inventory displays the player's completed sales. This is a read-only view showing all items the player has sold.

File: plugins/zAuctionHouse/inventories/history.yml

Access: /ah history

Description

Features

  • View all items you have sold
  • See who bought each item and when
  • Sort by date, price, or buyer name
  • Historical data is kept based on configuration

Default Configuration

name: '#0c1719Sales History (%page%/%max-page%)'
size: 54

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

items:

  items:
    type: ZAUCTIONHOUSE_HISTORY_ITEMS
    loading-slot: 22
    slots:
      - 9-17
      - 18-26
      - 27-35
      - 36-44
    item:
      material: BARRIER
      name: "#ff0000Loading..."
    else:
      slots:
        - 22
      item:
        material: BARRIER
        name: '#ff0000&nNo Sales Found'
        lore:
          - ''
          - '&7You have not sold any items yet.'

  sort:
    type: ZAUCTIONHOUSE_HISTORY_SORT
    slot: 51
    enable-text: ' #F27438➜ %sorting%'
    disable-text: ' #76CDCD➜ %sorting%'
    sorts:
      - DATE_DESC
      - DATE_ASC
      - PRICE_DESC
      - PRICE_ASC
      - BUYER_ASC
      - BUYER_DESC
    sort-names:
      DATE_DESC: "Newest First"
      DATE_ASC: "Oldest First"
      PRICE_DESC: "Highest Price"
      PRICE_ASC: "Lowest Price"
      BUYER_ASC: "Buyer A-Z"
      BUYER_DESC: "Buyer Z-A"
    item:
      material: HOPPER
      name: "#2CCED2<bold>sᴏʀᴛ"
      lore:
        - "#92ffffAvailable sort types:"
        - "%DATE_DESC%"
        - "%DATE_ASC%"
        - "%PRICE_DESC%"
        - "%PRICE_ASC%"
        - "%BUYER_ASC%"
        - "%BUYER_DESC%"
        - ""
        - "#8c8c8c• #2CCED2Click #92ffffto change the sort type"

Buttons Used

ButtonTypeDescription
itemsZAUCTIONHOUSE_HISTORY_ITEMSDisplays sales history
sortZAUCTIONHOUSE_HISTORY_SORTChanges sort order

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

Sort Options

SortDescription
DATE_DESCNewest sales first
DATE_ASCOldest sales first
PRICE_DESCHighest price first
PRICE_ASCLowest price first
BUYER_ASCBuyer name A-Z
BUYER_DESCBuyer name Z-A

Loading State

The history inventory loads data asynchronously. During loading:

  • The loading-slot displays the loading placeholder
  • Once loaded, items are displayed normally
  • The else configuration is shown when no history exists

Selling Items

Your selling items inventory configuration

Purchase Confirm

Purchase confirmation inventory configuration

On this page

FeaturesDefault ConfigurationButtons UsedPatterns UsedPlaceholdersSort OptionsLoading State
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.