• bStats metrics (plugin ID 33523), disable with metrics.enabled: false
• Store tags: Paper, Folia, Purpur, Spigot, and Bukkit for Minecraft 1.20.1–26.2
• Modrinth update check always reports on load (console + online admins): up to date or update available
• Admins with donutauction.update.notify still see update notices on join when a newer release exists
• Chat search uses Bukkit AsyncPlayerChatEvent; scheduler falls back when region schedulers are absent

DonutAuctionHouse v1.3.1

New Features

• None

Improvements

• Full messages.yml translation support for GUI titles, button labels, lore, chat messages, command text, and status labels
• /ah reload now reloads messages.yml alongside config.yml
• Prefix and minimum-price messages can live in messages.yml (legacy config.yml keys still work)

Bug Fixes

• None

Configuration

• New messages.yml — edit and /ah reload to translate the plugin without recompiling
• Existing config.yml messages.prefix and messages.price-below-min remain supported as fallbacks

Compatibility

• Drop-in update from 1.3.0
• Folia-supported unchanged
• No database migration required
• No command or permission changes

Upgrade Notes

1. Replace the jar with DonutAuctionHouse-1.3.1.jar
2. Restart the server (or /ah reload after first start to generate messages.yml)
3. Edit plugins/DonutAuctionHouse/messages.yml to translate player-facing text

DonutAuctionHouse v1.3.0

New Features

• Sell from auction GUI — emerald "Sell Held Item" button on the main auction house (slot 45) lists the item in your main hand
• Adjustable sell price — use +/- buttons in the sell GUI before confirming a listing

Improvements

• Sell GUI enlarged to 45 slots with confirm/cancel on the bottom row (slots 40 and 44)
• Confirm purchase GUI enlarged to 45 slots with a gray border, centered item preview, and buyer balance display
• Sell flow logic shared between /ah sell and the auction GUI button
• Maven publish workflow supports target/ jars with Paper/Folia/Bukkit loader tags

Bug Fixes

• Fixed sell GUI confirm/cancel buttons overlapping duration and category controls
• Fixed item duplication when closing and reopening the sell menu during duration/category/price changes
• Pending sale is no longer cancelled when the sell GUI refreshes itself

Configuration

• None

Compatibility

• Drop-in update from 1.2.2
• Requires Vault or VaultUnlocked plus an economy plugin
• Folia-supported remains enabled
• No database migration required
• No permission changes

Upgrade Notes

1. Install DonutAuctionHouse-1.3.0.jar (replace 1.2.2)
2. Restart the server
3. Open /ah and use the emerald button or /ah sell <price> to list items from your hand

Improvements

• Economy bridge detection now supports VaultUnlocked in addition to classic Vault
• Clearer startup logs when a Vault-compatible Economy service is linked or missing
• Soft-disables cleanly when no Economy provider is registered instead of throwing on enable

Bug Fixes

• Fixed Folia / VaultUnlocked servers failing to load DonutAuctionHouse with “Vault isn’t on the server”
• Removed hard depend: Vault so the plugin can enable when only VaultUnlocked is installed

Improvements

• Sell confirmation now uses atomic pending-sale transactions with unique IDs so an item is owned by only one state at a time (inventory, pending sale, or active auction)
• Confirm, cancel, inventory close, disconnect, and shutdown recovery are idempotent against double-clicks, lag, and repeated callbacks
• Cancel and collect actions on existing auctions use operation locks to prevent double item returns
• Failed listing validation now safely restores the item (with ground drop if the inventory is full)
• Added sampled debug logging for invalid/repeated pending-sale claims (debug.pending-sales)

Bug Fixes

• Fixed item duplication when cancelling /ah sell confirmation (Cancel, GUI close, duration/category re-open, double-click, or disconnect could return the item more than once)
• Pending sell items are now returned correctly on player quit and server shutdown

Configuration

• debug.pending-sales (default: false) — when true, logs every invalid/repeated pending-sale claim; when false, samples only

Quality of Life & Marketplace Expansion Update

Feature 1 — Permission-Based Auction Limits

Configurable permission-based auction limits with highest-permission-wins resolution.

New permissions:

• donutauction.limit.5 (default: true)
• donutauction.limit.10
• donutauction.limit.25
• donutauction.limit.50
• donutauction.limit.100
• donutauction.limit.unlimited (-1)

New command: /ah limit — displays your current limit, active listings, and remaining slots.

Config:

auction-limits:
  enabled: true
  default-limit: 5
  permissions:
    donutauction.limit.10: 10
    donutauction.limit.25: 25
    donutauction.limit.50: 50
    donutauction.limit.100: 100
    donutauction.limit.unlimited: -1

Feature 2 — Preserve Original Item Lore

New configurable lore system that preserves original item lore from custom item plugins.

Lore modes:

• APPEND — Adds auction info below existing lore (default)
• REPLACE — Replaces lore entirely (legacy behavior)
• DISABLED — Does not modify lore at all

Config:

auction-lore:
  mode: APPEND
  separator: true

Compatible with: MMOItems, Oraxen, ItemsAdder, EcoItems, ExecutableItems, MythicMobs, and any custom item plugin using ItemMeta/NBT.

Feature 3 — Fast Buy System

Instant purchase mode that skips the confirmation GUI.

New permission: donutauction.fastbuy

New command: /ah fastbuy — toggles fast buy mode.

Config:

fast-buy:
  enabled: true
  default-state: false
  require-permission: true

Behavior:

• Normal: Click item → Confirm Purchase → Purchase Complete
• Fast Buy: Click item → Purchase Complete
• Setting persists across reconnects and server restarts.

Feature 4 — Fast Sell System

Instant listing mode that uses stored settings.

New permission: donutauction.fastsell

New command: /ah fastsell — toggles fast sell mode.

Config:

fast-sell:
  enabled: true
  default-state: false
  require-permission: true

Behavior:

• Normal: /ah sell <price> → Sell GUI for duration/category selection
• Fast Sell: /ah sell <price> → Listed immediately using last settings
• Automatically remembers last duration, category, and price.

Feature 5 — Shulker Box Support

Full shulker box support with content preview.

Config:

shulker-support:
  enabled: true
  preview-contents: true

Features:

• Preserves all contents, NBT, names, lore, enchantments, colors, and custom metadata.
• Right-click any shulker box in the auction to preview its contents.
• Read-only preview GUI prevents extraction while listed.
• No duplication exploits.

Feature 6 — Modrinth Update Checker

Modern update checker using the Modrinth API.

Config:

update-checker:
  enabled: true
  notify-console: true
  notify-admins: true
  check-interval-hours: 12

New permission: donutauction.update.notify

Behavior:

• Checks asynchronously, never blocks startup.
• Caches results, handles rate limits and API downtime.
• Notifies console on enable if update available.
• Notifies admins on join if update available.

Feature 7 — Auction Slot Expansion

Additional monetization-friendly slot permissions.

New permissions:

• donutauction.slots.10
• donutauction.slots.25
• donutauction.slots.50
• donutauction.slots.100

Config:

auction-slots:
  enabled: true
  permissions:
    donutauction.slots.10: 10
    donutauction.slots.25: 25
    donutauction.slots.50: 50
    donutauction.slots.100: 100

Performance Improvements

• All database operations now use the plugin's named async executor instead of the default ForkJoinPool.
• Operation lock cleanup prevents memory leaks from accumulated auction locks.
• Fire-and-forget DB updates now include exception logging.
• Search performance optimized with cached plain-text names.

Security & Stability Fixes

• CRITICAL: Fixed item duplication exploit where server crash during purchase could duplicate items.
• CRITICAL: Fixed item duplication exploit where server crash during cancellation could duplicate items.
• CRITICAL: Fixed item duplication exploit where server crash during item collection could duplicate items.
• All inventory/economy actions now happen after database persistence succeeds.
• Failed purchases now refund money automatically.
• Failed cancellations now restore auction state automatically.
• Failed collections now restore auction state automatically.

New Permissions Summary

New Commands Summary

Migration Notes from 1.1.0 → 1.2.0

• Existing configs are safely updated with new defaults on startup.
• A new player_preferences table is created automatically for fast buy/sell settings.
• Existing donutcore.* permissions continue to work alongside new donutauction.* permissions.
• Existing auction data is fully compatible — no data migration required.
• The lore system defaults to APPEND mode. Set to REPLACE to preserve 1.1.0 behavior.

Minimum Auction Price

A new configurable minimum listing price has been added to reduce auction spam.

New config options

auction:
  min-price: 10

messages:
  price-below-min: '&cMinimum auction price is &6%min_price%&c.'

• Greatly reduced file size.