GroupeZ Docs
InventoriesAdmin

Admin Remove Confirm

Admin listing removal confirmation inventory configuration

The admin remove confirmation inventory lets an administrator remove any player's listing directly from the auction house, choosing beforehand whether the seller is notified, whether the item is returned to the seller and whether the administrator receives it.

File: plugins/zAuctionHouse/inventories/admin/admin-remove-confirm.yml

Access: In the main auction inventory, press Q (drop key) or middle click on a listing

Permission: zauctionhouse.admin.remove.inventory

How to Open It

  1. Open the auction house (/ah).
  2. Hover a listing and press the drop key (Q by default) or middle click it.
  3. The confirmation inventory opens with the selected listing shown in the top slot.

This works on the listings displayed by the ZAUCTIONHOUSE_LISTED_ITEMS button (auction.yml), and only for listings currently on sale. The check happens before the container preview: for a shulker box, Q / middle click opens the admin removal instead of the content preview. Players without the permission keep the normal behavior.

While the confirmation is open, the listing is reserved for the administrator: it disappears from the auction house of the other players and can be neither bought nor removed by its seller. Closing the inventory or clicking Cancel puts it back on sale.

Each time the inventory opens, the options are reset to their defaults: notify ON, expire ON, copy OFF. With these defaults, the listing is returned to the seller's expired items and the seller is warned.

Features

  • Preview the listing before removing it
  • Choose whether the seller is notified
  • Choose whether the item goes back to the seller or is deleted
  • Choose whether the administrator receives the item
  • Cluster-safe removal (works with the Redis addon)

Removal Options

OptionButtonDefaultWhen ONWhen OFF
NotifyZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFYONThe seller receives the admin-listing-removed messageThe seller is not told
ExpireZAUCTIONHOUSE_ADMIN_REMOVE_EXPIREONThe item is moved to the seller's Expired Items, with the normal expiration.expire duration, so the seller can claim itThe listing is deleted
CopyZAUCTIONHOUSE_ADMIN_REMOVE_COPYOFFThe administrator receives the item (see table below)The administrator receives nothing

Result of Each Combination

ExpireCopySellerAdministrator
ONOFFGets the item back in their expired itemsNothing
ONONGets the item back in their expired itemsReceives a copy of the item
OFFONLoses the itemReceives the item itself
OFFOFFLoses the itemNothing: the item is permanently deleted

The Notify option is independent and can be combined with any of these rows.

With Expire OFF and Copy OFF, the item is destroyed and cannot be recovered. With Expire OFF and Copy ON, if the item cannot be delivered to the administrator, it goes back to the seller's claimable (expired) items instead of being lost.

What Happens on Confirm

When the administrator clicks the confirm button:

  1. The plugin checks that the listing is still available, locks it and revalidates it (cluster-safe). If the item was sold or removed in the meantime, for example on another server, the administrator receives admin-item-not-available and nothing is removed.
  2. The listing is removed according to the selected options.
  3. A log of type ADMIN_REMOVE (displayed as Admin Remove) is written; it is visible in the Admin Logs inventory.
  4. The administrator receives the admin-item-removed message.
  5. The main auction inventory reopens.

Clicking the cancel button (BACK) returns to the auction house without removing anything, and the listing is put back on sale.

Offline Notification

When Notify is ON and the seller is not online on the server where the removal happens, the ADMIN_REMOVE log is stored as unread. The admin-listing-removed message is sent to the seller the next time they join, then the log is marked as read.

Default Configuration

# Every option can be toggled independently before confirming.
name: "#0c1719Remove this listing?"
size: 27
items:
  show:
    type: ZAUCTIONHOUSE_SHOW
    slot: 4
  notify:
    type: ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFY
    enable-material: BELL
    disable-material: BARRIER
    slot: 11
    item:
      material: '%material%'
      name: "%state-color%Notify player"
      lore:
        - "#8c8c8cClick to toggle"
  expire:
    type: ZAUCTIONHOUSE_ADMIN_REMOVE_EXPIRE
    enable-material: CLOCK
    disable-material: BARRIER
    slot: 13
    item:
      material: '%material%'
      name: "%state-color%Send to expired items"
      lore:
        - "#8c8c8cClick to toggle"
  copy:
    type: ZAUCTIONHOUSE_ADMIN_REMOVE_COPY
    enable-material: CHEST
    disable-material: BARRIER
    slot: 15
    item:
      material: '%material%'
      name: "%state-color%Give admin a copy"
      lore:
        - "#8c8c8cClick to toggle"
  confirm:
    type: ZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRM
    slot: 21
    item:
      material: LIME_CONCRETE
      name: "#2CCED2Confirm removal"
  cancel:
    type: BACK
    slot: 23
    item:
      material: RED_CONCRETE
      name: "#ff5555Cancel"

This file is copied automatically on startup if it is missing, so existing installations get it without regenerating their inventories.

Buttons Used

ButtonTypeDescription
showZAUCTIONHOUSE_SHOWDisplays the listing being removed
notifyZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFYToggles the seller notification
expireZAUCTIONHOUSE_ADMIN_REMOVE_EXPIREToggles between returning the item to the seller and deleting it
copyZAUCTIONHOUSE_ADMIN_REMOVE_COPYToggles giving the item to the administrator
confirmZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRMPerforms the removal
cancelBACKCancels and goes back

Option Buttons

ZAUCTIONHOUSE_ADMIN_REMOVE_NOTIFY, ZAUCTIONHOUSE_ADMIN_REMOVE_EXPIRE and ZAUCTIONHOUSE_ADMIN_REMOVE_COPY share the same configuration. Clicking the button switches its state and refreshes the inventory.

OptionDefaultDescription
enable-materialPAPERMaterial used when the option is ON
disable-materialBARRIERMaterial used when the option is OFF

Placeholders:

PlaceholderDescription
%material%enable-material or disable-material depending on the current state. Use it as item.material: '%material%'
%state-color%#55ff55 when ON, #ff5555 when OFF
%enabled%true or false

ZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRM

Removes the listing shown by ZAUCTIONHOUSE_SHOW using the current state of the three options. It has no specific options. If the listing is no longer on sale when clicked, the main auction inventory simply reopens.

Messages

KeySent toDefault (English)
admin-listing-removedSeller (immediately, or on next join if offline)<error>Your listing <white>%items%<error> was removed by an administrator.
admin-item-removedAdministrator<success>You removed <white>%items%<success> from <white>%target%<success>.
admin-item-not-availableAdministrator<error>The item <white>%items%<error> is no longer available: it was sold, claimed or removed on another server.

Messages are configured in messages.yml (see Messages).

Admin Main

Admin player directory inventory configuration

Admin History Main

Admin history main hub inventory configuration

On this page

How to Open ItFeaturesRemoval OptionsResult of Each CombinationWhat Happens on ConfirmOffline NotificationDefault ConfigurationButtons UsedOption ButtonsZAUCTIONHOUSE_ADMIN_REMOVE_CONFIRMMessages
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.