AuctionHouse-Retro 2.1-rc6

An AuctionHouse plugin for 1.8.8 with a familiar interface.

  1. klugemonkey
    Tested Minecraft Versions:
    • 1.8
    for the 1.13.2+ version click here:
    for the 1.9.4-1.12.2 version click here:

    AuctionHouse-Retro 2.1-rc6



    AuctionHouse allows players to list items for sale on an auction house accessible with the /ah command. The plugin is new code and only shares a similar look and feel as the inactive plugin resource AuctionHouse.



    • FREE!
    • Sell items in the auction house
    • List server items in the auction house (one-time or unlimited)
    • View items matching a search filter based on name, type, lore, enchants, or seller
    • Sort chronologically or by price
    • Show items you are selling
    • Cancel items
    • Collect cancelled/expired items
    • Drop unclaimed items at player's feet
    • Automatically clean up abandoned items
    • Show and clear recently sold items
    • Hover over item to show time remaining and enchants
    • Charge a flat and/or percentage based fee for listing an item (with confirmation menu)
    • Tax sellers a percentage of revenue for each sale with cap
    • Set min and max prices
    • Restrict items by name, type, lore, enchants, damage and unbreakable flag
    • Restrict wildcard items/blocks by omitting the item type and specifying lore, or enchants (can ban selling soulbound and cursed items)
    • Restrict item names using Regex with regex:<expr>
    • Optional Back/Exit button calls a command to return to another menu
    • Click on a special sign to open the auction house
    • Click on certain named block entities to open the auction house (chests, shulker boxes, dispensers, droppers, hoppers, furnaces, enchanting tables, brewing stands)
    • Click on custom named entities to open the auction house
    • Console command support for custom menu and NPC plugins
    • Internationalization Support
    • Customize messages, button materials and sounds
    • Support for HeadDatabase heads as buttons with hdb:<id>
    • Support for custom skull textures as buttons with texture:<base64 data>
    • Supports player head for the player listings button with auctionhouse player_head
    • Logging all transactions to separate log file
    • Announce listings to all players
    • Discord integration
    • Rewriting of String UUIDs in NBT (Seller -> Buyer)
    • Multi-world support with simple world grouping
    • Set cooldown between listings
    • This retro version specifically supports Minecraft 1.8.8

    Thanks to Viktor over at for the video!

    /ah reload - reloads the auctionhouse configuration
    /ah - open the auction house
    /ah <player> - open the auction house for a player (console only)
    /ah menu - open the auction house in menu mode
    /ah menu <player> - open the auction house in menu mode for a player (console only)
    /ah search <filter> - view items matching search filter
    /ah help - show help for all the commands
    /ah sell <price> [count] - sell the item you are holding in hand
    /ah list <price> [count] - list the item as server
    /ah ulist <price> [count] - list the item as server with unlimited buying
    /ah selling - view the items you are selling
    /ah sold - view the items you have sold recently
    /ah expired - view your expired items to return
    /ah cancel - cancel all your auctions
    /ah return - return all your cancelled/expired items
    auctionhouse.reload - enables reloading the plugin
    auctionhouse.use - enables /ah command (default: true) - enables /ah menu command - enables /ah search command (default: true) - enables /ah help command (default: true)
    auctionhouse.sell - enables /ah sell command (default: true)
    auctionhouse.list - enables /ah list command
    auctionhouse.ulist - enables /ah ulist command
    auctionhouse.selling - enables /ah selling command (default: true)
    auctionhouse.sold - enables /ah sold command (default: true)
    auctionhouse.expired - enables /ah expired command (default: true)
    auctionhouse.cancel - enables /ah cancel command (default: true)
    auctionhouse.return - enables /ah return command (default: true)
    auctionhouse.cancel.others - enables cancelling other's auctions
    auctionhouse.trigger.block - enables block triggers for menu
    auctionhouse.trigger.entity - enables entity triggers for menu
    auctionhouse.trigger.sign - enables sign triggers for menu
    auctionhouse.auctions.# - sets maximum listings

    *Note: the plugin will take the maximum set value of the setting in the config.yml, permissions and meta.
    auctions - sets the number of auctions a player can list​

    To use meta, you need to have a compatible permissions plugin that supports setting and removal of meta such as PermissionsEx or LuckPerms.

    For PermissionsEx use:
    /pex user <user> set auctions <value>
    /pex group <group> set auctions <value>
    For LuckPerms use:
    /lp user <user> meta set auctions <value>
    /lp group <group> meta set auctions <value>

    For GroupManager use:
    /manuaddv <user> auctions <value>
    /mangaddv <group> auctions <value>

    Code (Text):

    # AuctionHouse
    config_version: 29
    locale: en_us
    decimal_format: "#,##0.00"
    strict: false
    economy: vault
    chatHook: true
    updateTicks: 20

      listingPrice: 0.00
      listingRate: 0.00
      listingCooldown: 0d0h0m0s
      listingDuration: 7d0h0m
      expiredDuration: 14d0h0m
      unclaimedDuration: 90d0h0m
      cleanupDuration: 0d24h0m
      soldDuration: 365d0h0m
      unclaimedCheckDuration: 0d0h5m
      unclaimedCheckOnWorldChange: true
      preventCreative: true
      preventSpectator: true
      minSellPrice: 0.00
      maxSellPrice: 100000.00
      salesTax: 0.00
      maxSalesTax: 100000.00
      allowDamagedItems: false
      defaultMaxListings: 5
      # oldest, newest, highest_price, lowest_price
      sortOrder: 'oldest'
      announce: false
      action_bar: true
      discord: false
      discord_channel: 'auctionhouse'
      multiworld: false
      groupWorlds: false
      replaceUUIDs: false
      replacePlayerNames: false
      dropAtFeet: false
      showSeconds: true
      spawnerInfo: true
      integerPrice: false
      showRepairCost: true

        listings: true
        purchases: true
        listings: false
        purchases: false

        item: 'BEDROCK'
        item: 'BARRIER'
        item: 'COMMAND'
        name: '\u00a7cVorpal Sword'
        item: 'DIAMOND_SWORD'
          - 'Special Item'
          - 'Does not list in AuctionHouse'
          - {ench: 'DAMAGE_ALL', level: 10}
          - {ench: 'DURABILITY', level: 3}
          - {ench: 'LOOT_BONUS_MOBS', level: 3}
          - {ench: 'FIRE_ASPECT', level: 2}
        unbreakable: true
      click: 'click'
      fail: ''
      drop: 'burp'
      sold: 'note.pling'

      exit: 'IRON_DOOR'
      back: 'IRON_DOOR'
      previous: 'PAPER'
      sort_listings: 'DOUBLE_PLANT'
      next: 'PAPER'
      info: 'BOOK'
      howto: 'EMERALD'
      return_all: 'FLOWER_POT'
      player_listings: 'DIAMOND'
      expired_listings: 'POISONOUS_POTATO'
      sold_items: 'GOLD_INGOT'
      clear: 'BARRIER'
      confirm: 'STAINED_GLASS_PANE:5'
      cancel: 'STAINED_GLASS_PANE:14'

      sign: '[AuctionHouse]'
      block_name: 'Auction House'
      entity_name: 'Auction House'

      exit: "msg %player% Exiting AuctionHouse"

      listed: true
      sold: true
      cancelled: true
      returned: true
      dropped: true
      purged: true

    disabled-worlds: []

    DiscordSRV Support:
    This plugin currently supports DiscordSRV 1.18+ integration. To configure for DiscordSRV, you need to set discord: true in the config.yml and set the discord_channel: 'auctionhouse', where auctionhouse represents the in-game channel name you will configured in DiscordSRV's config.yml.
    Usually this can be achieved by adding an additional entry into the Channels: section of DiscordSRV's config.yml using the same numeric channel as the global one. It might look something like the following with the actual number matching what is given in Discord.
    Code (Text):

    # Channel links from game to Discord
    # syntax is Channels: {"in-game channel name": "numerical channel ID from Discord", "another in-game channel name": "another numerical channel ID from Discord"}
    # The first channel pair specified in this config option will be the "main" channel, used for sending player joins/quits/deaths/achievements/etc
    Channels: {"global": "123456789012345678", "auctionhouse": "123456789012345678"}

    Known Issues:
    • There is no support for drag-and-drop of items.
    • There is no external database support - it uses SQLite.
    • Users should supply localized translation files
    • Per user maximum listings are not supported by all permissions plugins, and may require additional configuration

      • Vault (version 1.5+)
      • An appropriate Economy Plugin
      • An appropriate Permissions Plugin
    Terms of Service:

    The plugin is provided AS-IS.

    Please report all issues by starting a conversation. If you post in the discussion forum, it may get overlooked as we are getting more discussion now.


    This plugin currently supports Spigot version 1.8.8. Features may break if used with other versions of Spigot than intended.

Recent Updates

  1. Release Candidate 6 (Feature Parity)
  2. Release Candidate 5 (Feature Parity)
  3. Release Candidate 4 (Feature Parity)

Recent Reviews

  1. omgsdsada
    Version: 2.0.8
    Can you update to 1.8 x 1.8.9 please?

    I think its nice plugin :)
    1. klugemonkey
      Author's Response
      This is for reviews, not for bug reports. Please report any issues in the discussion forum.
  2. awpasdoasd
    Version: 2.0.7
    Cant open the gui however when I do /ah it says /ah help and when I reinstalled it and did /ah nothing happend. Will change my rating if it gets fixed
  3. skilledpt
    Version: 1.7.21
    great plugin, pls add discord-srv integration like in 1.14 version

    greetings ,
    1. klugemonkey
  4. chef_big_dog
    Version: 1.7.21
    used this plugin on a previous server but for some reason refuses to work despite trying several versions. good plugin but i wish it would actually work. /pl shows its red constantly and /ah does nothing.
  5. Br0ck3n4nge
    Version: 1.7.21
    Good plugin, i use this plugin for my server
  6. HotDoctor
    Version: 1.7.17a
    I love it, but could you add an api?


    GetAuctionTopCheap(int number)
    number -> in this case, if we put 1, returns the item most cheap in the auctionhuse

    using this we can get the item material, values, auction owner, and these things.
  7. Plattio
    Version: 1.7.15
    Very good Plugin and fast support! One of the best auctionshouse plugins on the market. :)
  8. Valentina_pro
    Version: 1.7.13
    Fantastic. Really appreciate the work you've done to extend support to any version basically.
  9. ice_orange
    Version: 1.7.12
    This plug-in is very useful. I can buy something in the future. Trading is a wonderful thing, so players can buy what they want. Excellent!