AuctionHouse 2.0.8

An AuctionHouse plugin with a familiar interface.

  1. klugemonkey
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.13
    • 1.14
    • 1.15
    for the 1.12.2 version click here:
    for the 1.8.8 version click here:

    AuctionHouse 2.0.8



    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 a 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
    • Supports Minecraft 1.13+

    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
      action_bar: false
      discord: false
      discord_channel: 'auctionhouse'
      multiworld: false
      groupWorlds: false
      replaceUUIDs: false
      replacePlayerNames: false
      dropAtFeet: false
      showSeconds: true

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

        item: minecraft:bedrock
        item: minecraft:barrier
        item: minecraft:command_block
        item: minecraft:structure_block
        item: egg
        unbreakable: true
        item: iron_sword
        damage: 1
        # color codes need to be specified with \u00a7
        # instead of the & character
        name: \u00a7cVorpal Sword
        item: minecraft:diamond_sword
        - Special Item
        - Does not list in AuctionHouse
        - ench: minecraft:sharpness
          level: 10
        - ench: minecraft:unbreaking
          level: 3
        - ench: minecraft:looting
          level: 3
        - ench: minecraft:fire_aspect
          level: 2
        - \u00a78 Item is soul bound

      click: ''
      fail: ''
      drop: 'entity.player.burp'

      exit: 'texture:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTI5NDg4MWYzMzQwOGU4OTY0ZDI1NWZkOGViMjFhZTY5ODhiMmNjYTg5OTRkMTU3OTk5NmE2ZjEzMmJjNDI5YyJ9fX0=\'
      back: 'minecraft:iron_door'
      previous: 'minecraft:paper'
      sort_listings: 'minecraft:sunflower'
      next: 'minecraft:paper'
      info: 'minecraft:book'
      howto: 'minecraft:emerald'
      return_all: 'minecraft:flower_pot'
      player_listings: 'auctionhouse:player_head'
      expired_listings: 'minecraft:poisonous_potato'
      sold_items: 'minecraft:gold_ingot'
      clear: 'minecraft:barrier'
      confirm: 'minecraft:lime_stained_glass_pane'
      cancel: 'minecraft:red_stained_glass_pane'

      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: 24

    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.13+. Features may break if used with other versions of Spigot than intended.
    Osqai, CustomWorldYT, Msql and 17 others like this.

Recent Updates

  1. Bug Fixes
  2. Bug Fix for Menu Mode
  3. Small Bug Fixes

Recent Reviews

  1. Xp10d3
    Version: 2.0.8
    For some reason this doesn't work on CraftBukkit (I'm using it or PerWorldPlugins since PWP only works on Bukkit). I have AConomy and Vault installed but it just doesn't work for me. I do /ah help and it just sends the message /ah help back at me. Tried just doing /ah as well .On my server I also get a bunch of Bungee errors saying it can't load or whatever. I can't get the error at the moment. If anyone knows how to fix this help would be much appreciated.
    1. klugemonkey
      Author's Response
      Of course it doesn't work on CraftBukkit, it's a Spigot plugin. Why would you be running CraftBukkit instead of Spigot anyway? I mean, it's like completely unsupported.
  2. SecretCraft
    Version: 2.0.8
    Funktioniert einwandfrei!
    Habe bisher keine Probleme gehabt, verschiedene Versionen sowie Anwendungsbereiche!
  3. EchocallingEarth
    Version: 2.0.8
    A fantastic plugin that works great. The players love it and so do the admins. As an owner I say worth having on your servers.
  4. FarisJaclyn
    Version: 2.0.8
    We LOVE this plugin! It is so excellent! Works amazingly. I do have a question about a possible glitch, very very rarely a player will not be able to click on something in /ah. It will give a village sound. We have noticed that players must relog completely on their MC account. Have you heard of this happening?
    1. klugemonkey
      Author's Response
      Please post any issues in the discussion forum.
  5. quanshi
    Version: 2.0.8
    Nice plugin and it helps me a lot! I think it deserves 5 stars!! Most importantly, it's free!
  6. HeavenCrafter
    Version: 2.0.8
    This has by far been one of the most impressive fork/remake of the original. DiscordSRV support, active in development and bug fixes. And, ITS FREE. What more could you possibly need out of a plugin?
  7. imza
    Version: 2.0.8
    very usefull ,i like this plugin :D , but i have little problem with discord integration
  8. Msql
    Version: 2.0.7
    Love this plugin a lot, it is very usefull. Dev is very helpful and respond almost instantly if there are any problems with the plugin.
  9. Stefanus
    Version: 2.0.6
    Works great on my server! No errors and spam console. Thanks, keep it up!឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵឵
  10. FarisJaclyn
    Version: 2.0.2
    This plugin is excellent! My players love it. The amount of effort and work this developer puts in - he deserves a raise! Thank you for the perfect auction house plugin - and its FREE! Wow!