Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for FrostedGuy

The best Minecraft economy & auction house plugin for Paper 1.21.1 — 100% customizable, Vault-

Report CrownEconomy?

R

3.0.0

Changelog

3.0.0 - The Economy Suite Update

CrownEconomy is no longer just an auction house. This release turns it into a full economy suite: a server shop, player shops, secure trading, banking, and leaderboards, all in one jar, with a rebuilt modern GUI system and its own economy so Vault is now optional.

Added

Server Shop - a section based admin shop at /shop, defined in the new shop.yml

  • 10 ready-made sections and around 100 priced items out of the box
  • Quantity screen with +1 / +8 / +16 / +32 / +64 selectors and live pricing
  • Left click buys, shift-left buys a stack, right click sells, shift-right sells everything you carry
  • /sell and /sell all, plus a Sell Inventory button
  • Per-section permissions, sell tax, and rank based sell multipliers
  • /shop reload applies catalogue changes without a restart

Player Shops - chest and virtual shops at /pshop

  • Link a chest, trapped chest, or barrel and players right-click it to buy
  • Automatic restocking from the linked container on a configurable interval
  • Buy and sell prices, bundle pricing, bulk shift-clicks, per-rank shop limits
  • Linked containers are protected from breaking and explosions

Trading - secure face-to-face trades at /trade

  • Shared split window, money offers, confirmation reset on any change
  • Atomic execution with balance and inventory space checks
  • Automatic rollback on close, disconnect, distance, or timeout

Bank - personal and shared accounts at /bank

  • Scheduled interest with rate, interval, minimum balance, and payout cap
  • Shared accounts with invites, kicks, and member caps
  • Deposit and withdraw buttons plus /bank deposit all and /bank withdraw all

Economy Stats - leaderboards and history at /ecostats

  • 10 leaderboards including a built-in /baltop, rendered with real player heads
  • Server-wide transaction history with a mine/everyone filter
  • Lifetime per-player stats fed by every module

Built-in economy - Vault is now optional

  • economy.provider accepts AUTO, VAULT, or INTERNAL
  • With Vault installed but no economy plugin, CrownEconomy registers itself as the Vault provider
  • New /ce balance, /ce pay, and /ce eco give|take|set commands

PlaceholderAPI - the crowneconomy expansion registers automatically

  • Balance, bank, shop, auction, and lifetime stat placeholders
  • Leaderboard placeholders: %crowneconomy_top_<category>_<position>_<name|value|raw|uuid>%
  • Works with AxLeaderboards, ajLeaderboards, Featherboard, TAB, and DecentHolograms

LuckPerms integration

  • Meta driven limits and multipliers: crowneconomy.listing-limit, crowneconomy.shop-limit, crowneconomy.sell-multiplier
  • Numeric permission tiers as a fallback for any permission plugin, for example crowneconomy.shop.limit.5

Modern GUI system

  • Hex and gradient colors in every message and menu: &#4ADE80, <#4ADE80>, <gradient:#7C5CFF:#5AC8FA>text</gradient>
  • Player head balance buttons across the shop, auction house, bank, and stats menus
  • A back arrow in the bottom-left of every screen, driven by one config block
  • Glass filler bar, menu sounds with per-event pitch, and configurable text limits
  • New settings block in gui.yml for back button, filler, sounds, and text limits

Changed

  • /shop now opens the server shop. Player shops moved to /pshop
  • Vault changed from a required dependency to a soft dependency
  • gui.yml rebuilt with a new bottom-bar layout, shorter tooltips, and the settings block
  • messages.yml recolored to the new palette, with new sections for every module
  • Auction house search, my listings, transactions, categories, and confirm screens now share the same back arrow and filler styling
  • /ce version now reports the active economy provider and permission provider

Removed

  • The unused legacy dev.nexus package and its build exclusion

Fixed

  • Added the missing transactions.empty-state GUI entry that previously rendered as a barrier

Breaking changes

/shop changed meaning. It now opens the server shop; player shops are at /pshop (aliases playershop, myshop). Update any signs, kits, NPCs, or docs that pointed at /shop create.

gui.yml and messages.yml were restructured. Existing files keep working, but they will not have the new settings block, the new slot layout, or the new module sections, so you will not get back arrows, fillers, sounds, or head items until you update them. The simplest path is to rename both files and let the plugin regenerate them, then reapply your edits.

Server requirement. Requires Paper, Purpur, Spigot, or Bukkit 1.21.8+ and Java 21.

Upgrade notes

  1. Stop the server and back up your plugins/CrownEconomy folder
  2. Replace the jar
  3. Rename gui.yml and messages.yml so they regenerate with the new keys
  4. Start the server, then edit the regenerated config.yml, shop.yml, gui.yml, and messages.yml

Existing auction house data in auction-houses/ is fully compatible and carries over untouched. New data files are created on first run: shop.yml, shops.yml, bank.yml, stats.yml, and balances.yml when the built-in economy is active.

Every module can be switched off independently with its enabled flag in config.yml, so you can run only the parts you want.

Information

Published
August 2, 2026
18Downloads

Platforms

Paper
Paper
1.21–1.21.11

Dependencies

PaperPaper

Dependencies: Paper

Plugins and libraries a server needs for this version to run.

No dependencies

Add anything a server has to install alongside this version.