{"id":45104033,"url":"https://github.com/applepie6969/aurelium","last_synced_at":"2026-06-04T16:00:15.577Z","repository":{"id":339451748,"uuid":"1161220981","full_name":"APPLEPIE6969/Aurelium","owner":"APPLEPIE6969","description":"A complete Paper 1.21.x economy solution featuring a customizable Admin Market, Player Auction House, and unique Spawner trading. It includes a custom currency and auto-installs Vault for an instant, plug-and-play experience. https://modrinth.com/plugin/aurelium","archived":false,"fork":false,"pushed_at":"2026-06-03T23:01:06.000Z","size":8768,"stargazers_count":4,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"Latest","last_synced_at":"2026-06-04T00:08:07.331Z","etag":null,"topics":["minecraft","minecraft-paper","minecraft-paper-plugin","minecraft-plugin","plugin"],"latest_commit_sha":null,"homepage":"https://modrinth-wiki.vercel.app/project/aurelium","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/APPLEPIE6969.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-18T21:40:13.000Z","updated_at":"2026-06-03T23:01:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"32c9f72d-1916-47c2-a5f2-a006a92fc94e","html_url":"https://github.com/APPLEPIE6969/Aurelium","commit_stats":null,"previous_names":["applepie6969/aurelium"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/APPLEPIE6969/Aurelium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APPLEPIE6969%2FAurelium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APPLEPIE6969%2FAurelium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APPLEPIE6969%2FAurelium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APPLEPIE6969%2FAurelium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/APPLEPIE6969","download_url":"https://codeload.github.com/APPLEPIE6969/Aurelium/tar.gz/refs/heads/Latest","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/APPLEPIE6969%2FAurelium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33912319,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","minecraft-paper","minecraft-paper-plugin","minecraft-plugin","plugin"],"created_at":"2026-02-19T21:56:32.491Z","updated_at":"2026-06-04T16:00:15.529Z","avatar_url":"https://github.com/APPLEPIE6969.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurelium 💎\n\n\u003e **⚠️ EXPERIMENTAL WEB FEATURES ⚠️**\n\u003e \n\u003e *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.*\n\n**Aurelium** is a comprehensive, standalone economy plugin for Minecraft Paper.\n\u003e **Compatibility**: Paper, Purpur, Pufferfish, Leaves\n\nIt 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.\n\n## Features\n\n### Web Dashboard (Optional)\nAurelium 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.\n\n* **Server Market:** Fully functional directly from the web—purchase items and have them delivered instantly in-game!![Web Market](https://cdn.modrinth.com/data/cached_images/b28a02ddb620b4a6b5bc54be95508d4adaabba29.png)\n* **Auction House:** Fully interactive from the web—place bids and buyout items (BIN) securely. ![Web Auction House](https://cdn.modrinth.com/data/cached_images/d27ae421656ac26b76fbdc269d9ead39b93c471c.png)\n* **Buy Orders:** Fully interactive from the web—fulfill player buy orders straight from your online inventory.![Web Buy Orders](https://cdn.modrinth.com/data/cached_images/709660b24ff769aaaf25b9f1c541577e372c7f6b.png)\n* **Price Tracker:** An interactive chart tracking detailed item price histories. ![Web Chart](https://cdn.modrinth.com/data/cached_images/6a6c7c0a5e5a3371120a40242bc91baef67cb6ce.png) \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.![Web Chart](https://cdn.modrinth.com/data/cached_images/101eff1a2a1ccb5f32ba6ffcc77c752f47dad4b3.png)\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., `₳`, `$`, `€`) synced perfectly from your `config.yml`.\n- **Icon Fallbacks**: Robust image loading seamlessly falls back to older Minecraft versions 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 — 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`.\n\n### Economy\n- **Multi-Currency**: Define multiple currencies (e.g., Aurels ₳, Dollars $, Euros €) 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.\n\n### Custom Item Detection\n\nAurelium automatically discovers custom items from popular third-party plugins and makes them available in the server market -- no manual config required.\n\n- **Auto-Scan on Startup**: The scanner runs once when the server starts, detecting all custom items from installed plugins.\n- **Supported Plugins** (zero hard dependencies -- all via reflection):\n  - ItemsAdder\n  - Oraxen\n  - MMOItems\n  - MythicMobs\n  - ExecutableItems\n  - Nexo\n  - SX-Item\n- **`/customitems` Command**:\n  - `/customitems scan` -- Force a rescan of all supported plugins\n  - `/customitems list` -- View all discovered custom items\n  - `/customitems info \u003cid\u003e` -- Show details for a specific item\n  - `/customitems reload` -- Reload config overrides from disk\n  - `/customitems toggle \u003cid\u003e` -- Enable or disable a discovered item in the market\n  - `/customitems price \u003cid\u003e \u003cbuy\u003e [sell]` -- Set buy/sell prices for a discovered item\n- **Config Sync**: Discovered items are written to `config.yml` under `discovered-items:` with source plugin, display name, material, and default prices. Edits in config are loaded on startup or via `/customitems reload`.\n- **Database Tracking**: Custom items are persisted in a `custom_items` table (schema v2, auto-migrates from v1).\n- **Safe Fallbacks**: If no supported custom item plugins are installed, the scanner silently skips with zero overhead.\n\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**. \n\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 (✔)** or **Decline (✖)**.\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!\n\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.\n\n### Market Stabilization\n- **Price Floor \u0026 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.\n\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 (▲ +%)**: Demand is peaking.\n  - **Red (▼ -%)**: Market is oversaturated.\n\n## Commands\n\n### Player\n\n| Command | Description | Permission |\n| :--- | :--- | :--- |\n| `/bal [player] [currency]` | Check your own or another player's balance. | `aureleconomy.bal` |\n| `/pay \u003cplayer\u003e \u003camount\u003e [currency]` | Pay another player. | `aureleconomy.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 \u003citem\u003e \u003camount\u003e \u003cprice\u003e [currency]` | Place a buy order via command. | `aureleconomy.orders` |\n| `/orders fill \u003cid\u003e [amount]` | Fulfill someone else's order from your inventory. | `aureleconomy.orders` |\n| `/orders cancel \u003cid\u003e` | Cancel your own order and get a refund. | `aureleconomy.orders` |\n| `/orders my` | List all your active buy orders with IDs. | `aureleconomy.orders` |\n| `/orders search \u003cquery\u003e` | Search active orders by item name. | `aureleconomy.orders` |\n| `/ah` | Open the Auction House. | `aureleconomy.ah` |\n| `/ah sell \u003cprice\u003e [duration] [currency]` | List item for BIN (Buy It Now). Duration optional (e.g. 1h, 7d). | `aureleconomy.ah` |\n| `/ah bid \u003cprice\u003e [duration]` | List item for Auction. Duration optional (e.g. 1h, 7d).| `aureleconomy.ah` |\n| `/ah offer \u003cid\u003e \u003cqty\u003e` | Send a private offer for an item. | `aureleconomy.ah` |\n| `/ah offers` | Manage incoming private offers. | `aureleconomy.ah` |\n| `/ah collect` | Collect expired/purchased items. | `aureleconomy.ah` |\n| `/ah search \u003cquery\u003e` | Instantly open a filtered view of the Auction House. | `aureleconomy.ah` |\n\n\n### Admin\n\n| Command | Description | Permission |\n| :--- | :--- | :--- |\n| `/eco \u003cgive/take/set\u003e \u003cplayer\u003e \u003camount\u003e [currency]` | Modify player balances. | `aureleconomy.admin` |\n\n## Setup\n\n1. Download `Aurelium-1.4.5.jar`.\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.*\n\n## Config\n\n### Items\nControl every price directly in the config:\n\n```yaml\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```\n\n### Network Syncing (MySQL Required)\nAurelium supports cross-server synchronization for **BungeeCord** and **Velocity** networks. \n\n\u003e [!IMPORTANT]\n\u003e **MySQL IS REQUIRED** for synchronization. SQLite does not support cross-server data sharing.\n\nBy 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:\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.\n\n### Global\nControl the plugin's behavior in `config.yml`:\n\n```yaml\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\"\n  \neconomy:\n  default-currency: \"Aurels\" # Default currency for Vault \u0026 fallbacks\n  currencies:\n    Aurels:\n      symbol: \"₳\"\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\n\nmarket:\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\n\nauction-house:\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\n\nbuy-orders:\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\n\nweb:\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```\n\n### Language\nA `messages.yml` file is generated on startup.\n- **Translate**: Change any message to your language.\n- **Color Codes**: Use MiniMessage formatting (e.g., `\u003cgreen\u003e`) or legacy `\u0026` codes.\n\n## FAQ\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.5.jar` in `plugins/`.\n  - Ensure you are running **Paper** (or compatible forks: Purpur, Pufferfish, Leaves).\n- **\"No Permission\"**:\n  - Ensure you are **OP** (`/op \u003cplayer\u003e`) or have the permission node `aureleconomy.admin`.\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](https://github.com/APPLEPIE6969/Aurelium/issues) on GitHub with your server version, error logs, and steps to reproduce.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapplepie6969%2Faurelium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapplepie6969%2Faurelium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapplepie6969%2Faurelium/lists"}