AuctionHouse-Retro 2.0.2

An AuctionHouse plugin with a familiar interface.

  1. klugemonkey
    Tested Minecraft Versions:
    • 1.8
    for the 1.13.x/1.14.x version click here:
    for the 1.12.2 version click here:

    AuctionHouse-Retro 2.0.2



    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!
    • List items in the auction house
    • 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
    • Blacklist items by name, type, lore, enchants, damage and unbreakable flag
    • Wildcard blacklisting of all items/blocks by omitting the item type and specifying lore, or enchants (can ban selling soulbound and cursed items)
    • Regex blacklisting on item names 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> - sell the item you are holding in hand
    /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 - enables /ah menu command - enables /ah search command - enables /ah help command
    auctionhouse.sell - enables /ah sell command
    auctionhouse.selling - enables /ah selling command
    auctionhouse.sold - enables /ah sold command
    auctionhouse.expired - enables /ah expired command
    auctionhouse.cancel - enables /ah cancel command
    auctionhouse.return - enables /ah return command
    auctionhouse.cancel.others - enables cancelling other's auctions
    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.yml
    # this is the locale to use (requires xx_xx.json file)
    locale: en_us
    # disabling this disables Meta for max listings
    chatHook: true
    # this is the format for currency display
    decimal_format: '#,##0.00'
    # enabling this will check for hacked menu items in other inventories
    strict: false
    # this is how often the menus should update (20 = 1 second)
    updateTicks: 20
      listingPrice: 0.0
      listingRate: 0.0
      # listingDuration is how long an item can be listed
      listingDuration: 7d0h0m
      # expiredDuratin is how long an item shows as expired
      expiredDuration: 14d0h0m
      # unclaimedDuration is how long an item will be kept
      # it will try to return unclaimed items automatically
      unclaimedDuration: 90d0h0m
      # cleanupDuration is how often items will be destroyed
      # once they are past the unclaimedDuration
      cleanupDuration: 0d24h0m
      # soldDuration is how long sold items will be kept
      soldDuration: 365d0h0m
      preventCreative: true
      preventSpectator: true
      maxSellPrice: 100000.00
      salesTax: 0.0
      allowDamagedItems: false
      defaultMaxListings: 45
      sortOrder: 'oldest'
      announce: false
      discord: false
      discord_channel: 'auctionhouse'
      multiworld: false
      groupWorlds: false
      replaceUUIDs: false
      replacePlayerNames: false
      dropAtFeet: false
      showSeconds: true

      item: 'BEDROCK'
      item: 'BARRIER'
      item: 'COMMAND'
      item: EGG
      unbreakable: true
      item: IRON_SWORD
      damage: 1
      name: '\u00a7cVorpal Sword'
      item: 'DIAMOND_SWORD'
        - 'Special Item'
        - 'Does not list in AuctionHouse'
        - {ench: 'SHARPNESS', level: 10}
        - {ench: 'UNBREAKING', level: 3}
        - {ench: 'LOOTING', level: 3}
        - {ench: 'FIRE_ASPECT', level: 2}

      click: ''
      fail: ''
      drop: 'random.burp'

      exit: 'TEXTURE:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTI5NDg4MWYzMzQwOGU4OTY0ZDI1NWZkOGViMjFhZTY5ODhiMmNjYTg5OTRkMTU3OTk5NmE2ZjEzMmJjNDI5YyJ9fX0=\'
      back: 'IRON_DOOR'
      previous: 'PAPER'
      sort_listings: 'DOUBLE_PLANT'
      next: 'PAPER'
      info: 'BOOK'
      howto: 'EMERALD'
      return_all: 'FLOWER_POT'
      player_listings: 'PLAYER_HEAD'
      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: []

    configVersion: 16

    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.
    Valentina_pro and eUipKh like this.

Recent Updates

  1. Usability Improvements
  2. Bug Fixes
  3. SQLite Support / Performance Update

Recent Reviews

  1. skilledpt
    Version: 1.7.21
    great plugin, pls add discord-srv integration like in 1.14 version

    greetings ,
    1. klugemonkey
  2. 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.
  3. Br0ck3n4nge
    Version: 1.7.21
    Good plugin, i use this plugin for my server
  4. 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.
  5. Plattio
    Version: 1.7.15
    Very good Plugin and fast support! One of the best auctionshouse plugins on the market. :)
  6. Valentina_pro
    Version: 1.7.13
    Fantastic. Really appreciate the work you've done to extend support to any version basically.
  7. 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!