• Added ZAUCTIONHOUSE_COMBINED_ITEMS button - combines selling, expired, and purchased items into a single paginated view. Each source is individually togglable via include-selling, include-expired, and include-purchased. Click actions automatically adapt to the item's storage type (cancel listing, claim expired, claim purchased). Each item type uses its own lore configuration from config.yml
• Fixed Item duplication exploit in multi-server (Redis) setups - removing a listing on one server and claiming the expired item could leave a ghost entry on the original server, allowing the item to be claimed again after natural expiration
• Fixed ItemRemovedListener (Redis addon) - removed fragile DB state validation that rejected removal messages due to race conditions, added safety-net cleanup across all storage types
• Fixed ItemStatusListener (Redis addon) - status change propagation now searches across all storage types (LISTED, EXPIRED, PURCHASED) instead of only LISTED
• Fixed ExpireService - added guard against re-expiring items already deleted/claimed on another server
• Added Redis Sentinel support (Redis addon) - enables high-availability Redis setups with automatic master discovery and failover. Configure mode: "sentinel" in config.yml with sentinel nodes. Fully backward compatible, existing standalone configurations work without changes
• Fixed NullPointerException when default economy is not configured - /ah sell and all sell-related buttons now display an error message instead of crashing. Added startup validation with prominent warnings in console when a default economy is missing from economies.yml
• Fixed Incorrect economy type names in economies.yml comments - COINS_ENGINE and PLAYER_POINTS did not match the actual CurrenciesAPI enum values (COINSENGINE, PLAYERPOINTS), causing these economy types to silently fail to load when users followed the documented names
• Added All permissions are now programmatically registered in Spigot on startup and reload. Includes static permissions (use, sell, admin, etc.), and dynamic permissions from configuration (listing limits, expiration tiers, tax bypass/reductions, economy access, inventory commands, cooldown bypass). All permissions are grouped under the zauctionhouse.* wildcard
• Fixed Items dropping on the ground when claiming expired, purchased, or selling items with a full inventory - items now stay in their storage when the player's inventory is full. Added player-inventory-must-have-free-space config option under remove-expired-item and selling-item sections (enabled by default)
• Added ZAUCTIONHOUSE_REMOVE_ALL_EXPIRED, ZAUCTIONHOUSE_REMOVE_ALL_SELLING, ZAUCTIONHOUSE_REMOVE_ALL_PURCHASED buttons - allows players to retrieve all items at once from expired, selling, and purchased inventories. Items are given one by one and stops when inventory is full (if player-inventory-must-have-free-space is enabled)
• Added ItemContentProvider API - extensible system for displaying the contents of container items (shulker boxes, custom containers from plugins). External plugins can register their own providers via AuctionPlugin.getItemContentManager().registerProvider()
• Added AxShulkers hook - displays the contents of shulker boxes managed by the AxShulkers plugin in the item content viewer. AxShulkers stores shulker contents externally instead of in vanilla NBT, so this hook is required to view their contents
• Fixed Seller not receiving money in multi-server (Redis) setups when the buyer is on a different server - the plugin tried to deposit money locally on the buyer's server where the seller's economy account may not exist. Money is now deferred to PENDING status in distributed environments and claimed by the seller on their own server via /ah claim or auto-claim on join
• Added AuctionClusterBridge.isDistributed() - allows cluster bridge implementations to signal a multi-server environment so the plugin can adapt its behavior (e.g., defer deposits instead of executing them locally)

• Added ZAUCTIONHOUSE_CLAIM button - displays pending money per economy with dynamic placeholders and allows players to claim directly from the auction GUI
• Added Configurable loading-item for the claim button, shown while pending money data is being fetched
• Added PRICE_WITHOUT_DECIMAL price format - displays prices without decimal places (e.g., 10000.50 -> 10000)
• Added %price-price-without-decimal% placeholder - displays the price without decimals in item lore
• Added /ah admin forceopen can now be executed from the console
• Added timezone configuration option - allows changing the timezone used for all date placeholders (%date%, %formatted-expire-date%, %expires_at%). Supports all Java TimeZone IDs (e.g., Europe/Paris, America/New_York, UTC). Defaults to auto (server timezone)
• Fixed /ah admin open and /ah admin history tab completion no longer loads all offline players, preventing lag on servers with many players
• Fixed updateListedItems crash on Folia/Canvas - inventory holder access was running on an async thread instead of the main tick thread
• Fixed economy name argument configuration for the sell command - when the economy argument index was not configured, the default value was ignored causing a null economy name

• Added ZelAuction migration - migrate data from ZelAuction plugin to zAuctionHouse V4 using /ah admin migrate zelauction confirm
• Added Search system - players can search items by name, material, lore, or seller directly from the auction house GUI or via /ah search <query>
• Added ZAUCTIONHOUSE_SEARCH button - opens a chat-based search input with support for advanced filter operators
• Added ZAUCTIONHOUSE_CLEAR_SEARCH button - clears the active search filter, only visible when a search is active
• Added /ah search <query> command - search items directly from chat without opening the GUI first
• Added Advanced search filters with operators: ~ (contains), = (exact), ~= (contains, ignore case), == (exact, ignore case)
• Added Searchable fields: name, material, lore, seller (e.g., seller = Notch, name ~ Diamond)
• Added /ah admin forceopen <player> <inventory> [page] - Open any inventory for a player at a specific page. Supports all inventory names (e.g., auction, admin-selling-items, history, admin-logs, etc.) with tab completion. Page defaults to 1
• Added reset-search-on-open config option - When enabled (default: true), the search filter is cleared every time a player opens the auction house, matching the existing reset-category-on-open behavior

Search system

Players can search for items in the auction house using the search button or the /ah search command. The default search checks item name, material, lore, and seller name (case-insensitive substring).

Advanced filters:

field operator value

Examples:

seller = Notch
name ~ Diamond
material ~= sword
lore ~ Sharpness

• Added ZAUCTIONHOUSE_SELL_LIMIT button - displays remaining sell slots visually using a list of inventory slots, configurable per item type (auction, bid, rent)
• Added %zauctionhouse_max_items_<type>% placeholder - returns the maximum number of items a player can list for a specific type (auction, bid, rent)
• Optimized item lore placeholder resolution, placeholders are now pre-detected at config load and only resolved when referenced, significantly reducing CPU and memory usage per item render
• Fixed /ah history stuck on "Loading..." when action.purchased-item.give-item: true is enabled
• Fixed default config values
• Fixed default table prefix to zauctionhousev4 (fixes compatibility with zAuctionHouse V3)

ZAUCTIONHOUSE_SELL_LIMIT button

sell-limit:
  type: ZAUCTIONHOUSE_SELL_LIMIT
  types:
    - auction
  slots:
    - 0-9
  item:
    material: LIME_STAINED_GLASS_PANE
    name: '&aAvailable slot'

%zauctionhouse_max_items_<type>% placeholder

Returns the maximum number of items a player can list based on their permissions for the given type.

• %zauctionhouse_max_items_auction%
• %zauctionhouse_max_items_bid%
• %zauctionhouse_max_items_rent%

• Added zauctionhouse_category permissible for zMenu - allows conditional button visibility based on the player's currently selected category (defaults to main)
• Added ZAUCTIONHOUSE_CATEGORY_SWITCHER button - combines category cycling (left/right click) with dynamic lore showing enable/disable state per category
• Added %zauctionhouse_category_id% placeholder - returns the player's currently selected category ID
• Added ZAUCTIONHOUSE_HISTORY_INVENTORY button - opens the sales history inventory directly from any UI
• Added force-amount-one option in config.yml (item-lore section) - forces displayed item amount to 1 in the auction inventory while preserving the real amount internally
• Changed AuctionEconomy API - economy methods (get, has, deposit, withdraw) now accept UUID instead of OfflinePlayer for better compatibility
• Updated CurrenciesAPI dependency from 1.0.12 to 1.0.13
• Fixed category display name fallback - now uses the configured "all" category name instead of a hardcoded "All" string
• Fixed empty slot crash - list buttons (ListedItems, ExpiredItems, PurchasedItems, SellingItems) no longer crash when emptySlot is -1 and the list is empty
• Fixed history loading slot - HistoryItemsButton now properly handles loadingSlot set to -1 without throwing an error
• Fixed LoadingSlotLoader - added validation for invalid slot values with a clear error message

zauctionhouse_category permissible

requirements:
  - type: zauctionhouse_category
    category: "weapons"

ZAUCTIONHOUSE_CATEGORY_SWITCHER button

category-switcher:
  type: ZAUCTIONHOUSE_CATEGORY_SWITCHER
  slot: 49
  enable-text: "&a● %category%"
  disable-text: "&7○ %category%"
  categories:
    - "main"
    - "weapons"
    - "armor"
    - "tools"
    - "blocks"
    - "consumables"
    - "resources"
    - "enchanted-books"
    - "misc"
  item:
    material: COMPASS
    name: "&6Categories &7(&f%category%&7)"
    lore:
      - ""
      - "%main%"
      - "%weapons%"
      - "%armor%"
      - "%tools%"
      - "%blocks%"
      - "%consumables%"
      - "%resources%"
      - "%enchanted-books%"
      - "%misc%"
      - ""
      - "&7Left-click &8» &fNext"
      - "&7Right-click &8» &fPrevious"

force-amount-one option

item-lore:
  # Forces the displayed item amount to 1 in the auction inventory.
  # The real amount is preserved internally and given to the buyer on purchase.
  # Useful to keep a clean, uniform display.
  force-amount-one: false