A complete Paper economy solution featuring a customizable web-based Market, Player Auction House, and unique Spawner trading. It includes a custom currency and auto-installs Vault for an instant, plug-and-play experience.
Aurelium Economy & Market Overview
The sell menu
The Web Market
/web command
Web Stocks
Experimental Web Features The web dashboard is in active development. Expect potential bugs or instability if you enable
web.enabled. The core in-game economy, GUI markets, and auction house are stable.
A standalone economy plugin for Minecraft Paper.
Compatibility: Paper, Purpur, Pufferfish, Leaves
A server-owned shop with dynamic pricing and three interface modes:
Pricing Mechanics:
Quality of Life:
Performance:
A fully self-contained player-driven exchange:
/ah offers to Accept or Decline incoming dealsA global request system for offline purchasing:
/ah collect bin; notified on loginAutomatically discovers custom items from popular third-party plugins:
config.yml under discovered-items:custom_items database table (schema v2, auto-migrates)
Web Features:
config.yml/web in-game generates a time-limited link (rolling 1-hour timeout)| Command | Description | Permission |
|---|---|---|
/bal [player] [currency] | Check your own or another player's balance | aureleconomy.bal |
/pay <player> <amount> [currency] | Pay another player | aureleconomy.pay |
/market | Open the in-game server market | aureleconomy.market |
/sell | Sell items from your inventory | aureleconomy.sell |
/stocks | View market trends | aureleconomy.stocks |
/web | Generate a secure link to the browser dashboard | aureleconomy.web |
/ah | Open the Auction House | aureleconomy.ah |
/ah sell <price> [duration] [currency] | List held item as BIN. Duration: e.g. 1h, 7d | aureleconomy.ah |
/ah bid <price> [duration] | List held item for auction. Duration: e.g. 1h, 7d | aureleconomy.ah |
/ah offer <id> <qty> | Send a private offer for an auction item | aureleconomy.ah |
/ah offers | Manage incoming private offers | aureleconomy.ah |
/ah collect | Collect expired/purchased items | aureleconomy.ah |
/ah search <query> | Open a filtered Auction House view | aureleconomy.ah |
/orders | Open the Buy Orders GUI | aureleconomy.orders |
/orders create <item> <amount> <price> [currency] | Place a buy order | aureleconomy.orders |
/orders fill <id> [amount] | Fulfill an order from your inventory | aureleconomy.orders |
/orders cancel <id> | Cancel your order and get a refund | aureleconomy.orders |
/orders my | List your active buy orders | aureleconomy.orders |
/orders search <query> | Search active orders by item name | aureleconomy.orders |
| Command | Description | Permission |
|---|---|---|
/eco <give|take|set> <player> <amount> [currency] | Modify player balances | aureleconomy.admin |
/customitems | Open the custom items browser | aureleconomy.admin |
/customitems scan | Force rescan all supported custom item plugins | aureleconomy.admin |
/customitems list | View all discovered custom items | aureleconomy.admin |
/customitems info <id> | Show details for a specific custom item | aureleconomy.admin |
/customitems reload | Reload config overrides from disk | aureleconomy.admin |
/customitems toggle <id> | Enable or disable a discovered item in the market | aureleconomy.admin |
/customitems price <id> <buy> [sell] | Set buy/sell prices for a discovered item | aureleconomy.admin |
| Permission | Description | Default |
|---|---|---|
aureleconomy.bal | Check balance | Everyone |
aureleconomy.pay | Pay players | Everyone |
aureleconomy.market | Use the market | Everyone |
aureleconomy.sell | Use /sell | Everyone |
aureleconomy.ah | Use the auction house | Everyone |
aureleconomy.orders | Use buy orders | Everyone |
aureleconomy.stocks | View market trends | Everyone |
aureleconomy.web | Use /web | Everyone |
aureleconomy.admin | Admin commands (eco, customitems) | OP only |
1.21.x are for Minecraft 1.21 through 1.21.11, and need Java 2126.1.x are for Minecraft 26.1, 26.1.1 and 26.1.2, and need Java 2526.2.x are for Minecraft 26.2, and need Java 25plugins/ folderdatabase:
type: sqlite # sqlite or mysql
file: "database.db" # SQLite only, relative to the plugin folder
mysql: # MySQL only
host: "localhost"
port: 3306
database: "aurelium"
username: "root"
password: "password"
ssl-mode: "PREFERRED" # DISABLED | PREFERRED | REQUIRED | VERIFY_CA | VERIFY_IDENTITY
ssl-mode defaults to PREFERRED: the connection is encrypted whenever the server offers TLS,
without needing a truststore. Use VERIFY_CA or VERIFY_IDENTITY if the database is reached over
an untrusted network, since those also validate the server certificate.
economy:
default-currency: "Aurels"
currencies:
Aurels:
symbol: "₳"
starting-balance: 100.0
max-balance: -1 # -1 = unlimited
min-pay-amount: 0.01
Control every price directly:
market-items:
DIAMOND:
buy: 5000.0 # Cost to buy from server
sell: 0.0 # 0.0 = selling disabled
DIRT:
buy: 1.0
sell: 0.5 # Players can sell for 0.5
BEDROCK:
buy: -1.0 # -1.0 = buying disabled
market:
enabled: true
gui-mode: modern # "classic" or "modern"
dynamic-pricing: true
price-increase-per-buy: 0.001 # +0.1% per buy
price-decrease-per-sell: 0.001 # -0.1% per sell
default-sell-ratio: 0.5
price-floor: 0.2 # Can't drop below 20% of base
price-ceiling: 5.0 # Can't rise above 500% of base
price-recovery:
enabled: true
rate: 0.01 # 1% of gap per cycle
interval-minutes: 10
auction-house:
enabled: true
default-duration: 86400 # 24 hours (seconds)
max-duration: 604800 # 7 days max
listing-fee-percent: 2.0
sales-tax-percent: 5.0
max-listings-per-player: -1 # -1 = unlimited
min-listing-price: 1.0
buy-orders:
enabled: true
max-active-orders-per-player: 10
min-price-per-piece: 0.1
max-order-value: -1 # -1 = unlimited
creation-fee-percent: 2.0
sales-tax-percent: 5.0
web:
enabled: true
mode: cloud # "local" = webserver inside the plugin (needs an open port)
# "cloud" = syncs to an external server (works on all hosts)
local: # only used when mode is "local"
host: "localhost" # keeps the dashboard on this machine. "0.0.0.0" exposes it,
# and the session link in its URL, on every network interface
port: 8585
server-id: "local" # how this server is addressed in dashboard URLs
session-timeout-minutes: 60
snapshot-interval-seconds: 30
price-history-interval-minutes: 10
cloud: # only used when mode is "cloud"
url: "https://aurelium.alwaysdata.net"
sync-interval: 30
Your server's server-id and api-key under web.cloud are generated automatically
on first run and saved to config. Don't share them: the key is what authorizes your
server to the dashboard.
In local mode the dashboard runs inside the plugin, so there is nothing else to host.
In cloud mode everything syncs to the hosted dashboard, so it works even on hosts
where you cannot open a port. Players open the dashboard with /web, which generates
a time-limited link; a session can also be revoked at any time.
Web purchases are queued before they are charged, and whether that queue survives a restart is configurable:
web-queue:
type: memory # memory (lost on restart) or sqlite (kept on disk)
file: "web-queue.db"
Aurelium supports cross-server synchronization for BungeeCord and Velocity networks.
MySQL is required for synchronization. SQLite does not support cross-server data sharing. Point all backend servers to the same MySQL database:
config.yml, allowing different economies per server while players keep the same walletA messages.yml file is generated on startup.
<green>) or legacy & codes"Unknown Command" - If /market or /eco says "Unknown command", the plugin failed to load.
Aurelium.jar in plugins/"No Permission" - You need OP (/op <player>) or the aureleconomy.admin permission node. Standard player commands are enabled for everyone by default.
Still not working? - Open an issue on GitHub with your server version, error logs, and steps to reproduce.