DonutAuction v1.0

DonutAuction v1.0.0​

A full-featured auction house plugin for Paper 1.21.x servers.

---

Features​

• GUI-based auction house — browse, buy, and list items in a clean 54-slot interface
• Category filtering — filter by Blocks, Tools, Food, Combat, Potions, Books, Ingredients, or Utilities
• Sort options — sort by Highest Price, Lowest Price, or Recently Listed
• Anvil search — search listings by item name or seller name
• Shulker box preview — left-click any shulker box listing to preview its contents before buying
• Buy confirmation GUI — review price before committing to a purchase
• Sell confirmation GUI — set price and confirm before listing
• My Listings GUI — view and cancel your active listings
• Transaction history — per-player purchase and sale history
• Multi-economy support — Vault (any Vault-compatible economy) or PlayerPoints
• Listing fees & sell tax — configurable fees on listing and on sale
• Per-permission max listings — control how many items players can list simultaneously
• Discord webhooks — optional notifications for listings, purchases, and expirations
• Physical AH signs — right-click a [AuctionHouse] sign to open the GUI
• Sound effects — configurable sounds for open, click, buy, sell, and cancel actions
• Item blacklist — block specific materials from being listed
• Admin commands — reload, reload-economy, purge, block/unblock players, force-expire listings
• YAML persistence — listings, history, and blocked players survive restarts

---

Requirements​

---

Installation​

1. Drop DonutAuction-1.0.0.jar into your server's plugins/ folder.
2. Install Vault and a Vault-compatible economy plugin (e.g. EssentialsX, CMI).
3. Restart your server.
4. Configure plugins/DonutAuction/config.yml and messages.yml as needed.
5. Reload with /ah reload.

---

Commands​

---

Permissions​

---

Configuration — config.yml​

prefix: "&8[&bDonutAuction&8] &r"

gui:
main-title: "&8AUCTION SITE"
search-title: "Search"
filler-material: GRAY_STAINED_GLASS_PANE

item-display:
date-format: "dd/MM/yyyy HH:mm"
lore:
- "&7Seller: &f{seller}"
- "&7Price: &a{currency}{price}"
- "&7Listed: &f{date}"
- "&7Amount: &f{amount}"
- "{shulker_hint}"

auction:
listing-duration-hours: 48
blacklisted-items:
- BEDROCK
- BARRIER
allow-shulker-boxes: true
broadcast-purchases: true
broadcast-listings: false
max-listings-default: 5

economy:
provider: vault # vault | playerpoints
currency-symbol: "$"
min-price: 1.0
max-price: 1000000000.0
listing-fee: 0.0
sell-tax: 5.0 # percentage taken on sale

sounds:
enabled: true
gui-open:
sound: BLOCK_ANVIL_LAND
volume: 0.5
pitch: 1.8
gui-click:
sound: UI_BUTTON_CLICK
volume: 0.6
pitch: 1.0
purchase:
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 0.8
pitch: 1.0
sell:
sound: BLOCK_NOTE_BLOCK_PLING
volume: 0.8
pitch: 1.2
cancel:
sound: BLOCK_NOTE_BLOCK_BASS
volume: 0.6
pitch: 0.8

signs:
enabled: true
sign-trigger: "[AuctionHouse]"
sign-line2: "&6Auction"
sign-line3: "&eHouse"
sign-line4: ""

discord:
enabled: false
webhook-url: ""
events:
listing: true
purchase: true
expiry: false

---

GUI Navigation Bar​

The bottom row of the main GUI (left to right):

---

Category Filters​

---

AH Signs​

Place a sign with [AuctionHouse] on the first line (requires donutauction.admin). The sign auto-formats and players can right-click it to open the auction house.

---

Data Files​

All data auto-saves every 5 minutes and on server shutdown.

---

Expiry​

Listings that exceed auction.listing-duration-hours are automatically expired. The item is returned to the seller's inventory if they are online, or held until their next login. Expiry checks run every 5 minutes.

---

Discord Webhooks​

Set discord.enabled: true and provide a valid webhook-url. The plugin sends embed messages for new listings, purchases, and (optionally) expirations. Each event type can be toggled independently under discord.events.