HomeJavaModsCrownEconomy - All In One | Multiverse Support
CrownEconomy - All In One | Multiverse Support
ModsJava

CrownEconomy - All In One | Multiverse Support

by FrostedGuy · on Modrinth

All-in-one economy plugin: GUI server shop, auction house, player chest shops, secure trading, banks with interest, and leaderboards. Works with or…

⬇ Download on Modrinth
CrownEconomy - All In One | Multiverse Support — screenshot 1CrownEconomy - All In One | Multiverse Support — screenshot 2

💰 CrownEconomy

The complete economy suite for Paper, Purpur, Spigot, and Bukkit servers. Server shop, auction house, player shops, secure trading, banking, and economy stats. Works with or without Vault. Stunning GUIs, 100% customizable.

Donate On Ko-fi

Paper Compatible Purpur Compatible Spigot / Bukkit Compatible

github hangar discord-plural

CrownEconomy is the all-in-one economy plugin for Paper, Purpur, Spigot, and Bukkit 1.21+ servers. One jar replaces your shop plugin, your auction plugin, your trade plugin, your bank plugin, and your economy plugin.

It also ships its own economy, so Vault is completely optional. No economy plugin installed? CrownEconomy handles balances itself and publishes them to Vault so the rest of your server can use them.

Every module can be switched on or off independently, so you can run the whole suite or only the parts you want.


🔍 Why CrownEconomy?


🪙 Economy: Vault Optional

CrownEconomy never forces you into a particular setup.

Setup What happens
Vault + an economy plugin CrownEconomy hooks the Vault economy and uses it everywhere
Vault, no economy plugin The built-in economy activates and registers itself with Vault, so other plugins work too
No Vault at all The built-in economy runs on its own, stored in balances.yml
economy:
  provider: AUTO          # AUTO / VAULT / INTERNAL
  internal:
    starting-balance: 100.0
    currency-name-singular: "Coin"
    currency-name-plural: "Coins"
    register-with-vault: true

Built-in economy commands:

/ce balance [player]
/ce pay <player> <amount>
/ce eco <give|take|set> <player> <amount>

/ce version shows exactly which provider is live.


🏪 Server Shop

A full EconomyShopGUI style admin shop, defined in shop.yml and open at /shop.

sections:
  ores:
    display-name: "&bOres"
    icon: DIAMOND
    slot: 12
    size: 54
    permission: ""
    items:
      diamond:
        material: DIAMOND
        amount: 1
        buy-price: 450.0
        sell-price: 120.0

🏛️ Auction House

The most polished, feature-rich, and player-friendly AH available for modern servers.

🖥️ GUI & Browsing

💸 Economy & Listings

📦 Listing Management


🛒 Player Shops

Player run shops at /pshop, as chest shops or GUI shops, with automatic restocking.


💱 Trading System

Secure, scam-proof, face-to-face trades. No chat commands mid-trade, no dropped items, no trust required.


🏦 Bank System

Interest-bearing accounts, shared team balances, and a clean deposit and withdraw GUI.


📊 Economy Stats

Server leaderboards and a complete transaction history across every module.


🎨 Modern GUI System

Every menu shares one design system, and every part of it is configurable in gui.yml.

settings:
  max-name-length: 32
  max-lore-lines: 5
  back-button:
    enabled: true
    slot: -1
    material: ARROW
    name: "&#FF6B6B<< Back"
    lore:
      - "&#6B7280Return"
  filler:
    enabled: true
    mode: BOTTOM_ROW
    item:
      material: GRAY_STAINED_GLASS_PANE
      name: "&8"
  sounds:
    enabled: true
    volume: 0.5
    open: ui.button.click
    click: ui.button.click
    success: entity.experience_orb.pickup
    error: block.note_block.bass

slot: -1 keeps the back arrow pinned to the bottom-left of whatever size the menu is. mode accepts BOTTOM_ROW, ALL, or NONE.

👤 Player head items

Any GUI item can become a head. Set the material and say whose head it is:

balance:
  slot: 49
  material: PLAYER_HEAD
  head-owner: self
  name: "&#FFFFFF{player}"
  lore:
    - "&#4ADE80{balance}"
    - "&#6B7280Sell rate &f{multiplier}x"

head-owner: self uses the viewer. A player name uses that player's skin. This is how the shop, bank, stats, and auction house balance buttons are built by default.


🌈 Message Formatting

Colors work the same way in messages.yml, gui.yml, and shop.yml.

Format Example Result
Legacy codes &a, &c, &l The classic 16 colors and styles
Hex &#4ADE80Balance Any RGB color
Hex, alternate <#4ADE80>Balance Same thing, MiniMessage style
Gradient <gradient:#7C5CFF:#5AC8FA>Shop</gradient> Smooth fade across the text
general:
  prefix: "&8[<gradient:#7C5CFF:#5AC8FA>Crown</gradient>&8] &r"
  hex-colors: true
  gradients: true

Both features can be switched off for servers on older clients, and everything falls back to legacy codes automatically.


🔤 PlaceholderAPI

Install PlaceholderAPI and the crowneconomy expansion registers automatically. No download, no /papi ecloud step.

Player placeholders

Placeholder Returns
%crowneconomy_balance% Formatted wallet balance
%crowneconomy_balance_raw% Raw wallet balance
%crowneconomy_bank_balance% Total balance of accounts they own
%crowneconomy_bank_balance_raw% Raw bank balance
%crowneconomy_bank_account% Currently selected account name
%crowneconomy_bank_interest% Lifetime interest earned
%crowneconomy_shops% Player shops they own
%crowneconomy_listings% Their active auction listings
%crowneconomy_sell_multiplier% Their server shop sell multiplier
%crowneconomy_stats_earned% Lifetime money earned
%crowneconomy_stats_spent% Lifetime money spent
%crowneconomy_stats_sold% Items sold
%crowneconomy_stats_bought% Items bought
%crowneconomy_stats_trades% Completed trades
%crowneconomy_stats_listings% Listings created
%crowneconomy_stats_transactions% Total tracked transactions

_raw variants exist for stats_earned and stats_spent too.

Server placeholders

Placeholder Returns
%crowneconomy_provider% Active economy provider
%crowneconomy_currency% Currency symbol
%crowneconomy_server_listings% Active auction listings
%crowneconomy_server_shops% Player shops on the server
%crowneconomy_server_sections% Server shop sections
%crowneconomy_server_shop_items% Server shop items
%crowneconomy_server_bank_total% Total money banked
%crowneconomy_server_accounts% Bank accounts
%crowneconomy_server_transactions% Total transactions
%crowneconomy_server_trades% Total trades
%crowneconomy_server_money_moved% Total money moved

Leaderboard placeholders

%crowneconomy_top_<category>_<position>_<field>%

Examples:

%crowneconomy_top_money-earned_1_name%
%crowneconomy_top_money-earned_1_value%
%crowneconomy_top_wallet-balance_3_name%
%crowneconomy_top_trades_5_raw%

%crowneconomy_leaderboard_..._..._...% works as an alias for the same thing.

🥇 AxLeaderboards and other leaderboard plugins

Leaderboard plugins that read PlaceholderAPI can display CrownEconomy boards directly. For AxLeaderboards, point a board type at the placeholder you want:

crown-richest:
  placeholder: "%crowneconomy_stats_earned_raw%"
  format: "#%place% %player% - %value%"

The same approach works for Featherboard, TAB, DecentHolograms, HolographicDisplays, ajLeaderboards, and anything else with PAPI support. If you prefer a ready-made board, the top_ placeholders above already return sorted names and values, so a hologram can be built without any extra plugin doing the sorting.


🔌 Dependencies

Required

That is the whole list. Everything below is optional.

Optional

vault luckperms placeholderapi yaml


🔌 Compatibility

🔧 Integration ✅ Status 📋 Notes
Paper 1.21+ Required Primary supported platform
Purpur ✅ Compatible Paper fork fully supported
Spigot / Bukkit 1.21+ ✅ Compatible Bukkit API supported
Vault ⭐ Optional Uses your economy, or publishes ours
LuckPerms ⭐ Optional Meta based limits and multipliers
PlaceholderAPI ⭐ Optional Auto-registered crowneconomy expansion
AxLeaderboards ✅ Supported Through PlaceholderAPI
Featherboard / TAB / DecentHolograms ✅ Supported Through PlaceholderAPI
Multiverse-Core ✅ Supported Multi-world auction house detection
EssentialsX Economy ✅ Full support Via Vault
GemsEconomy / CMI Economy ✅ Full support Via Vault
Any Vault economy ✅ Full support If it hooks Vault, it works

🔐 LuckPerms Integration

Limits and multipliers are read from LuckPerms meta first, then permission tiers, then the config defaults.

Meta key Controls
crowneconomy.listing-limit Auction house listing slots
crowneconomy.shop-limit Player shops a player may own
crowneconomy.sell-multiplier Server shop sell payout multiplier
lp group vip meta set crowneconomy.listing-limit 25
lp group vip meta set crowneconomy.sell-multiplier 1.5

No LuckPerms? Numeric permission tiers work with any permission plugin:

Permission Effect
crowneconomy.ah.maxlistings.25 25 auction listing slots
crowneconomy.shop.limit.5 5 player shops
crowneconomy.shop.multiplier.1_5 1.5x server shop sell payout

The highest matching tier always wins.


🌍 Multi-World & Multiverse Support

Fully integrated multi-world auction house system built for modern server networks.


⚙️ Configuration

100% customizable. Core values live in config.yml, the server shop catalogue in shop.yml, GUI layout in gui.yml, and all text in messages.yml.

economy:
  provider: AUTO
  internal:
    starting-balance: 100.0
    register-with-vault: true

auction-house:
  enabled: true
  mode: GLOBAL
  min-price: 1.0
  max-price: 1000000.0
  tax-rate: 5.0
  listing-limit-meta: "crowneconomy.listing-limit"

server-shop:
  enabled: true
  sell-tax-percent: 0.0
  default-sell-multiplier: 1.0
  sell-multiplier-permission: "crowneconomy.shop.multiplier"
  sell-multiplier-meta: "crowneconomy.sell-multiplier"
  allow-sell-all: true
  quantity-options: [1, 8, 16, 32, 64]

player-shops:
  enabled: true
  shop-limit-meta: "crowneconomy.shop-limit"
  max-items-per-shop: 27
  restock-interval-seconds: 30
  bulk-multiplier: 8
  container-materials: [CHEST, TRAPPED_CHEST, BARREL]

trading:
  enabled: true
  max-distance: 15.0
  request-timeout-seconds: 60
  money-step: 100.0

bank:
  enabled: true
  interest:
    enabled: true
    rate: 1.0
    interval-minutes: 60
    min-balance: 100.0
  shared-accounts:
    enabled: true
    creation-cost: 5000.0
    limit: 2

economy-stats:
  enabled: true
  max-history: 500
  leaderboard-size: 10

📋 Commands

🏪 Server Shop

💬 Command 📖 Description 🔐 Permission
/shop Open the server shop crowneconomy.shop.open
/shop <section> Jump straight to a section crowneconomy.shop.open
/shop sellall [section] Sell everything sellable crowneconomy.shop.sell
/shop reload Reload shop.yml crowneconomy.shop.admin
/sell Sell the item in your hand crowneconomy.shop.sell
/sell all [section] Sell your inventory crowneconomy.shop.sell

🏛️ Auction House

💬 Command 📖 Description 🔐 Permission
/ah Open the Auction House crowneconomy.ah.open
/ah sell <price> List your held item crowneconomy.ah.sell
/ah search <query> Search all listings crowneconomy.ah.search
/ah mylistings View your own listings crowneconomy.ah.open
/ah cancel <id> Cancel one of your listings crowneconomy.ah.cancel
/ah refresh Refresh the open menu crowneconomy.ah.open

🛒 Player Shops

💬 Command 📖 Description 🔐 Permission
/pshop Browse every open player shop crowneconomy.shop.use
/pshop create <name> Open a new shop crowneconomy.shop.create
/pshop mine Manage your own shops crowneconomy.shop.use
/pshop add <buy> [sell] List the item in your hand crowneconomy.shop.use
/pshop link / /pshop unlink Link or unlink a container crowneconomy.shop.use
/pshop restock Pull stock from the container crowneconomy.shop.use
/pshop toggle Open or close the shop crowneconomy.shop.use
/pshop delete Delete a shop and reclaim stock crowneconomy.shop.use

💱 Trading

💬 Command 📖 Description 🔐 Permission
/trade <player> Send a trade request crowneconomy.trade.use
/trade accept [player] Accept a request crowneconomy.trade.use
/trade deny [player] Deny a request crowneconomy.trade.use
/trade cancel Cancel the current trade crowneconomy.trade.use
/trade list Show pending requests crowneconomy.trade.use

🏦 Bank

💬 Command 📖 Description 🔐 Permission
/bank Open the bank GUI crowneconomy.bank.use
/bank balance Bank and wallet balance crowneconomy.bank.use
/bank deposit <amount|all> Move money into the bank crowneconomy.bank.use
/bank withdraw <amount|all> Take money out crowneconomy.bank.use
/bank accounts Switch between accounts crowneconomy.bank.use
/bank create <name> Open a shared account crowneconomy.bank.use
/bank invite <player> Invite a member crowneconomy.bank.use
/bank accept [name] Join a shared account crowneconomy.bank.use
/bank interest Force an interest payout crowneconomy.bank.admin

📊 Economy Stats

💬 Command 📖 Description 🔐 Permission
/ecostats Open the stats menu crowneconomy.stats.use
/ecostats top [category] Show a leaderboard crowneconomy.stats.use
/ecostats player [name] Show player totals crowneconomy.stats.use
/ecostats history Server transaction history crowneconomy.stats.use
/baltop Wallet balance leaderboard crowneconomy.stats.use

⚙️ Plugin & Economy

💬 Command 📖 Description 🔐 Permission
/ce Show CrownEconomy help (any player)
/ce balance [player] Check a balance crowneconomy.balance
/ce pay <player> <amount> Send money crowneconomy.pay
/ce eco <give|take|set> <player> <amount> Manage balances crowneconomy.admin
/ce reload Reload configuration crowneconomy.reload
/ce version Version, economy, and permission status (any player)

Aliases: /servershop · /gshop · /sellitem · /auctionhouse · /playershop · /myshop · /tr · /banking · /cbank · /ceconomy · /economystats · /estats · /baltop


🔐 Permissions

🔑 Permission 👤 Default 📋 Description
crowneconomy.shop.open true Open the server shop
crowneconomy.shop.buy true Buy from the server shop
crowneconomy.shop.sell true Sell to the server shop
crowneconomy.shop.use true Browse, buy from, and manage player shops
crowneconomy.shop.create true Create player shops
crowneconomy.shop.admin op Reload the shop, break any shop container
crowneconomy.ah.open true Open the Auction House GUI
crowneconomy.ah.sell true List items for sale
crowneconomy.ah.bid true Buy listings
crowneconomy.ah.cancel true Cancel own listings
crowneconomy.ah.cancel.others op Cancel any listing
crowneconomy.ah.search true Use live search
crowneconomy.trade.use true Send and accept trade requests
crowneconomy.bank.use true Use bank accounts
crowneconomy.bank.admin op Force interest payouts
crowneconomy.stats.use true View stats and leaderboards
crowneconomy.balance true Check balances
crowneconomy.pay true Pay other players
crowneconomy.admin op Full admin access including economy management
crowneconomy.reload op Reload config via command
crowneconomy.refresh op Refresh plugin state

Numeric tiers such as crowneconomy.ah.maxlistings.25, crowneconomy.shop.limit.5, and crowneconomy.shop.multiplier.1_5 are also supported.


🛠️ Installation

⏱️ Up and running in under 5 minutes.

  1. 🖥️ Ensure you're running Paper, Purpur, Spigot, or Bukkit 1.21+ or a compatible fork
  2. 📂 Drop CrownEconomy.jar into your /plugins/ folder
  3. 🔄 Start or restart your server
  4. 🏦 (Optional) Install Vault and an economy plugin, or let CrownEconomy be your economy
  5. 🔐 (Optional) Install LuckPerms for meta driven limits and multipliers
  6. 🔤 (Optional) Install PlaceholderAPI for placeholders and leaderboards
  7. ✏️ Edit config.yml, shop.yml, gui.yml, and messages.yml to your liking
  8. ▶️ Use /ce reload to apply changes, or /shop reload for shop edits

⚠️ Reload note: open menus and active trades are closed safely, and no listing, shop, bank, or stats data is wiped. Changing economy.provider needs a full restart.


🗂️ Data Storage

📁 File 📋 Contents
shop.yml Server shop sections, items, and prices
auction-houses/ Listings, transactions, and pending returns per scope
shops.yml Player shops, items, prices, stock, and container links
bank.yml Bank accounts, balances, members, and interest totals
stats.yml Player stats and the server transaction history
balances.yml Built-in economy balances, when it is the active provider

🚧 Roadmap

🔮 Module 📋 Description 🚦 Status
🏪 Server Shop Section based admin shop with quantity screen ✅ Released
🏛️ Auction House Full-featured server marketplace ✅ Released
🛒 Player Shop Chest or GUI shops with auto-restock ✅ Released
💱 Trading System Secure face-to-face player trades ✅ Released
🏦 Bank System Account interest, shared balances ✅ Released
📊 Economy Stats Server leaderboards, transaction history ✅ Released
🪙 Built-in Economy Works with or without Vault ✅ Released
🔤 PlaceholderAPI Balances, stats, and leaderboards ✅ Released
🎨 Modern GUI System Hex colors, heads, back arrows, sounds ✅ Released
🗄️ SQL Storage Optional MySQL / SQLite backend 🔄 Planned
🔨 Bidding Auctions Timed bidding alongside instant buy 🔄 Planned
💹 Dynamic Pricing Shop prices that react to supply and demand 🔄 Planned

🎯 Perfect For


💬 Support & Community

🙋 Need help? Have a suggestion? Join the Discord.

👉 Join our Discord - discord.gg/cCUVWxcuAw

🐛 Bug Reports

When reporting a bug, please include:


📜 License

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.


🏗️ Built for Paper, Purpur, Spigot, and Bukkit 1.21+ · 🪙 Works with or without Vault · ⭐ Supports LuckPerms and PlaceholderAPI · 🥇 Feeds AxLeaderboards and any PAPI leaderboard

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more