Description
Gallery
Changelog
Versions
Auction House Plugin
Use /ah to open the auction house.
Requirements:
- Vault (or VaultUnlocked if you use Folia)
- Any Ecomony Plugin (for example Essentials or BetterEconomy)
Admins on the server can also use /ah admin [opens the ah, but if you click on an item you can delete it from the ah] /ah ban [make a player unable to use /ah]
For the commands a description is provided in-game. If you aren't op on the server and want to use permissions to access these commands, the current permission is called "auctionhouse.moderator"
To set up an auction use /ah sell
config.yml
tax: 0.01 # 1% tax
auction-setup-time: 30 # the time it takes to put an item on auction
default-max-auctions: 10
sold-message: true # send a message to the player when one of their auctions is sold
auto-collect: false # automatically gives the money to the player when an auction is bought and removes it from the ah
partial-selling: false # allows players to select the amount of items they want to buy of an auction
admin-permission: "auctionhouse.moderator"
display-update: 20 # 20 ticks = 1 second, how frequently the item displays are updated; can be set to 1 for instant updates
auction-announcements: true # announce when someone puts an item on auction (players can toggle this with /ah announce)
bin-auctions: true # BIN = Buy It Now [/ah sell <amount>]
bin-auction-duration: 172800 # the time an auction lasts in seconds (60*60*48 = 172800)
min-bin: 1 # the minimum sell price
bid-auctions: true # enables actual auctions by typing [/ah bid <amount>]
bid-auction-duration: 7200 # the time a bidding auction lasts in seconds (60*60*2 = 7200)
min-bid: 1 # the minimum bid price
last-bid-extra-time: 60 # if the auction time is less than this when a bid is placed, it's set to this
bid-increase-percent: 25 # how much each bid has to increase at least
Example of permissions.yml file
# the default auction slots and duration can be edited in the config.yml file
# by default this is empty. To add ranks/permissions, add them like so:
auction-slots:
vip: 12
mvp: 15
custom.example.permission: 50
auction-duration:
vip: 259200 # 60*60*24*3 = 3 days
mvp: 345600 # 60*60*24*4 = 4 days
custom.example.permission: 432000 # 5 days
# --------------------------------------------------------------------------------------------
# the "vip" and "mvp" here are used directly for the permission.
# If you want the permission to be "ah.vip", you have to add it like this:
auction-slots:
ah.vip: 12colour codes used in the messages.yml
# §k obfuscated
# §l bold
# §m strikethrough
# §n underline
# §o italic
# §r reset
# &n new line
# §0: Black
# §1: Dark Blue
# §2: Dark Green
# §3: Dark Aqua
# §4: Dark Red
# §5: Dark Purple
# §6: Gold
# §7: Gray
# §8: Dark Gray
# §9: Blue
# §a: Green
# §b: Aqua
# §c: Red
# §d: Light Purple
# §e: Yellow
# §f: Whitelayout.yml
# You can replace any character with another or even remove a line to change the layout. The spaces between the characters are there to make it clearer. The characters are defined down below.
ah-layout:
- '# # # # # # # # #'
- '# . . . . . . . #'
- '# . . . . . . . #'
- '# . . . . . . . #'
- '# # # # # # # # #'
- 's o # p r n # f m'
my-ah-layout:
- '# # # # # # # # #'
- '# . . . . . . . #'
- '# . . . . . . . #'
- '# . . . . . . . #'
- '# # # # # # # # #'
- 'b o # p r n # d i'
'#':
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:black_stained_glass_pane
count: 1
components:
minecraft:tooltip_display: '{hide_tooltip:1b}'
schema_version: 1
s:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:oak_sign
count: 1
schema_version: 1
active-search:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:spruce_sign
count: 1
schema_version: 1
o:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:hopper
count: 1
schema_version: 1
p:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:arrow
count: 1
schema_version: 1
r:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:nether_star
count: 1
schema_version: 1
n:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:arrow
count: 1
schema_version: 1
m:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:ender_chest
count: 1
schema_version: 1
b:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:arrow
count: 1
schema_version: 1
i:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:paper
count: 1
schema_version: 1
f:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:powered_rail
count: 1
schema_version: 1
d:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:golden_carrot
count: 1
schema_version: 1
bin-filter-bin:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_ingot
count: 1
schema_version: 1
bin-filter-auctions:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_block
count: 1
schema_version: 1
locked-slot:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:barrier
count: 1
schema_version: 1
back-to-my-auctions:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:arrow
count: 1
schema_version: 1
anvil-search-paper:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:paper
count: 1
schema_version: 1
cancel:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:red_banner
count: 1
schema_version: 1
collect-expired-item:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:red_dye
count: 1
schema_version: 1
cancel-auction:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:red_concrete
count: 1
schema_version: 1
command-block-info:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:structure_block
count: 1
schema_version: 1
admin-cancel-auction:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:red_concrete
count: 1
schema_version: 1
admin-expire-auction:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:red_dye
count: 1
schema_version: 1
confirm:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:green_banner
count: 1
schema_version: 1
choose-item-buy-amount:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:oak_hanging_sign
count: 1
schema_version: 1
dirt:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:dirt
count: 1
schema_version: 1
turtle-scute-confirm:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:turtle_scute
count: 1
schema_version: 1
cannot-afford:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:armadillo_scute
count: 1
schema_version: 1
collect-sold-item:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:diamond
count: 1
schema_version: 1
bid-history:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:filled_map
count: 1
schema_version: 1
bid-explanation:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_ingot
count: 1
schema_version: 1
submit-bid:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_nugget
count: 1
schema_version: 1
cannot-afford-bid:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:armadillo_scute
count: 1
schema_version: 1
top-bid:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_block
count: 1
schema_version: 1
collect-auction:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_block
count: 1
schema_version: 1
collect-coins:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:gold_nugget
count: 1
schema_version: 1
own-bid:
==: org.bukkit.inventory.ItemStack
DataVersion: 4325
id: minecraft:poisonous_potato
count: 1
schema_version: 1
sounds:
click: "UI_STONECUTTER_SELECT_RECIPE"
open-enderchest: "BLOCK_ENDER_CHEST_OPEN"
close-enderchest: "BLOCK_ENDER_CHEST_CLOSE"
break-wood: "BLOCK_WOOD_BREAK"
experience: "ENTITY_EXPERIENCE_ORB_PICKUP"
villager-deny: "ENTITY_VILLAGER_NO"
open-shulker: "BLOCK_SHULKER_BOX_OPEN"
close-shulker: "BLOCK_SHULKER_BOX_CLOSE"Q&A
Q: Can I customize messages and GUI texts? A: Yes, edit the messages.yml file in the plugin folder. You can change the currency from "coins" to whatever you like under "placeholders" in the messages.yml file.
Q: How do I update the config with new options? A: The plugin automatically adds missing config options when updated, without overwriting your custom settings.
Q: How do I spawn that Auction Master Villager and the item displays and how do I remove them?
A: If you are op, then you can do /ah summon
Q: The Auction Master Villager and the item displays disappear after a while A: If you do something like /kill @e, of course they will be removed. Also, if you use /teleport @e, they will be moved.
Q: How do I report bugs or request features? A: You can join my new discord server and contact me directly.
Q: Is there a wiki? A: Yes, on this page in the section "Links".
All Versions
+ Add Version
[1.5.6] Auction House Plugin 1.5.6
by ElaineQheart on Oct 12, 2026
Download
- added DiscordSRV support. That is, to send a message on discord whenever somebody creates a new auction. Direct Dependency: https://modrinth.com/plugin/interactivechat-discordsrv-addon. (That plugin in return has 3 more dependencies, including DiscordSRV). In order to set up the discord messages, you need a discord bot. DiscordSRV setup is expected. In the config file of DiscordSRV, you have to add a Channel called "auctionhouseElaineQheartNewAuctions" with your desired discord channel id. This name can even be customized (why would you need that? idk, the option exists) in the messages.yml file under "new-listing-channel-name". The discord message title too can be customized in the messages.yml file. On discord, the message itself is a cool item embed generated by the InteractiveChat-DiscordSRV-Addon plugin.
- Folia fix: The method to get the item name should now always work (i.e. fixed a console error message)
[1.5.5] Auction House Plugin 1.5.5
by ElaineQheart on Oct 12, 2026
Download
- added a bunch of scheduler fixes for Folia servers that shouldn't have any affect on other server loaders. If you still encounter _any_ bugs on Folia or if there are any error messages in the console, don't hesitate to report them to me.
- added the option to play a sound when a player creates an auction (found in layout.yml)
- added '/ah sell 7b' for billions of coins
[1.5.4] Auction House Plugin 1.5.4
by ElaineQheart on Oct 12, 2026
Download
- fixed an issue that was posed on github where sometimes when collecting a sold bid auction, it would throw an error and you would not receive any money
- put a space before the [CLICK] in the message in chat
- ended bid auctions (bid auctions that somebody bought) now show a message that they are ended at the bottom (as it has always been supposed to be)
- adventureAPIMessages now load correctly without a second server restart when updating the version of the plugin
[1.5.3] Auction House Plugin 1.5.3
by ElaineQheart on Oct 12, 2026
Download
- removed a System.out.println() from debugging oops
- fixed the latest issue on Github about the arrows to switch pages in the ah
[1.5.2] Auction House Plugin 1.5.2
by ElaineQheart on Oct 12, 2026
Download
- added a warning message when the tax is below 0% or equal to 100% and above
- when no vault provider is found, it doesn't throw a huge error anymore
- changes in the config.yml are now reloaded before everything else when /ah reload is used (use-adventure-text-minimessages for example changes the behaviour of other messages)
- relocating dependencies (this should have been done right from the start)
[1.5.1] Auction House Plugin 1.5.1
by ElaineQheart on Oct 12, 2026
Download
- fixed LayoutGenerator again. The BIN filter was missing. Made it so it automatically updates the layout.yml file when installing this or any future version of the plugin.
- added search support through chat for older minecraft versions. (The MenuType class was added in 1.21.1, which makes it possible to create an anvil GUI without using NMS)
- previously, if an item had a custom name that is not italic, it would still appear italic on item displays; fixed that.
- created a fallback method for getting an item name. This new method is used when the item name returns "Stone". This happens for example when using the RoseStacker plugin.
- fixed some chat messages where the item name would be coloured or the text after an item would take on the colour of the item
[1.5] Auction House Plugin 1.5
by ElaineQheart on Oct 12, 2026
Download
- added full Folia server support
- fixed a small mistake in the LayoutGenerator.java: The golden carrot for your bids wasn't included in the my-ah-layout (letter 'd'). If you installed the last version of this plugin as the first one on your server, make sure to delete the layout.yml file so it can update itself.
- changed the item display system to be more robust. (updating item displays immediately on reload or when a new one is spawned; removing the item immediately when one is removed; automatically converting any old displays to the new data system; deal with displays in unloaded chunks) If you encounter any issues, please report them.
- removed task loops when opening the ah. Switched to a delayed task that keeps calling itself until no player views the inventory anymore
- when inspecting a shulker or a bundle in the cancel auction menu, it should now take you back from where you came if you go back (i.e. your auctions or the main ah)
[1.4.10] Auction House Plugin 1.4.10
by ElaineQheart on Oct 12, 2026
Download
- [technical] switched base 64 encoder to java, because SnakeYAML removed its Base64Coder class since version 2.3
[1.4.9] Auction House Plugin 1.4.9
by ElaineQheart on Oct 12, 2026
Download
- added more stuff to be included in the log files other than item transactions:
- setting up an auction
- canceling an auction
- collecting an expired auction
- collecting an admin expired auction
- collecting an admin deleted auction
- a new log file is created when /ah reload is used; much like when the server is reloaded
- added actual item names to /ah search (for example "redstone repeater" instead of the item type which is "repeater")
- the item is now updating the time also in the cancelItemInventory
- tasks (updating items in real-time in the ah) now cancel themselves when no player is present. - In addition to when the inventory is closed (double check, because a task going on forever is fatal)
[1.4.8] Auction House Plugin 1.4.8
by ElaineQheart on Oct 12, 2026
Download
- added /ah search
- you can now have a list of aliases for /ah instead of just one
- Changed the sound system to the new NamespacedKey system for future minecraft versions
- fixed console errors for minecraft versions 1.21 and 1.21.1
[1.4.7] Auction House Plugin 1.4.7
by ElaineQheart on Oct 12, 2026
Download
- made it possible to reset the search without the need to right-click (when using geyser and bedrock version of minecraft). Just click on the paper on the left side of the anvil gui menu without typing anything
[1.4.6] Auction House Plugin 1.4.6
by ElaineQheart on Oct 12, 2026
Download
- fixed partial selling. It broke in version 1.4.4
- added maximum bid and bin price
- fixed issue with interacting with a paper item that is on the 3rd slot on the ah (when the layout was changed)
- fixed display item names being in capital letters bruh
- restructured parts of the codebase relating to operations that have to be saved persistently
- fixed a critical bug that led you duplicate items (redacted)
[1.4.5] Auction House Plugin 1.4.5
by ElaineQheart on Oct 12, 2026
Download
- bugfix: numbers over 1b were showed as 1e9 in the plugin version 1.4.4 instead of 1,000,000,000
- the ah now stays open when buying an item
- added a slightly different message as auction announcement to distinguish between BIN and BID auctions.
- fixed a small bug when updating from an old version of the plugin: it would always put the currency symbol before the number instead of copying the old setting of the config over to the messages.yml file
[1.4.4] Auction House Plugin 1.4.4
by ElaineQheart on Oct 12, 2026
Download
- fixed a typo in "ban-usage": It's supposed to be a § sign and not a $ sign.
- added PlaceholderAPI support (%auctionhouse_announcements% > "enabled" or "disabled" and %auctionhouse_active_auctions% > number of active auctions for the player)
- huge performance improvement by keeping the items that are on the ah in memory instead of deserializing them every time again
- made the item displays customizable (the tuff block, the signs and the glass)
- you can now put the currency symbol before the number in item displays
- the config.yml file now generates with comments, but only if the file doesn't exist yet
- added bundles view. Players can now look into bundles just like they can look into into shulkers
- fixed console showing an error message when reloading about the log file
- item displays are now only breakable when having the permission, being in creative mode and sneaking. A break-instruction message appears if you try to break the display while having the permission.
[1.4.3] Auction House Plugin 1.4.3
by ElaineQheart on Oct 12, 2026
Download
- added simple transaction logging [date, buyer, seller, item-name, amount, price, is-BID-auction]
- added [/ah help]
- auction master npc can't be picked up by using the [ClickVillagers plugin](https://modrinth.com/plugin/clickvillagers) anymore
- NPCs can't be removed by players who are only in creative mode anymore. You also need the moderator permission to do that.
- to summon a display, the surrounding blocks must now be air
- made the item displays more customizable in messages.yml
- added %price-trim% as a placeholder in the messages.yml file if you want to display "3.2K coins" instead of "3,200 coins"
- fixed an update problem from early versions of the plugin
[1.4.2] Auction House Plugin 1.4.2
by ElaineQheart on Oct 12, 2026
Download
- fixed miniMessages not working in item lore
- the maximum collect-sold-item value isn't capped at 21474836.47 coins anymore
- you can sell items now for more than 1 billion coins
- added support for multi-language item search through Locale-API (https://www.spigotmc.org/resources/api-locale-api.105038//api-locale-api.105038/). If installed, people can search item materials/enchantments in their own language that they have selected in their minecraft settings. **Subject to change** as I noticed that the plugin isn't updated anymore
[1.4.1] Auction House Plugin 1.4.1
by ElaineQheart on Oct 12, 2026
Download
the plugin should now also work in versions prior to 1.21.5
[1.4] Auction House Plugin 1.4
by ElaineQheart on Oct 12, 2026
Download
- added **BID Auctions** [/ah bid <amount>]
- minimum bin/bid price
- [/ah about]
- item_model and custom_model_data as further options to the blacklist
- you can now use %price% or %number% in the messages.yml file to specify if the currency symbol should be used in a message (please report messages I overlooked)
- the "Value with taxes: <number>" on the collect sold auction inventory now actually takes taxes into account
- optimized imports and removed unused dependencies
- made it possible to click your own items in the ah and cancel the auction that way
- restructured data files into a directory (dw, it automatically updates and moves the files)
- made the whole GUI data driven - **customizable layout** (change it in layout.yml)
- [/ah test saveitemtolayout.yml] to save the item in your main hand to the file, so you can have custom items (even with custom textures) in the auction house as buttons
- you can specify a decimal point now when you create an auction if you put a suffix like k or m: [/ah sell 1.2m]
- made all the sounds customizable in layout.yml
- the auction sort, order and BIN filter never reset, even if you close your inventory or the server reloads
- the pages number in the ah now starts from 1 and not 0
[1.3.9] Auction House Plugin 1.3.9
by ElaineQheart on Oct 12, 2026
Download
- added support for MiniMessages and Hex color coding. (adventure API) Notice that you can't have both the legacy color codes (§e) and the miniMessages (<yellow>text</yellow>) in the exact same string under messages.yml
- added auction announcements (can be disabled in the config) to send a message to all players who have it enabled when a new auction is set up (toggleable with "/ah announce")
- when an auction is sold while the player is offline and then rejoins (with auto collect enabled in the config) the player in the message in chat was the player itself and not the buyer's name; fixed that
- added a small delay to the sold message when a player joins, so the join messages comes after custom join messages
- made the color of the %price% configurable in messages.yml by moving the "currency:" option from the config.yml into there
- also moved "currency-before-number:", "format-numbers:" and "format-time-characters" from the config.yml into the messages.yml under "placeholders"
[1.3.8] Auction House Plugin 1.3.8
by ElaineQheart on Oct 12, 2026
Download
- fixed a duping glitch (how it worked: go to cancel an item, but stop on the confirmation inventory. Then another player buys that item. After that you cancel the auction and get the item too; same went for partially sold items)
- added the option to auto-collect purchased items - in the config.yml
- the arrows allowed to go to one more empty page if the first page was filled with items; fixed that
- made it possible to open a shulker box also when being in the inventory of your own auctions and int the item view inventory before the confirmation inventory
- when clicking in your inventory with the auction inventory open, the plugin doesn't think anymore that you're pressing the things in the auction
- small tweaks (like not playing a sound when clicking the arrows when the page isn't changed, adding the display-update in ticks to be customizable)
[1.3.7] Auction House Plugin 1.3.7
by ElaineQheart on Oct 12, 2026
Download
- added a setting in the config.yml to enable to choose the amount you want to buy ("partial-selling")
- fixed canceling or deleting an auction by a moderator with /ah admin (Why did nobody notice that it broke 6 updates ago??!)
- admins can expire or delete their own auctions now with /ah admin
- made the cancel button in the item-buy-confirm inventory take the player back to the ah instead of closing their inventory
- pressing cancel instead of confirm when buying an item takes the player back to the ah instead of closing their inventory
- the sorting, search and page are conserved when clicking on an item or going to your own auctions and going back; not reset anymore
[1.3.6] Auction House Plugin 1.3.6
by ElaineQheart on Oct 12, 2026
Download
in the last version (that isn't available anymore) there was a small issue, because the plugin had a different folder called SimpleAuctions (I thought about renaming the plugin, forgot about that) where it stored all the data and it appeared as though everything was deleted from the ah
### Changelog:
### Changelog:
- added a shulker box sound when viewing a shulker box in the ah
- if you search for items, also shulker boxes that contain that item will be listed
- made an option in config.yml to put the currency symbol before the number (it's now possible to make it $4 instead of 4$)
- /ah sell <price> <amount>
- added a blacklist (/ah blacklist add <contains_lore|exact|material|name_contains>)
- made the item in the displays update not only when the material changes, but when anything of the displayed item is different
[1.3.5] Auction House Plugin 1.3.5
by ElaineQheart on Oct 12, 2026
Download
- fixed a small typo in messages.yml (it will only update if you delete the file; then it's recreated) (npc-usage: "/ah summon npc facing <direcction>")
<summary>fixed an error message that sometimes showed up in the console:</summary>
java.lang.NullPointerException: Cannot invoke "org.bukkit.entity.Player.hasPermission(String)" because "player" is null
at AuctionHouse-1.3.4.jar/me.elaineqheart.auctionHouse.data.Permissions.getAuctionDuration(Permissions.java:28) ~[AuctionHouse-1.3.4.jar:?]
</details>
[1.3.4] Auction House Plugin 1.3.4
by ElaineQheart on Oct 12, 2026
Download
full release
![EssentialsC [1.20.6-26.3+ | Folia Support ]](uploads/icons/thumbs/essentialsc-1-20-6-26-3-folia-support_9ac85c4b_thumb.jpg){kind=icon}
