# \ud83d\udcb0 CrownEconomy<\/p>\n
> **The best economy plugin for Paper, Purpur, Spigot, and Bukkit servers.** Premium auction house, stunning GUIs, 100% customizable. Built for survival, SMP, factions, and RPG servers.<\/p>\n
  <\/p>\n
  <\/p>\n
**CrownEconomy** is the best economy plugin and best auction house plugin for Paper, Purpur, Spigot, and Bukkit 1.21.1 servers. If you’re looking for a simple, powerful, and 100% customizable economy suite that your players will actually enjoy, you’ve found it.<\/p>\n
Clean bordered GUIs. Instant feedback. Smart expiry handling. Deep configuration. **Vault-compatible** out of the box. No bloat, no ugly menus, no compromises.<\/p>\n
Supports Paper, Purpur, Spigot, and Bukkit 1.21.1+.<\/p>\n
Whether you’re building a survival economy, an SMP marketplace, or a full RPG server, **CrownEconomy** is the last economy plugin you’ll ever need.<\/p>\n
***<\/p>\n
## \ud83d\udd0d Why CrownEconomy?<\/p>\n
Every other auction house plugin for modern Minecraft servers either looks outdated, barely configures, or breaks under load. CrownEconomy was built from scratch to be the definitive, modern answer to server economy:<\/p>\n
* \ud83c\udfc6 **Best auction house plugin** for Paper, Purpur, Spigot, and Bukkit 1.21.1, cleaner, faster, and more configurable than anything else
\n* \ud83c\udfa8 **100% customizable** – every GUI title, filler material, button icon, message, price limit, tax rate, and border element
\n* \u26a1 **Simple & lightweight** – drop-in install, zero database setup required, fully running in under 5 minutes
\n* \ud83c\udfe6 **Vault-compatible** – seamless integration with EssentialsX, GemsEconomy, CMI, and every Vault economy plugin
\n* \ud83d\udd10 **LuckPerms integration** – give VIPs, MVPs, and donors more listing slots automatically via permissions
\n* \ud83d\udee1\ufe0f **Offline seller payouts** – sellers always get paid, even if they’re offline when their item sells
\n* \ud83d\udce6 **Configurable market flow** – clean browsing, categories, search, my listings, and transactions history
\n* \ud83d\udcbe **Reliable data saving** – listings and player transactions are saved automatically, so nothing is lost
\n* \ud83d\uddfa\ufe0f **Actively developed** – built to grow with more economy features over time
\n* \ud83d\udcac **Dedicated support** – active Discord with fast responses and a growing community<\/p>\n
***<\/p>\n
## \ud83c\udfdb\ufe0f Auction House Features<\/p>\n
> The most polished, feature-rich, and player-friendly AH plugin available for 1.21.1 servers.<\/p>\n
### \ud83d\udda5\ufe0f GUI & Browsing<\/p>\n
* **Clean centered browsing GUI** – readable layout with no clutter
\n* **Configurable listing slots** – fully controlled from `gui.yml`
\n* **4 sort modes** – Low -> High, High -> Low, Soon -> New, New -> Soon
\n* **Category filters** – All, Weapons, Armor, Tools, Resources, Food, and Blocks
\n* **Live search** – search by item name, seller name, or material
\n* **Confirm purchase screen** – full breakdown of item, price, tax, and seller before any money moves
\n* **Refresh support** – refresh the current menu without reopening the whole flow<\/p>\n
### \ud83d\udcb8 Economy & Listings<\/p>\n
* **Configurable tax system** – set any percentage cut taken from the seller on each sale
\n* **Min & max price limits** – prevent price dumping or price gouging with hard server-wide limits
\n* **Global AH cap** – limit how many active listings can exist at once
\n* **Per-rank listing slots** – VIPs and donors automatically get more listing slots via permissions
\n* **Offline seller payouts** – Vault balance credited the moment an item sells, online or not
\n* **Material blacklist** – permanently block any item or material from ever being listed
\n* **Permanent or timed listings** – set duration to `0` for permanent listings<\/p>\n
### \ud83d\udce6 Listing Management<\/p>\n
* **My Listings panel** – dedicated GUI for players to view and right-click cancel their own listings
\n* **Transactions GUI** – track listed, purchased, sold, cancelled, and expired activity
\n* **Transaction stats** – see total sold worth and total bought worth
\n* **Expired item handling** – unsold items auto-return on expiry
\n* **Configurable expiry duration** – set exactly how long listings stay active before expiring
\n* **Listing data persistence** – every listing saved on create, purchase, cancel, expiry, and shutdown<\/p>\n
***<\/p>\n
## \ud83d\udd0c Dependencies<\/p>\n
### Required<\/p>\n
* **Paper, Purpur, Spigot, or Bukkit 1.21.1** or a compatible fork
\n* **Vault**
\n* **A Vault-compatible economy plugin**<\/p>\n
### Recommended<\/p>\n
* **LuckPerms** for rank-based listing limits and permission tiers<\/p>\n
### Compatible With<\/p>\n
* EssentialsX Economy
\n* GemsEconomy
\n* CMI Economy
\n* Any other Vault-compatible economy plugin<\/p>\n
  <\/p>\n
***<\/p>\n
## \ud83d\udd0c Compatibility<\/p>\n
| \ud83d\udd27 Integration |\u2705 Status |\ud83d\udccb Notes | > \u26a0\ufe0f **Required:** Vault + any Vault-compatible economy plugin ***<\/p>\n ## \ud83c\udf0d Multi-World & Multiverse Support (NEW)<\/p>\n > Fully integrated multi-world auction house system built for modern server networks.<\/p>\n ### \ud83c\udf10 Multiverse Integration<\/p>\n * \u2705 Full support for **Multiverse-Core** ### \ud83d\uddfa\ufe0f Auction House Modes<\/p>\n * **Global Auction House** ### \ud83d\udd17 World Grouping System<\/p>\n * Create custom world groups inside config ### \u2699\ufe0f Configuration Control<\/p>\n * Enable \/ disable AH per world ***<\/p>\n ## \u2699\ufe0f Improvements (Latest Update)<\/p>\n * Improved backend handling for **multi-world environments** ***<\/p>\n ## \ud83d\udee0\ufe0f Fixes (Latest Update)<\/p>\n * Fixed auctions not syncing correctly between worlds ## \u2699\ufe0f Configuration<\/p>\n > 100% customizable – nothing is hardcoded. Core values live in `config.yml`, GUI layout lives in `gui.yml`, and all text lives in `messages.yml`.<\/p>\n “` auction-house: listing-limits: ### \ud83c\udfa8 What You Can Customize<\/p>\n * \ud83d\uddbc\ufe0f Every **GUI title, filler material, button icon, slot, and border element** ***<\/p>\n ## \ud83d\udccb Commands<\/p>\n | \ud83d\udcac Command |\ud83d\udcd6 Description |\ud83d\udd10 Permission | **Aliases:** `\/auctionhouse` \u00b7 `\/ceconomy` \u00b7 `\/ce`<\/p>\n ***<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | \ud83d\udd11 Permission |\ud83d\udc64 Default |\ud83d\udccb Description | ***<\/p>\n ## \ud83d\udee0\ufe0f Installation<\/p>\n > \u23f1\ufe0f Up and running in under 5 minutes.<\/p>\n 1. \ud83d\udda5\ufe0f Ensure you’re running **Paper, Purpur, Spigot, or Bukkit 1.21.1** or a compatible fork > \u26a0\ufe0f **Reload note:** `\/ce reload` reloads configuration and refreshes the plugin state. Active listing data is **not** wiped.<\/p>\n ***<\/p>\n ## \ud83d\uddc2\ufe0f Data Storage<\/p>\n > \ud83d\udcbe Your listings are always safe – CrownEconomy saves on every action.<\/p>\n * \u2705 Saved on every listing **create**, **purchase**, **cancel**, and **expiry** ***<\/p>\n ## \ud83d\udea7 Roadmap<\/p>\n > CrownEconomy is just getting started. The full economy suite is on the way.<\/p>\n | \ud83d\udd2e Module |\ud83d\udccb Description |\ud83d\udea6 Status | ***<\/p>\n ## \ud83c\udfaf Perfect For<\/p>\n * \ud83c\udf32 **Survival servers** – give players a real marketplace to trade resources ***<\/p>\n ## \ud83d\udcac Support & Community<\/p>\n > \ud83d\ude4b Need help? Have a suggestion? Join the Discord.<\/p>\n **\ud83d\udc49 Join our Discord – discord.gg\/cCUVWxcuAw**<\/p>\n * \ud83d\udcac **#support** – get help with installation, config, and permissions ### \ud83d\udc1b Bug Reports<\/p>\n When reporting a bug, please include:<\/p>\n * \ud83d\udcc4 Your server version (`\/version`) ***<\/p>\n ## \ud83d\udcdc License<\/p>\n CrownEconomy 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.<\/p>\n ***<\/p>\n _\ud83c\udfd7\ufe0f Built for Paper, Purpur, Spigot, and Bukkit 1.21.1 \u00b7 \u26a0\ufe0f Requires Vault \u00b7 \u2b50 Recommends LuckPerms \u00b7 \u2705 Compatible with EssentialsX, GemsEconomy, CMI, and all Vault economy plugins_<\/p>\n","protected":false},"excerpt":{"rendered":" CrownEconomy is a premium economy suite for Paper 1.21.1, starting with a fully-featured Auction House \u2014 clean GUIs, live search, category filters, tax system, and deep configuration included. Built to grow, with Shop, Trading, and Bank modules planned.<\/p>\n","protected":false},"featured_media":51668,"template":"","meta":{"_minecraft_slug":"crowneconomy","_minecraft_project_id":"Ib6qg9ZH","_minecraft_author":"FrostedGuy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":106,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"crowneconomy.zip","_minecraft_size_bytes":404015,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:44:47.821086Z","_minecraft_date_created":"2026-04-11T03:21:47.773843Z","_minecraft_date_modified":"2026-04-17T10:47:24.218944Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/crowneconomy","_minecraft_icon_attachment_id":51668,"_minecraft_imported_at":"2026-06-02T19:52:22+00:00","_minecraft_import_hash":"aadde9a1baeb3a6eeb6e2404a4a0050b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,85,127,128,867,129,91],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-51667","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-food","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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| Vault<\/strong> |\u2705 Required<\/strong> |Economy bridge for balance, withdraw, and deposit |
\n| Paper 1.21.1<\/strong> |\u2705 Required<\/strong> |Primary supported platform |
\n| Purpur<\/strong> |\u2705 Compatible |Paper fork fully supported |
\n| Spigot 1.21.1<\/strong> |\u2705 Compatible |Bukkit\/Spigot API supported |
\n| Bukkit 1.21.1<\/strong> |\u2705 Compatible |Bukkit API supported |
\n| LuckPerms<\/strong> |\u2b50 Recommended |Per-rank listing slot tiers |
\n| EssentialsX Economy<\/strong> |\u2705 Full support |Via Vault |
\n| GemsEconomy<\/strong> |\u2705 Full support |Via Vault |
\n| CMI Economy<\/strong> |\u2705 Full support |Via Vault |
\n| Any Vault economy<\/strong> |\u2705 Full support |If it hooks Vault, it works |<\/p>\n
\n> \u2b50 **Recommended:** LuckPerms for per-rank listing tiers<\/p>\n
\n* Works seamlessly across multiple worlds
\n* Automatically detects world context for listings and browsing<\/p>\n
\n * One shared AH across all worlds
\n* **Per-World Auction Houses**
\n * Each world has its own independent AH
\n* **Group-Based Auction Houses (NEW)**
\n * Link multiple worlds to share the same AH<\/p>\n
\n* Example:
\n * `world`, `world_nether`, `world_the_end` \u2192 share one Auction House
\n * `spawn` \u2192 separate Auction House
\n* Full flexibility for:
\n * Survival clusters
\n * Lobby vs gameplay separation
\n * Game-mode specific economies<\/p>\n
\n* Assign worlds to groups easily
\n* Switch between:
\n * Global
\n * Per-world
\n * Group-based modes
\n* Fully configurable inside `config.yml`<\/p>\n
\n* Optimized **auction syncing across worlds and groups**
\n* Better performance in **large multi-server setups**
\n* Cleaner and more scalable **configuration structure**<\/p>\n
\n* Resolved GUI inconsistencies in multi-world setups
\n* General bug fixes and stability improvements<\/p>\n
\ngeneral:
\n prefix: “&8[&bCrown &3Economy&8] &r”
\n currency-symbol: “$”
\n decimal-places: 2<\/p>\n
\n enabled: true
\n max-auction-house-listings: 0
\n max-transaction-history: 0
\n min-price: 1.0
\n max-price: 1000000.0
\n default-duration-hours: 0
\n max-duration-hours: 168
\n tax-rate: 5.0
\n auto-save-seconds: 60
\n expiry-check-seconds: 60
\n return-check-seconds: 60<\/p>\n
\n – permission: “crowneconomy.admin”
\n limit: 100
\n – permission: “crowneconomy.ah.maxlistings.mvp”
\n limit: 20
\n – permission: “crowneconomy.ah.maxlistings.vip”
\n limit: 10
\n – permission: “default”
\n limit: 5
\n“`<\/p>\n
\n* \ud83d\udcac Every **player-facing message** – full `&` color codes and `{placeholders}` throughout
\n* \ud83d\udcb0 **Min\/max listing price**, **tax rate**, **listing duration**, **global listing cap**, **transaction history cap**
\n* \ud83c\udfc5 **Per-rank listing limits** via permissions
\n* \ud83d\udd18 **Module toggles** – enable or disable the AH independently
\n* \ud83d\udeab **Material blacklist** – block any item by name, keep your economy clean
\n* \ud83c\udff7\ufe0f **Prefix and currency formatting** – customize the default branding and money display<\/p>\n
\n| —————— |—————————- |———————- |
\n| \/ah<\/code> |Open the Auction House |crowneconomy.ah.open<\/code> |
\n| \/ah help<\/code> |Show AH help |(any player)<\/em> |
\n| \/ah sell <price><\/code> |List your held item for sale |crowneconomy.ah.sell<\/code> |
\n| \/ah search <query><\/code> |Search all active listings |crowneconomy.ah.search<\/code> |
\n| \/ah mylistings<\/code> |View your own listings |crowneconomy.ah.open<\/code> |
\n| \/ah cancel <id><\/code> |Cancel one of your listings |crowneconomy.ah.cancel<\/code> |
\n| \/ah refresh<\/code> |Refresh the open menu |crowneconomy.ah.open<\/code> |
\n| \/ce<\/code> |Show CrownEconomy help |(any player)<\/em> |
\n| \/ce help<\/code> |Show the command help |(any player)<\/em> |
\n| \/ce reload<\/code> |Reload the plugin config |crowneconomy.reload<\/code> |
\n| \/ce refresh<\/code> |Refresh the plugin |crowneconomy.refresh<\/code> |
\n| \/ce version<\/code> |Show plugin version & status |(any player)<\/em> |<\/p>\n
\n| ——————————- |———- |—————————– |
\n| crowneconomy.ah.open<\/code> |true<\/code> |Open the Auction House GUI |
\n| crowneconomy.ah.sell<\/code> |true<\/code> |List items for sale |
\n| crowneconomy.ah.bid<\/code> |true<\/code> |Purchase listings |
\n| crowneconomy.ah.cancel<\/code> |true<\/code> |Cancel own listings |
\n| crowneconomy.ah.cancel.others<\/code> |op<\/code> |Cancel any listing (staff) |
\n| crowneconomy.ah.search<\/code> |true<\/code> |Use live search |
\n| crowneconomy.ah.maxlistings.vip<\/code> |false<\/code> |VIP – 10 listing slots |
\n| crowneconomy.ah.maxlistings.mvp<\/code> |false<\/code> |MVP – 20 listing slots |
\n| crowneconomy.admin<\/code> |op<\/code> |Full admin access + 100 slots |
\n| crowneconomy.reload<\/code> |op<\/code> |Reload config via command |
\n| crowneconomy.refresh<\/code> |op<\/code> |Refresh plugin state |<\/p>\n
\n2. \ud83c\udfe6 Install **Vault** and a Vault economy plugin such as EssentialsX Economy, GemsEconomy, or CMI Economy
\n3. \ud83d\udd10 _(Recommended)_ Install **LuckPerms** for rank-based listing limits
\n4. \ud83d\udcc2 Drop `CrownEconomy.jar` into your `\/plugins\/` folder
\n5. \ud83d\udd04 Start or restart your server
\n6. \u270f\ufe0f Edit `plugins\/CrownEconomy\/config.yml`, `gui.yml`, and `messages.yml` to your liking
\n7. \u25b6\ufe0f Use `\/ce reload` or `\/ce refresh` to apply changes<\/p>\n
\n* \u2705 Saved on every clean **server shutdown**
\n* \u2705 Persisted in `plugins\/CrownEconomy\/auction-data.yml`
\n* \u2705 Auto-save, expiry checks, and return checks run in the background
\n* \ud83d\udccc No database setup required<\/p>\n
\n| —————– |—————————————- |———- |
\n| \ud83c\udfdb\ufe0f Auction House<\/strong> |Full-featured server marketplace |\u2705 Released |
\n| \ud83d\uded2 Player Shop<\/strong> |Chest or GUI shops with auto-restock |\ud83d\udd04 Planned |
\n| \ud83d\udcb1 Trading System<\/strong> |Secure face-to-face player trades |\ud83d\udd04 Planned |
\n| \ud83c\udfe6 Bank System<\/strong> |Account interest, shared balances |\ud83d\udd04 Planned |
\n| \ud83d\udcca Economy Stats<\/strong> |Server leaderboards, transaction history |\ud83d\udd04 Planned |<\/p>\n
\n* \ud83d\udc65 **SMP servers** – the go-to economy layer for any multiplayer survival experience
\n* \u2694\ufe0f **Factions servers** – control the economy with taxes, blacklists, and rank limits
\n* \ud83e\uddd9 **RPG servers** – fits naturally into any custom economy and progression system
\n* \ud83c\udfd9\ufe0f **Towny servers** – player-driven markets with full Vault integration
\n* \ud83d\udc8e **Donor-tier servers** – reward VIPs and MVPs with more listing slots automatically<\/p>\n
\n* \ud83d\udc1b **#bug-reports** – report issues with full details and get fast fixes
\n* \ud83d\udca1 **#suggestions** – suggest features and vote on the roadmap
\n* \ud83d\udce2 **#announcements** – be first to know about new releases and updates<\/p>\n
\n* \ud83d\udd22 Your CrownEconomy version (`\/ce version`)
\n* \ud83d\udccb Any relevant errors from your server console<\/p>\n