!apxauction

🛒 ApxAuction — Modern & Dupe-Proof Auction House

ApxAuction is an advanced, production-ready player marketplace and Auction House plugin designed for Paper and Spigot 1.20+ servers. Engineered for extreme reliability, zero duplication exploits, and seamless performance without main-thread lag.

---

✨ Features

• 🎨 Modern & Intuitive GUI System

  • Fully customizable menus via YAML (main-gui, confirm-purchase, confirm-listing, my-items, history).
  • Dynamic pagination, category filters, and live search bar.
  • Real-time sorting by price, date, and name.

• 📦 In-GUI Shulker Box Preview

  • Players can safely inspect the contents of any Shulker Box directly inside the auction menu without taking items.

• 🛡️ 100% Dupe & Exploit Protected

  • Atomic Locking: Strict race-condition protection prevents double-buying or transaction race bugs.
  • Exploit Prevention: Blocks shift-click, off-hand swap (F), and hotbar number key glitches.
  • Full Inventory Safety: If a buyer's inventory is full, purchased items are automatically preserved in /ah expired (Claim Storage).

• ⚡ High-Speed Async Storage

  • Built on an asynchronous SQLite engine to prevent server TPS drops.
  • Automatic & Manual Backups: Protect your market data with built-in backup tools (/ahadmin backup).
  • Safe Item Serialization: Preserves 100% of custom NBT, CustomModelData, trims, enchants, and lore.

• 💰 Economy & Vault Support

  • Configurable flat fees and percentage-based listing fees.
  • Customizable sales tax deducted on successful sales.
  • Full offline seller payout handling.

• 🧩 PlaceholderAPI Ready
  • Native placeholders for player stats, active listings, balance, and limits.

---

📋 Commands & Permissions

👤 Player Commands

Command	Description	Permission
/ah	Open the main Auction House menu	apxauctions.use
/ah sell <price>	List the item in your hand for sale	apxauctions.sell
/ah search <query>	Search for specific items in the market	apxauctions.search
/ah expired	View and claim expired / unclaimed items	apxauctions.expired
/ah history	View your transaction history & stats	apxauctions.history
/ah help	Show help menu	apxauctions.use

👑 Admin Commands

Command	Description	Permission
/ahadmin reload	Reload configuration files and GUIs	apxauctions.admin
/ahadmin backup	Create a manual database backup	apxauctions.admin
/ahadmin remove <id>	Cancel an auction & return item to seller	apxauctions.admin
/ahadmin removeplayer <name>	Cancel all active listings of a player	apxauctions.admin
/ahadmin database	View database cache metrics	apxauctions.admin

---

⚙️ Requirements & Compatibility

• Server Software: Paper, Purpur, Spigot, or compatible forks
• Minecraft Version: 1.20+ (1.20 – 1.20.4+)
• Java Version: Java 17 or higher
• Dependencies:
  • Vault (Required)
  • PlaceholderAPI (Optional)

---

🚀 Quick Installation

1. Download ApxAuction-1.0.0.jar.
2. Make sure Vault and an economy provider (e.g., EssentialsX) are installed.
3. Place ApxAuction-1.0.0.jar into your server's plugins/ directory.
4. Restart your server.
5. Enjoy your modern, dupe-safe auction house!