# PlayerAuctions<\/p>\n
PlayerAuctions is a modern and feature-rich auction house plugin for PaperMC servers. It provides a robust, intuitive, and scalable platform for players to buy and sell items, fully integrated with Vault-based economies and PlaceholderAPI.<\/p>\n
<\/p>\n
## \u2728 Overview<\/p>\n
**PlayerAuctions** provides a robust, intuitive, and scalable platform for players to buy and sell items securely. Fully integrated with Vault-based economies and the latest Paper 1.21 API, PlayerAuctions brings a premium marketplace experience to your server.<\/p>\n
**What’s new in v3.1.0?**
\n– **Mailbox Integration**: Canceled auctions and sold item revenues are securely routed to the player’s personal mailbox, solving inventory management issues!
\n– **Cloud Command Framework (CCF)**: Extremely reliable, zero-latency commands with intelligent Tab Completions.
\n– **Adventure MiniMessage**: 100% native MiniMessage GUI item formatting including Hex, Gradients, and auto-italic removal.
\n– **Strictly Paper 1.21**: Dropped legacy version support for maximum performance and zero bloat.<\/p>\n
## \ud83d\ude80 Core Features<\/p>\n
### \ud83d\udcec Mailbox System (NEW)
\nNo more dropped items when a player’s inventory is full!
\n– **Canceled Listing Recovery**: Canceling an active auction routes the item safely into the Mailbox.
\n– **Revenue Deposit Receipts**: Sold items send a “Revenue Notification” to the seller’s Mailbox. Claiming it deposits the Vault money\u2014acting as a satisfying transaction receipt.
\n– **Expiration Protection**: Items automatically expire after a configurable duration (default: 30 days).<\/p>\n
### \ud83d\udce2 Global Broadcast Notifications
\n– Keep the economy active! Broadcasts when items are listed and bought.
\n– **Clickable Links**: Click “View Auction” right in chat.
\n– **Configurable Range**: Broadcast to GLOBAL, WORLD, or NONE.<\/p>\n
### \ud83c\udfa8 Premium GUI Interface
\n– **Native MiniMessage**: Fully supports Hex RGB colors and gradients for borders, titles, and formats.
\n– **Smart Category Filtering**: Quickly jump between categories like Blocks, Tools, Weapons, etc.
\n– **Dynamic Sorting**: Sort auctions by Price (Ascending\/Descending), Time Left, and Newest.
\n– **Search Engine**: In-game robust search to filter active items.<\/p>\n
### \ud83d\udee1\ufe0f Secure Transactions
\n– **Atomic Locking**: Prevents duplicate purchase exploits (race conditions) using optimistic database locking.
\n– **Persistent JSON Storage**: Lightweight, concurrent-safe flat-file storage with auto-backups on writes.<\/p>\n
—<\/p>\n
## \u2328\ufe0f Commands & Permissions<\/p>\n
> **Command Aliases**: `\/ah`, `\/auction`, `\/auctionhouse`<\/p>\n
| Command | Description | Permission | Default | **Admin Permissions** —<\/p>\n ## \ud83d\udd27 Configuration Guide<\/p>\n PlayerAuctions is highly modular. Check your `config.yml` to customize the experience:<\/p>\n “`yaml broadcast: mailbox: ### \ud83d\udcac Placeholders (PlaceholderAPI) —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Ensure your server is running **Paper 1.21+**. ## \ud83e\udd1d Support & Issues<\/p>\n Developed by **MinekartaStudio**. PlayerAuctions is a modern and feature-rich auction house plugin.<\/p>\n","protected":false},"featured_media":122626,"template":"","meta":{"_minecraft_slug":"playerauctions","_minecraft_project_id":"Mp3J39aH","_minecraft_author":"MinekartaStudio","_minecraft_license":"MIT","_minecraft_downloads":2931,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerauctions.zip","_minecraft_size_bytes":44687712,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-16T05:14:44.202569Z","_minecraft_date_created":"2025-10-28T05:20:37.030489Z","_minecraft_date_modified":"2026-02-24T21:25:57.036233Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerauctions","_minecraft_icon_attachment_id":122626,"_minecraft_imported_at":"2026-06-07T05:02:42+00:00","_minecraft_import_hash":"db8e838652b75b1840ac487d734e7aa6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-122625","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|—|
\n| `\/ah` | Opens the main Auction House GUI | `playerauctions.use` | `true` |
\n| `\/ah sell
\n| `\/ah myauctions` | View and manage your current listings | `playerauctions.use` | `true` |
\n| `\/ah mailbox` | Open your Mailbox to claim money and items | `playerauctions.use` | `true` |
\n| `\/ah search
\n| `\/ah categories` | Browse items by predefined categories | `playerauctions.categories` | `true` |
\n| `\/ah history [player]` | View your (or others’) transaction history | `playerauctions.history(.others)` | `true` (`op`) |
\n| `\/ah notify
\n| `\/ah reload` | Reload configuration files | `playerauctions.reload` | `op` |<\/p>\n
\n– `playerauctions.admin` – Grants all administrative commands and bypasses.<\/p>\n
\nauction:
\n max-auctions-per-player: 5
\n tax-percentage: 5.0 # Removes 5% from all successful sales<\/p>\n
\n enabled: true
\n on-listing: true
\n on-purchase: true
\n range: GLOBAL # GLOBAL, WORLD, NONE<\/p>\n
\n enabled: true
\n retention-days: 30 # Days before Mailbox items auto-expire
\n“`<\/p>\n
\nIntegrate statistics into your scoreboard or tablist!
\n– `%playerauctions_total_auctions%` – Tracks globally active auctions.
\n– `%playerauctions_player_listings%` – Tracks the viewer’s active listing count.<\/p>\n
\n2. Install **Vault** and an economy provider (e.g., EssentialsX).
\n3. Drop `PlayerAuctions-3.1.0.jar` into your `plugins\/` folder.
\n4. Restart the server.
\n5. *(Optional)* Modify `config.yml` and `messages.yml` using standard `
\nFound a bug or need support? Please reach out via our GitHub repository issues tab or our Discord server.<\/p>\n","protected":false},"excerpt":{"rendered":"