Mineforgian
Auction House Plugin
Use /ah to open the auctionHouse.
- Загрузки
- 30K
- Подписчики
- 29
- Обновлён
- 6 июля 2026 г.
- Лицензия
- GPL-3.0-only
Опубликован 7 сентября 2025 г.
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
colour 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: White
layout.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 which you can tab-complete. To remove them, simply punch them while being in creative mode and being op on the server.
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.
Ченджлог
1.5.1Релиз26.1.1, 26.1.2, 26.2 · 6 июля 2026 г.
- 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Релиз26.1.1, 26.1.2, 26.2 · 25 июня 2026 г.
- 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Релиз26.1.1, 26.1.2, 26.2 · 21 июня 2026 г.
- [technical] switched base 64 encoder to java, because SnakeYAML removed its Base64Coder class since version 2.3
1.4.9Релиз26.1.1, 26.1.2, 26.2 · 20 июня 2026 г.
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Релиз26.1, 26.1.1, 26.1.2 · 13 июня 2026 г.
- 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Релиз26.1, 26.1.1, 26.1.2 · 7 мая 2026 г.
- 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Релиз1.21.9, 1.21.10, 1.21.11 · 26 апреля 2026 г.
- 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Релиз1.21.9, 1.21.10, 1.21.11 · 31 марта 2026 г.
- 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
Комментарии
Загружаем…