CrownEconomy - AuctionHouse+ | Multiverse Support

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.

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.

• Server Shop - section based admin shop with a quantity screen, sell hand, and sell all
• Auction House - the full player marketplace
• Player Shops - chest or GUI shops with auto-restock
• Trading System - secure face-to-face player trades
• Bank System - interest, shared balances, member management
• Economy Stats - server leaderboards and transaction history

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?

• Six modules, one jar - shop, auction house, player shops, trading, bank, and stats sharing the same config, GUI, and message files
• Modern GUI system - hex and gradient colors, player head balance buttons, a back arrow on every screen, short readable tooltips, and menu sounds
• Works with or without Vault - use any Vault economy, or let CrownEconomy be your economy
• 100% customizable - every GUI title, size, slot, filler, sound, icon, message, price, tax, limit, and timer
• LuckPerms aware - limits and sell multipliers from LuckPerms meta, with permission tiers as a fallback
• PlaceholderAPI ready - balances, bank, stats, shops, and full leaderboard placeholders
• Leaderboard plugin friendly - AxLeaderboards, Featherboard, TAB, and any PAPI based plugin can read the built-in boards
• Offline payouts - sellers and shop owners always get paid, even when they are offline
• Safe by design - trades roll back on failure, shop containers are protected, and every module validates before money moves
• Reliable data saving - everything saves on an interval, off the main thread, and on shutdown
• Dedicated support - active Discord with fast responses and a growing community

---

🪙 Economy: Vault Optional

CrownEconomy never forces you into a particular setup.

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.

• Modern layout - gradient title, glass bottom bar, your player head showing your live balance and sell multiplier, and a back arrow in the bottom-left
• Section menu - browse categories such as Blocks, Ores, Farming, Food, Mob Drops, Redstone, Decoration, Tools, Brewing, and Misc
• Ten ready-made sections - a complete priced catalogue ships out of the box, edit or replace anything
• Buy and sell prices - every item can be buy only, sell only, or both
• Quantity screen - middle-click any item for a +1 / +8 / +16 / +32 / +64 amount selector with live prices
• Fast clicks - left click buys one, shift-left buys a stack, right click sells one, shift-right sells everything you carry
• Sell hand and sell all - /sell and /sell all, plus a Sell Inventory button in the GUI
• Per-section permissions - lock a section behind any permission node
• Sell multipliers - reward ranks with higher payouts through LuckPerms meta or permission tiers
• Sell tax - optional server cut on every sale
• Custom slots - pin sections and items to exact slots, or leave it blank for automatic paging
• Live reload - /shop reload applies shop.yml changes without a restart

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

• Clean centered browsing GUI - readable layout with no clutter
• Configurable listing slots - fully controlled from gui.yml
• 4 sort modes - Low -> High, High -> Low, Soon -> New, New -> Soon
• Category filters - All, Weapons, Armor, Tools, Resources, Food, and Blocks
• Live search - search by item name, seller name, or material with a chat-free sign prompt
• Confirm purchase screen - full breakdown of item, price, tax, and seller before any money moves

💸 Economy & Listings

• Configurable tax system - set any percentage cut taken from the seller on each sale
• Min & max price limits - prevent price dumping or price gouging
• Global AH cap - limit how many active listings can exist at once
• Per-rank listing slots - through permissions or LuckPerms meta
• Offline seller payouts - balance credited the moment an item sells, online or not
• Material blacklist - permanently block any item from being listed
• Permanent or timed listings - set duration to 0 for permanent listings

📦 Listing Management

• My Listings panel - view and right-click cancel your own listings
• Transactions GUI - listed, purchased, sold, cancelled, and expired activity with totals
• Expired item handling - unsold items auto-return on expiry
• Listing data persistence - saved on create, purchase, cancel, expiry, and shutdown

---

🛒 Player Shops

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

• Chest shops - link a chest, trapped chest, or barrel and players right-click it to open the shop
• GUI shops - no build required, every open shop is listed inside /pshop
• Auto-restock - stock flows from the linked container on a configurable interval
• Per-item restock toggle and an instant Restock button
• Bundle pricing - list "16 iron ingots for $100" by holding a stack of 16 when you add it
• Bulk clicks - shift-click multiplies the amount by a configurable multiplier
• Owner funds check - players can only sell to a shop when the owner can actually pay
• Per-rank shop limits - permissions or LuckPerms meta
• Container protection - linked containers cannot be broken or blown up by anyone but the owner
• Safe deletion - deleting a shop returns all stored stock to the owner

---

💱 Trading System

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

• Split trade window - your half on the left, theirs on the right, shared live between both players
• Request flow - /trade <player>, then /trade accept, with configurable request expiry
• Money offers - add coins with click, shift-click, and middle-click steps
• Confirmation reset - any change to items or money instantly clears both confirmations
• Atomic execution - money and items only move once both sides confirm, and every transfer is checked first
• Automatic rollback - closing the window, disconnecting, or walking away returns everything
• Distance and timeout checks - abandoned or out-of-range trades clean themselves up
• Inventory space check - a trade never completes into a full inventory

---

🏦 Bank System

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

• Personal vault - every player gets an account automatically
• Shared accounts - invite members for towns, factions, guilds, or friends
• Member management - invite, accept, kick, and leave, with a configurable member cap
• Scheduled interest - configurable rate, interval, minimum balance, payout cap, and online-only mode
• Live countdown - the GUI shows the next payout timer and lifetime interest earned
• One-click amounts - configurable deposit and withdraw buttons plus deposit all and withdraw all
• Optional fees and max balance - keep the economy in check
• Admin payout - force a payout at any time with /bank interest

---

📊 Economy Stats

Server leaderboards and a complete transaction history across every module.

• 10 leaderboards - money earned, money spent, items sold, items bought, auction sales, shop sales, trades, bank interest, bank balance, and wallet balance
• Player heads - ranked entries rendered with real player skins
• /baltop built in - the wallet balance leaderboard, ready out of the box
• Server overview - tracked players, transactions, trades, money moved, listings, shops, and total banked
• Personal stats - every player can see their own lifetime totals
• Transaction history - server-wide log of shop sales, auction sales, trades, deposits, withdrawals, and interest
• Mine / everyone filter - switch the history between the whole server and just your own activity

---

🎨 Modern GUI System

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

• Back arrow on every screen - always the bottom-left slot, always the same look, one config block controls all of them
• Your head, your balance - the balance button in the shop, bank, auction house, and stats menus is your own player head
• Short, readable text - two to four line tooltips instead of walls of lore, with hard limits so no line ever overflows
• Hex and gradient colors - titles and items use real RGB, not just the 16 legacy codes
• Glass bottom bar - a filler row frames the controls, or fill the whole menu, or turn it off
• Menu sounds - open, click, success, and error sounds with per-event pitch
• Every slot configurable - move or hide any button, resize any menu, repoint any item grid

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.

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

_raw variants exist for stats_earned and stats_spent too.

Server placeholders

Leaderboard placeholders

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

• category - money-earned, money-spent, items-sold, items-bought, auction-sales, shop-sales, trades, bank-interest, bank-balance, wallet-balance
• position - 1, 2, 3, ...
• field - name, value (formatted), raw, uuid

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

• Paper, Purpur, Spigot, or Bukkit 1.21+ or a compatible fork

That is the whole list. Everything below is optional.

Optional

• Vault plus any Vault economy - to share balances with the rest of your plugins
• LuckPerms - meta driven limits and sell multipliers
• PlaceholderAPI - placeholders and leaderboard integration
• Multiverse-Core - multi-world auction house detection

---

🔌 Compatibility

---

🔐 LuckPerms Integration

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

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:

The highest matching tier always wins.

---

🌍 Multi-World & Multiverse Support

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

• Full support for Multiverse-Core, with automatic world context detection
• Global - one shared auction house across all worlds
• Per-world - each world gets its own independent auction house
• Grouped - link worlds so world, world_nether, and world_the_end share one market while spawn stays separate
• Enable or disable the auction house per world, all from config.yml

---

⚙️ 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: