Wiki Page for Alpha‐1.0.0

VIP-Auctions Wiki

Auction house plugin by VIP Plugins for Paper, Folia, and ShreddedPaper.

Current release: Alpha-1.0.0
Minecraft: 1.21.11
Java: 21

Quick start

1. Put AuctionHouse-Alpha-1.0.0.jar in your server plugins folder.
2. Optional: install Vault and an economy plugin.
3. Restart the server.
4. Edit plugins/AuctionHouse/config.yml if needed.
5. Run /auction reload.

If Vault is missing, the plugin uses internal balances. Use /auction eco give <player> <amount> to add money.

Player commands

Command	What it does
/auction or /ah	Open the auction house
/auction sell <price>	List the item in your hand as Buy Now
/auction bid <starting>	List the item in your hand for bidding
/auction search <query>	Search listings
/auction listings	Your listings (shift-click to cancel)
/auction collect	Collect expired, cancelled, or won items
/auction eco balance	Check your balance
/auction help	Command list

Listings last 24 hours.

Staff commands

Command	What it does
/auction connect buy	Pair a sign and item frame as a Buy booth
/auction connect bid	Pair a sign and item frame as a Bid booth
/auction disconnect	Unpair a booth
/auction reload	Reload config (does not wipe live listings)
/auction eco give/take/set <player> <amount>	Internal balances only

How to make a booth

1. Place a sign.
2. Place an item frame next to it or above it.
3. Run /auction connect buy or /auction connect bid.
4. Left-click the sign, then left-click the item frame (either order).

Buy booths show Buy Now listings. Bid booths show auctions. Each listing only appears on one booth at a time.

To remove a booth, run /auction disconnect and left-click the sign or frame.

GUI

• Hopper button: sort by All, Blocks, Tools, Combat, Food, Redstone, Misc
• Dropper button: filter All, Buy, or Bid
• Chest: your listings
• Ender chest: collect items
• Click a listing to buy or bid (confirm screen)
• Shift-click your own listing to cancel it

Permissions

Players can use, sell, buy, bid, and collect by default.

Permission	Default
auctionhouse.use	everyone
auctionhouse.sell	everyone
auctionhouse.buy	everyone
auctionhouse.bid	everyone
auctionhouse.collect	everyone
auctionhouse.connect	op
auctionhouse.disconnect	op
auctionhouse.reload	op
auctionhouse.eco	op
auctionhouse.admin	op

Economy

Set economy.mode in config.yml:

• vault — Vault economy, or internal if Vault is not installed
• internal — plugin balances (/auction eco)
• item — pay with the item in economy.currency-item

Need help?

Open an issue on the VIP-Auctions GitHub.