Aurelium 💎

⚠️ EXPERIMENTAL WEB FEATURES ⚠️

The newly added Web Dashboard features are currently in active development. Please expect potential bugs or instability if you enable web.enabled in your configuration. The core in-game economy, GUI markets, and auction house are mostly stable.

Aurelium is a comprehensive, standalone economy plugin for Minecraft Paper 1.21.11.

Compatibility: Paper, Purpur, Pufferfish, Leaves (1.21.x)

It features a multi-currency system, a flexible Server Market with three interface modes (classic chest, modern styled, or browser-based web dashboard), a player-driven Auction House, Buy Orders, and seamless Vault integration.

Features

Web Dashboard (Optional)

Aurelium includes a modern, responsive web application with 99.978% uptime that players can use to browse the Server Market, monitor stock trends, and engage with the Auction House from their browser.

Server Market: Fully functional directly from the web—purchase items and have them delivered instantly in-game!
Auction House: Fully interactive from the web—place bids and buyout items (BIN) securely.
Buy Orders: Fully interactive from the web—fulfill player buy orders straight from your online inventory.
Price Tracker: An interactive chart tracking detailed item price histories.
Live Sync: Changes in-game reflect instantly on the web, and vice-versa. Click any item for an interactive chart with 7-day price history, smooth bezier curves, gradient fills, and hover tooltips.

Price History: Prices are recorded every 10 minutes and stored for 7 days for charts.
Cloud Mode: Optional cloud hosting via Render for almost always-accessible dashboards.
Multi-Currency UI: Correctly displays custom currency symbols (e.g., ₳, $, €) synced perfectly from your config.yml.
Icon Fallbacks: Robust image loading seamlessly falls back to older Minecraft versions (1.21, 1.20, 1.19, 1.18) if modern icons aren't available from external APIs yet.
Secure Sessions: Players use /web in-game to get a time-limited clickable link. Sessions use a rolling 1-hour timeout that resets on activity. Visiting the dashboard without a session shows a friendly error screen with instructions.
Tab Sleep Mode: When a player switches to another browser tab or minimizes the window, the entire dashboard goes to sleep — no network requests, no CPU usage. When they return, it instantly wakes up and loads fresh data.
RAM Optimized: Bulk data (auctions, orders, stocks, price history) is cached as raw JSON strings, keeping per-server memory usage under 1MB.
Activation Queue: If the cloud server reaches its 500MB RAM limit, new server registrations are fairly waitlisted until memory frees up.
Configurable: Port and enable/disable toggle in config.yml.

Economy

Multi-Currency: Define multiple currencies (e.g., Aurels ₳, Dollars $, Euros €) with unique symbols and starting balances.
Per-Item Currency: Assign specific currencies to individual market items.
Vault Support: Fully compatible with Vault-dependent plugins (ShopGUI+, Essentials, etc.).
Database: SQLite or MySQL storage with automatic migration support.
Offline Earnings: Get paid for auction sales even when you're offline.

Market

A server-owned shop that functions like a Stock Market, with three interface modes:

Classic: Traditional chest-based inventory GUI.
Modern: Styled chest GUI with MiniMessage gradient titles, glass-pane borders, and formatted lore.
Web: A Modrinth-inspired browser dashboard (see Web Dashboard above).
Demand/Supply Logic: Prices automatically rise when people buy (Demand) and fall when they sell (Supply). Both Buy and Sell values scale proportionally.
Anti-Exploit Safeguards: Mathematically prevents the dynamic Sell price from ever exceeding the Buy price.
Live UI Updates: The /market and /stocks menus automatically refresh every 1 second natively while open.
Smart Pagination: GUIs now feature Page Indicator Books in the center of the navigation bar, showing exactly what page you are on (e.g., "Page 1 of 5").
Searchable Menus: Easily find any item in the Market or Auction House using the new Compass search button.
Market Crash Alerts: Server-wide announcements when high-value items (Diamonds, Spawners, etc.) drop to bargain prices.
Performance Optimized:
- Viewer-Only Refresh: Logic remains completely dormant unless a player has a menu open.
- Batched Disk I/O: Transaction data is saved in backgrounds batches, preventing server "lag spikes" during high-volume trading.
- O(1) Data Access: Market prices use ultra-fast local caching for near-zero CPU impact.
Smart Inventory Logistics: Purchasing items securely fills your existing partial stacks instead of strictly demanding empty inventory slots.
Massive Catalog: Includes ALL Building Blocks (Stones, Deepslate, Wood, Glass, Nature, etc.) and over 60+ Mob Spawners.

Auction

A fully self-contained player-driven exchange:

100% GUI Driven: Complex chat commands are a thing of the past. You can effortlessly Sell Items, Place Custom Bids, and Make Private Offers directly via intuitive chat-prompt buttons inside the menus.
Safety Confirmations: Never accidentally bankrupt yourself again. Both Buy It Now and Bidding feature a dedicated Confirmation Screen before deducting funds.
Manage Offers: Sellers can view all incoming deals in /ah offers and instantly Accept (✔) or Decline (✖).
Live Updates: The GUI instantly refreshes for all players when an item is bought, bidded on, or cancelled. Additionally, auction timers update in real-time every second while the menu is open.
Auto-Refunds: Placed a bid and got outbid? Your money is instantly returned to your balance.
Pro-Tip: Almost every command below (like /ah search, /sell, and /ah offer) can also be triggered by simply clicking the intuitive buttons (Compass, Emerald, or Books) directly inside the GUIs!

Buy Orders

A global request system that lets players buy things they want even while offline:

Global Requests: Request any item in the game (including all 120+ Enchanted Books and Ingots) at your specific custom price.
Automated Fulfillment: Other players can browse active orders and fulfill them instantly directly from their inventory.
Escrow System: Money is held safely in escrow. If you cancel an order, your unspent funds are instantly returned.
Offline Collections: Items fulfilled while you are offline are safely put into your Auction House /ah collect bin. You'll be notified on login!
Buyer Notifications: Get notified in real-time when someone fills your order, or on your next login if you were offline.
Intelligent Searching: The /orders GUI features dynamic search buttons (Compass and Sign icons) allowing you to filter specific categories or search the entire Minecraft catalog for any valid item.

Market Stabilization

Price Floor & Ceiling: Prices can never crash below 20% or inflate above 500% of the original base value (both configurable).
Natural Recovery: Prices passively drift back toward their base value every 10 minutes, preventing permanent crashes from auto-farms.

Stocks

Real-time Tracking: View the incredibly accurate Current Buy Price and Current Sell Price of every item in the market.
Trends:
- Green (▲ +%): Demand is peaking.
- Red (▼ -%): Market is oversaturated.

Commands

Player

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 (Classic or Modern mode).	`aureleconomy.market`
`/web`	Generate a secure link to the Browser Dashboard.	`aureleconomy.web`
`/stocks`	View market trends.	`aureleconomy.stocks`
`/orders`	Open the Buy Orders GUI.	`aureleconomy.orders`
`/orders create <item> <amount> <price> [currency]`	Place a buy order via command.	`aureleconomy.orders`
`/orders fill <id> [amount]`	Fulfill someone else's order from your inventory.	`aureleconomy.orders`
`/orders cancel <id>`	Cancel your own order and get a refund.	`aureleconomy.orders`
`/orders my`	List all your active buy orders with IDs.	`aureleconomy.orders`
`/orders search <query>`	Search active orders by item name.	`aureleconomy.orders`
`/ah`	Open the Auction House.	`aureleconomy.ah`
`/ah sell <price> [duration] [currency]`	List item for BIN (Buy It Now). Duration optional (e.g. 1h, 7d).	`aureleconomy.ah`
`/ah bid <price> [duration]`	List item for Auction. Duration optional (e.g. 1h, 7d).	`aureleconomy.ah`
`/ah offer <id> <qty>`	Send a private offer for an item.	`aureleconomy.ah`
`/ah offers`	Manage incoming private offers.	`aureleconomy.ah`
`/ah collect`	Collect expired/purchased items.	`aureleconomy.ah`
`/ah search <query>`	Instantly open a filtered view of the Auction House.	`aureleconomy.ah`

Admin

Command	Description	Permission
`/eco <give/take/set> <player> <amount> [currency]`	Modify player balances.	`aureleconomy.admin`

Setup

Download Aurelium-1.4.2.jar.
Place it in your server's plugins/ folder.
Restart the server.
- Note: If Vault is not detected, Aurelium will automatically extract and install it into your plugins folder for you upon first run.

Config

Items

Control every price directly in the config:

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 dirt for 0.5
  BEDROCK:
    buy: -1.0      # -1.0 = Buying DISABLED

Network Syncing (MySQL Required)

Aurelium supports cross-server synchronization for BungeeCord and Velocity networks.

[IMPORTANT!] MySQL IS REQUIRED for synchronization. SQLite does not support cross-server data sharing.

By pointing all your backend servers (e.g., Survival, Skyblock) to the same MySQL database in their config.yml, the following data will be shared instantly:

Global Balances: Player balances are refreshed on join, ensuring they carry their money across your entire network.
Global Auction House: All active auctions and the collection bin are shared across all linked servers.
Per-Server Markets: Currently, dynamic Market prices are stored in each server's local config.yml. This allows you to have different economies (e.g., a "Hardcore" survival market vs. a "Creative" skyblock market) while players keep the same wallet.

Global

Control the plugin's behavior in config.yml:

database:
  type: sqlite                      # Supported types: sqlite, mysql
  file: "database.db"               # Active only if type is 'sqlite'
  mysql:                            # Active only if type is 'mysql'
    host: "localhost"
    port: 3306
    database: "aurelium"
    username: "root"
    password: "password"
    
economy:
  default-currency: "Aurels"          # Default currency for Vault & fallbacks
  currencies:
    Aurels:
      symbol: "₳"
      starting-balance: 100.0
    # Dollars:
    #   symbol: "$"
    #   starting-balance: 0.0
  max-balance: -1                     # Max balance (-1 = unlimited)
  min-pay-amount: 0.01                # Minimum /pay transaction

market:
  enabled: true                       # Master toggle for /market
  gui-mode: modern                    # Interface for /market: "classic" or "modern"
  dynamic-pricing: true               # Prices move on buy/sell
  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             # New items default sell = 50% of buy
  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                     # Passive drift toward base
    rate: 0.01                        # 1% of gap per cycle
    interval-minutes: 10              # Recovery cycle frequency

auction-house:
  enabled: true                       # Master toggle for /ah
  default-duration: 86400             # 24 hours (seconds)
  max-duration: 604800                # 7 days max
  listing-fee-percent: 2.0            # Fee to list
  sales-tax-percent: 5.0              # Tax on sale
  max-listings-per-player: -1         # -1 = unlimited
  min-listing-price: 1.0              # Minimum listing price

buy-orders:
  enabled: true                       # Master toggle for /orders
  max-active-orders-per-player: 10    # -1 = unlimited
  min-price-per-piece: 0.1            # Minimum offer price
  max-order-value: -1                 # -1 = unlimited
  creation-fee-percent: 2.0           # Order creation fee
  sales-tax-percent: 5.0              # Seller tax on fulfillment

web:
  enabled: true                       # Start the embedded web server
  port: 8585                          # Port (must be opened in firewall)
  # Session timeout: rolling 1 hour of inactivity (hardcoded)

Language

A messages.yml file is generated on startup.

Translate: Change any message to your language.
Color Codes: Use MiniMessage formatting (e.g., <green>) or legacy & codes.

FAQ

"Unknown Command": If /market or /eco says "Unknown command", the plugin failed to load.
- Check your server console/logs for errors.
- Ensure you have Aurelium-1.4.2.jar in plugins/.
- Ensure you are running Paper 1.21.x (or compatible forks: Purpur, Pufferfish, Leaves).
"No Permission":
- Ensure you are OP (/op <player>) or have the permission node aureleconomy.admin.
- Note: Standard player commands (/bal, /market, /ah, /sell) are enabled for everyone by default.
Still not working?
- If none of the above fixes your issue, please open an issue on GitHub with your server version, error logs, and steps to reproduce.

Aurelium