# Aurelium \ud83d\udc8e<\/p>\n
> **\u26a0\ufe0f EXPERIMENTAL WEB FEATURES \u26a0\ufe0f**
\n>
\n> *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.*<\/p>\n
**Aurelium** is a comprehensive, standalone economy plugin for Minecraft Paper 1.21.11.
\n> **Compatibility**: Paper, Purpur, Pufferfish, Leaves (1.21.x)<\/p>\n
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.<\/p>\n
## Features<\/p>\n
### Web Dashboard (Optional)
\nAurelium includes a modern, responsive web application with nearly 100% uptime that players can use to browse the Server Market, monitor stock trends, and engage with the Auction House from their browser.<\/p>\n
* **Server Market:** Fully functional directly from the web\u2014purchase items and have them delivered instantly in-game!
\n* **Auction House:** Fully interactive from the web\u2014place bids and buyout items (BIN) securely. 
\n* **Buy Orders:** Fully interactive from the web\u2014fulfill player buy orders straight from your online inventory.
\n* **Price Tracker:** An interactive chart tracking detailed item price histories. 
\n* **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.
\n– **Price History**: Prices are recorded every 10 minutes and stored for 7 days for charts.
\n– **Cloud Mode**: Optional cloud hosting via Render for **almost** always-accessible dashboards.
\n– **Multi-Currency UI**: Correctly displays custom currency symbols (e.g., `\u20b3`, `$`, `\u20ac`) synced perfectly from your `config.yml`.
\n– **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.
\n– **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.
\n– **Tab Sleep Mode**: When a player switches to another browser tab or minimizes the window, the entire dashboard goes to sleep \u2014 no network requests, no CPU usage. When they return, it instantly wakes up and loads fresh data.
\n– **RAM Optimized**: Bulk data (auctions, orders, stocks, price history) is cached as raw JSON strings, keeping per-server memory usage under 1MB.
\n– **Activation Queue**: If the cloud server reaches its 500MB RAM limit, new server registrations are fairly waitlisted until memory frees up.
\n– **Configurable**: Port and enable\/disable toggle in `config.yml`.<\/p>\n
### Economy
\n– **Multi-Currency**: Define multiple currencies (e.g., Aurels \u20b3, Dollars $, Euros \u20ac) with unique symbols and starting balances.
\n– **Per-Item Currency**: Assign specific currencies to individual market items.
\n– **Vault Support**: Fully compatible with Vault-dependent plugins (ShopGUI+, Essentials, etc.).
\n– **Database**: SQLite or MySQL storage with automatic migration support.
\n– **Offline Earnings**: Get paid for auction sales even when you’re offline.<\/p>\n
### Market
\nA server-owned shop that functions like a **Stock Market**, with **three interface modes**:
\n– **Classic**: Traditional chest-based inventory GUI.
\n– **Modern**: Styled chest GUI with MiniMessage gradient titles, glass-pane borders, and formatted lore.
\n– **Web**: A Modrinth-inspired browser dashboard (see Web Dashboard above).
\n– **Demand\/Supply Logic**: Prices automatically rise when people buy (Demand) and fall when they sell (Supply). Both Buy and Sell values scale proportionally.
\n– **Anti-Exploit Safeguards**: Mathematically prevents the dynamic Sell price from ever exceeding the Buy price.
\n– **Live UI Updates**: The `\/market` and `\/stocks` menus automatically refresh every **1 second** natively while open.
\n– **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”).
\n– **Searchable Menus**: Easily find any item in the Market or Auction House using the new **Compass** search button.
\n– **Market Crash Alerts**: Server-wide announcements when high-value items (Diamonds, Spawners, etc.) drop to bargain prices.
\n– **Performance Optimized**:
\n – **Viewer-Only Refresh**: Logic remains completely dormant unless a player has a menu open.
\n – **Batched Disk I\/O**: Transaction data is saved in backgrounds batches, preventing server “lag spikes” during high-volume trading.
\n – **O(1) Data Access**: Market prices use ultra-fast local caching for near-zero CPU impact.
\n– **Smart Inventory Logistics**: Purchasing items securely fills your existing partial stacks instead of strictly demanding empty inventory slots.
\n– **Massive Catalog**: Includes **ALL Building Blocks** (Stones, Deepslate, Wood, Glass, Nature, etc.) and over **60+ Mob Spawners**. <\/p>\n
### Auction
\nA fully self-contained player-driven exchange:
\n– **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.
\n– **Safety Confirmations**: Never accidentally bankrupt yourself again. Both *Buy It Now* and *Bidding* feature a dedicated **Confirmation Screen** before deducting funds.
\n– **Manage Offers**: Sellers can view all incoming deals in `\/ah offers` and instantly **Accept (\u2714)** or **Decline (\u2716)**.
\n– **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.
\n– **Auto-Refunds**: Placed a bid and got outbid? Your money is **instantly returned** to your balance.
\n– **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!<\/p>\n
### Buy Orders
\nA global request system that lets players buy things they want even while offline:
\n– **Global Requests**: Request any item in the game (including all 120+ Enchanted Books and Ingots) at your specific custom price.
\n– **Automated Fulfillment**: Other players can browse active orders and fulfill them instantly directly from their inventory.
\n– **Escrow System**: Money is held safely in escrow. If you cancel an order, your unspent funds are instantly returned.
\n– **Offline Collections**: Items fulfilled while you are offline are safely put into your Auction House `\/ah collect` bin. You’ll be notified on login!
\n– **Buyer Notifications**: Get notified in real-time when someone fills your order, or on your next login if you were offline.
\n– **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.<\/p>\n
### Market Stabilization
\n– **Price Floor & Ceiling**: Prices can never crash below 20% or inflate above 500% of the original base value (both configurable).
\n– **Natural Recovery**: Prices passively drift back toward their base value every 10 minutes, preventing permanent crashes from auto-farms.<\/p>\n
### Stocks
\n– **Real-time Tracking**: View the incredibly accurate *Current Buy Price* and *Current Sell Price* of every item in the market.
\n– **Trends**:
\n – **Green (\u25b2 +%)**: Demand is peaking.
\n – **Red (\u25bc -%)**: Market is oversaturated.<\/p>\n
## Commands<\/p>\n
### Player<\/p>\n
| Command | Description | Permission | ### Admin<\/p>\n | Command | Description | Permission | ## Setup<\/p>\n 1. Download `Aurelium-1.4.2.jar`. ## Config<\/p>\n ### Items “`yaml ### Network Syncing (MySQL Required) > [IMPORTANT!] 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 “`yaml economy: market: auction-house: buy-orders: web: ### Language ## FAQ A complete Paper 1.21.x 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.<\/p>\n","protected":false},"featured_media":22534,"template":"","meta":{"_minecraft_slug":"aurelium","_minecraft_project_id":"LJ9k5olE","_minecraft_author":"APPLEPIE6969","_minecraft_license":"LicenseRef-Aurelium-License","_minecraft_downloads":3073,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"aurelium.zip","_minecraft_size_bytes":46297713,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T05:03:30.224166Z","_minecraft_date_created":"2026-02-20T01:33:51.028163Z","_minecraft_date_modified":"2026-05-10T21:06:17.562731Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/aurelium","_minecraft_icon_attachment_id":22534,"_minecraft_imported_at":"2026-05-31T22:01:57+00:00","_minecraft_import_hash":"efcfead9b06e1c78acf4f4fcee1dd42d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-22533","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `\/bal [player] [currency]` | Check your own or another player’s balance. | `aureleconomy.bal` |
\n| `\/pay
\n| `\/market` | Open the in-game server market (Classic or Modern mode). | `aureleconomy.market` |
\n| `\/web` | Generate a secure link to the Browser Dashboard. | `aureleconomy.web` |
\n| `\/stocks` | View market trends. | `aureleconomy.stocks` |
\n| `\/orders` | Open the Buy Orders GUI. | `aureleconomy.orders` |
\n| `\/orders create
\n| `\/orders fill
\n| `\/orders cancel
\n| `\/orders my` | List all your active buy orders with IDs. | `aureleconomy.orders` |
\n| `\/orders search
\n| `\/ah` | Open the Auction House. | `aureleconomy.ah` |
\n| `\/ah sell
\n| `\/ah bid
\n| `\/ah offer
\n| `\/ah offers` | Manage incoming private offers. | `aureleconomy.ah` |
\n| `\/ah collect` | Collect expired\/purchased items. | `aureleconomy.ah` |
\n| `\/ah search
\n| :— | :— | :— |
\n| `\/eco
\n2. Place it in your server’s `plugins\/` folder.
\n3. **Restart** the server.
\n – *Note: If Vault is not detected, Aurelium will automatically extract and install it into your plugins folder for you upon first run.*<\/p>\n
\nControl every price directly in the config:<\/p>\n
\nmarket-items:
\n DIAMOND:
\n buy: 5000.0 # Cost to buy from server
\n sell: 0.0 # 0.0 = Selling DISABLED
\n DIRT:
\n buy: 1.0
\n sell: 0.5 # Players can sell dirt for 0.5
\n BEDROCK:
\n buy: -1.0 # -1.0 = Buying DISABLED
\n“`<\/p>\n
\nAurelium supports cross-server synchronization for **BungeeCord** and **Velocity** networks. <\/p>\n
\n> **MySQL IS REQUIRED** for synchronization. SQLite does not support cross-server data sharing.<\/p>\n
\n* **Global Balances**: Player balances are refreshed on join, ensuring they carry their money across your entire network.
\n* **Global Auction House**: All active auctions and the collection bin are shared across all linked servers.
\n* **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.<\/p>\n
\nControl the plugin’s behavior in `config.yml`:<\/p>\n
\ndatabase:
\n type: sqlite # Supported types: sqlite, mysql
\n file: “database.db” # Active only if type is ‘sqlite’
\n mysql: # Active only if type is ‘mysql’
\n host: “localhost”
\n port: 3306
\n database: “aurelium”
\n username: “root”
\n password: “password”<\/p>\n
\n default-currency: “Aurels” # Default currency for Vault & fallbacks
\n currencies:
\n Aurels:
\n symbol: “\u20b3”
\n starting-balance: 100.0
\n # Dollars:
\n # symbol: “$”
\n # starting-balance: 0.0
\n max-balance: -1 # Max balance (-1 = unlimited)
\n min-pay-amount: 0.01 # Minimum \/pay transaction<\/p>\n
\n enabled: true # Master toggle for \/market
\n gui-mode: modern # Interface for \/market: “classic” or “modern”
\n dynamic-pricing: true # Prices move on buy\/sell
\n price-increase-per-buy: 0.001 # +0.1% per buy
\n price-decrease-per-sell: 0.001 # -0.1% per sell
\n default-sell-ratio: 0.5 # New items default sell = 50% of buy
\n price-floor: 0.2 # Can’t drop below 20% of base
\n price-ceiling: 5.0 # Can’t rise above 500% of base
\n price-recovery:
\n enabled: true # Passive drift toward base
\n rate: 0.01 # 1% of gap per cycle
\n interval-minutes: 10 # Recovery cycle frequency<\/p>\n
\n enabled: true # Master toggle for \/ah
\n default-duration: 86400 # 24 hours (seconds)
\n max-duration: 604800 # 7 days max
\n listing-fee-percent: 2.0 # Fee to list
\n sales-tax-percent: 5.0 # Tax on sale
\n max-listings-per-player: -1 # -1 = unlimited
\n min-listing-price: 1.0 # Minimum listing price<\/p>\n
\n enabled: true # Master toggle for \/orders
\n max-active-orders-per-player: 10 # -1 = unlimited
\n min-price-per-piece: 0.1 # Minimum offer price
\n max-order-value: -1 # -1 = unlimited
\n creation-fee-percent: 2.0 # Order creation fee
\n sales-tax-percent: 5.0 # Seller tax on fulfillment<\/p>\n
\n enabled: true # Start the embedded web server
\n port: 8585 # Port (must be opened in firewall)
\n # Session timeout: rolling 1 hour of inactivity (hardcoded)
\n“`<\/p>\n
\nA `messages.yml` file is generated on startup.
\n– **Translate**: Change any message to your language.
\n– **Color Codes**: Use MiniMessage formatting (e.g., `
\n– **”Unknown Command”**: If `\/market` or `\/eco` says “Unknown command”, the plugin failed to load.
\n – Check your server console\/logs for errors.
\n – Ensure you have `Aurelium-1.4.2.jar` in `plugins\/`.
\n – Ensure you are running **Paper 1.21.x** (or compatible forks: Purpur, Pufferfish, Leaves).
\n– **”No Permission”**:
\n – Ensure you are **OP** (`\/op
\n – Note: Standard player commands (`\/bal`, `\/market`, `\/ah`, `\/sell`) are enabled for everyone by default.
\n– **Still not working?**
\n – If none of the above fixes your issue, please open an issue on GitHub with your server version, error logs, and steps to reproduce.<\/p>\n","protected":false},"excerpt":{"rendered":"