⚠️ 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.

Compatibility: Paper, Purpur, Pufferfish, Leaves

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.

Aurelium includes a modern, responsive web application 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 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.

• 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.

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.

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!

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.

• 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.

• 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.

1. Download Aurelium-1.4.3.jar.
2. Place it in your server's plugins/ folder.
3. 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.

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

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

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.

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)

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.

• "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.3.jar in plugins/.
• Ensure you are running Paper (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.