DonutSMP Auction House (ah) [Advanced]

🏛️ Auction House & Economy System

Bring a complete, server-ready Auction House and Economy System to your Bedrock world! Inspired by popular Donut-style multiplayer servers, this addon features interactive Chest UIs, offline item sales, transaction history, and powerful admin moderation tools.

---

⭐ Key Features

• 🛒 Chest UI Browse Menu: Smooth 54-slot chest interface featuring sorting, filtering, and instant search.
• 💰 Offline Earnings Payout: Sellers receive earned coins automatically upon logging back in if their item sells while offline.
• 🔒 Offline Protection & Grace Period: Expired listings are moved to your Your Items tab and safely stored for up to 90 days.
• 🔍 Smart Search & Filters: Search listings by item name, seller username, or price caps (e.g. 5k). Filter by categories like Blocks, Tools, Combat, Potions, Food, and more!
• 📊 Transaction History & Lifetime Stats: Keep track of your purchases, sales, total earnings, and total spending over a 90-day period.
• 💸 Shared Wallet Infrastructure: Built-in economy compatibility designed to work seamlessly across compatible shop and order market modules.
• 🛠️ Interactive Admin Config Hub (/config): Manage sales tax, listing fees, maximum active listings, blacklisted items, and currency display in real time without editing files.

---

🎮 How to Play

Player Commands

Command	Description	Example
/ah	Opens the main Auction House browse menu.	/ah
/ah sell <price>	Sell the item held in your main hand. Supports k, m, b, t.	/ah sell 25k
/ah sell	Opens the confirm screen to manually set a price via menu buttons.	/ah sell
!ah sell <1-999>	Chat Shortcut: Fast list low-value items directly from chat.	!ah sell 100
/ah search [term]	Filter listings by keyword, seller name, or max budget.	/ah search diamond
/pay <player> <amount>	Transfer coins directly to another online player.	/pay Steve 1.5k
/ah help	Views the in-game command cheat-sheet.	/ah help

Number Suffixes Cheat Sheet

Suffix	Value	Example	Total
k	Thousand	15.5k	15,500
m	Million	2m	2,000,000
b	Billion	1.5b	1,500,000,000
t	Trillion	1t	1,000,000,000,000

---

🛡️ Admin & Server Settings

Giving Admin Access

To manage economy balances or modify auction settings in-game, give yourself the admin tag:

/tag @s add admin

Admin Commands

• Open Configuration Hub: /config
• Check Balance: /money get <player>
• Modify Money: /money <set|add|remove> <player> <amount> (e.g. /money add Steve 50k)

Customizable Auction Settings (/config)

• Listing Fees & Sale Tax: Charge an upfront fee (0%–50%) or deduct sales tax upon purchase.
• Max Active Listings: Set how many items a player can list simultaneously (Default: 26).
• Listing Duration: Set listing expiration timers (Default: 72 hours).
• Item Blacklist: Restrict items such as bedrock, barriers, or command blocks from being sold.

---

⚙️ Installation Instructions

1. Download the .mcaddon file and open it to import both the Behavior Pack (BP) and Resource Pack (RP) into Minecraft.
2. Apply both packs to your world settings.
3. CRITICAL REQUIREMENT: Enable Beta APIs under the Experiments toggle in your World Settings.
4. Join your world, give yourself admin privileges via /tag @s add admin, and start selling!

---

🌟 Support Creator

If you enjoy using this addon, please consider leaving a ⭐ Star / Endorse on CurseForge to help the project grow!

💬 Join the Community: Have feedback, questions, or need help troubleshooting? Join our Discord Server!