CrownEconomy
The best economy & auction house plugin for Paper 1.21.1
100% Customizable · Vault-Compatible · LuckPerms Support · Clean GUIs · Zero Bloat
Support Development
──────────────────────────────────────────
Join Our Community
discord.gg/cCUVWxcuAw
──────────────────────────────────────────
The best economy & auction house plugin for Paper 1.21.1
100% Customizable · Vault-Compatible · LuckPerms Support · Clean GUIs · Zero Bloat
Support Development
──────────────────────────────────────────
Join Our Community
discord.gg/cCUVWxcuAw
──────────────────────────────────────────
Why CrownEconomy?
- Best auction house plugin for Paper 1.21.1 — cleaner, faster, and more configurable than anything else
- 100% customizable — every GUI title, filler material, button icon, message, price limit, tax rate, and border element
Simple & lightweight — drop-in install, zero database setup required, fully running in under 5 minutes- Vault-compatible — works with EssentialsX, GemsEconomy, CMI, and every Vault economy plugin
- LuckPerms integration — give VIPs, MVPs, and donors more listing slots automatically via permissions
- ️ Offline seller payouts — sellers always get paid, even if they're offline when their item sells
- Modular architecture — enable or disable the AH module independently; more modules coming soon
- Reliable data saving — listings saved on every action and on shutdown, nothing is ever lost
- ️ Actively developed — Player Shops, Trading System, Bank Module, and Economy Stats on the roadmap
- Dedicated support — active Discord with fast responses and a growing community
──────────────────────────────────────────
️ Auction House Features️ GUI & Browsing
- 6-row browsing GUI — clean bordered layout, 28 listings per page, zero visual clutter
- 4 sort modes — Price: Low→High, Price: High→Low, Ending Soon, Newest First
- 8 category filters — Weapons, Armor, Tools, Resources, Food, Blocks, Misc, All
- Live chat search — players type a keyword and listings filter in real time, instantly
- Confirm purchase screen — full breakdown of item, price, tax, and seller before any money moves
- Configurable tax system — set any percentage cut taken from the seller on each sale
- Min & max price limits — prevent price dumping or price gouging with hard server-wide limits
- Per-rank listing slots — VIPs and donors automatically get more listing slots via LuckPerms
- Offline seller payouts — Vault balance credited the moment an item sells, online or not
- Material blacklist — permanently block any item or material from ever being listed
- My Listings panel — dedicated GUI for players to view and right-click cancel their own listings
- Expired item bin — unsold items auto-return on expiry; glowing alert button when items are waiting
- Configurable expiry duration — set exactly how long listings stay active before expiring
- Expired bin lifetime — control how long uncollected expired items wait before removal
- Listing data persistence — every listing saved on create, purchase, cancel, expiry, and shutdown
──────────────────────────────────────────
Compatibility| Integration |  Status | Notes |
| Vault |  Required | Economy bridge — balance, withdraw, deposit |
| Paper 1.21.1 | Compatible | Primary supported platform |
| Purpur | Compatible | Paper fork fully supported |
| Spigot/Bukkit | Compatible | Bukkit Supported |
| LuckPerms |  Recommended | Per-rank listing slot tiers |
| EssentialsX Economy | Full support | Via Vault |
| GemsEconomy | Full support | Via Vault |
| CMI Economy | Full support | Via Vault |
| Any Vault economy | Full support | If it hooks Vault, it works |
──────────────────────────────────────────
Configuration Overview100% customizable — nothing is hardcoded. Every value lives in config.yml.
Code:
auction-house:
enabled: true
gui-title: "&8» &bAuction House &8«"
listing:
min-price: 1.0
max-price: 1000000.0
default-duration: 48 # hours
tax-rate: 5.0 # % taken from seller on sale
return-expired: true
expired-bin-duration: 72 # hours items wait in bin
max-listings:
default: 5
vip: 10
mvp: 20
admin: 100- ️ Every GUI title, filler material, button icon, and border element
- Every player-facing message — full & color codes and {placeholders} throughout
- Min/max listing price, tax rate, listing duration, expired bin lifetime
- Per-rank listing limits via LuckPerms permissions
- Module toggles — enable or disable the AH independently
- Material blacklist — block any item by name, keep your economy clean
──────────────────────────────────────────
Commands| Command | Description | Permission |
| /ah | Open the Auction House | crowneconomy.ah.open |
| /ah sell <price> | List your held item for sale | crowneconomy.ah.sell |
| /ah search <query> | Search all active listings | crowneconomy.ah.search |
| /ah cancel <id> | Cancel one of your listings | crowneconomy.ah.cancel |
| /ce reload | Reload the plugin config | crowneconomy.reload |
| /ce version | Show plugin version & status | any player |
──────────────────────────────────────────
Permissions| Permission | Default | Description |
| crowneconomy.ah.open | true | Open the Auction House GUI |
| crowneconomy.ah.sell | true | List items for sale |
| crowneconomy.ah.bid | true | Purchase listings |
| crowneconomy.ah.cancel | true | Cancel own listings |
| crowneconomy.ah.cancel.others | op | Cancel any listing (staff) |
| crowneconomy.ah.search | true | Use live search |
| crowneconomy.ah.maxlistings.vip | false | VIP — 10 listing slots |
| crowneconomy.ah.maxlistings.mvp | false | MVP — 20 listing slots |
| crowneconomy.admin | op | Full admin + 100 slots |
| crowneconomy.reload | op | Reload config via command |
──────────────────────────────────────────
️ Installation
Up and running in under 5 minutes.- ️ Ensure you're running Paper 1.21.1 or a compatible fork (Purpur, etc.)
- Install Vault + a Vault economy plugin (EssentialsX Economy, GemsEconomy, CMI, etc.)
- (Recommended) Install LuckPerms for rank-based listing limits
- Drop CrownEconomy.jar into your /plugins/ folder
- Start or restart your server
Edit plugins/CrownEconomy/config.yml to your liking
Run /ce reload — you're live!
Reload note: /ce reload reloads all config values and resets the expiry scheduler. Active listing data is not affected.──────────────────────────────────────────
️ Data Storage- Saved on every listing create, purchase, cancel, and expiry
- Saved on every clean server shutdown
- Expired listings persist until the player collects them or expired-bin-duration elapses
- MySQL / SQLite database support planned for large network deployments
──────────────────────────────────────────
Roadmap| Module | Description | Status |
| ️ Auction House | Full-featured server marketplace | Released |
| Player Shop | Chest or GUI shops with auto-restock | Planned |
| Trading System | Secure face-to-face player trades | Planned |
| Bank System | Account interest, shared guild balances | Planned |
| Economy Stats | Server leaderboards, transaction history | Planned |
──────────────────────────────────────────
Perfect For- Survival servers — give players a real marketplace to trade resources
- SMP servers — the go-to economy layer for any multiplayer survival experience
Factions servers — control the economy with taxes, blacklists, and rank limits- RPG servers — fits naturally into any custom economy and progression system
- ️ Towny servers — player-driven markets with full Vault integration
- Donor-tier servers — reward VIPs and MVPs with more listing slots automatically
──────────────────────────────────────────
Support & Community- #support — get help with installation, config, and permissions
- #bug-reports — report issues with full details and get fast fixes
- #suggestions — suggest features and vote on the roadmap
- #announcements — be first to know about new releases and updates
When reporting a bug, please include:
- Your Paper version (/version)
- Your CrownEconomy version (/ce version)
- Any relevant errors from your server console
──────────────────────────────────────────
LicenseCrownEconomy is a premium resource. You may install and use it on your own servers. You may not redistribute, resell, decompile, or claim ownership of this plugin or its source code.
──────────────────────────────────────────
️ Built for Paper 1.21.1 · Requires Vault · Recommends LuckPerms · Compatible with EssentialsX, GemsEconomy, CMI, and all Vault economy plugins
️ Built for Paper 1.21.1 ·
Requires Vault · Recommends LuckPerms · Compatible with EssentialsX, GemsEconomy, CMI, and all Vault economy plugins
