Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Skin Browser
  • Cape Gallery
  • Seed Vault
  • Blog
  • Guides

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

Site & Legal

  • About
  • Authors
  • Editorial Policy
  • Corrections
  • Contact
  • Privacy Policy
  • Terms of Service
  • DMCA
  • Sitemap

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
Aurelium
PluginLicenseRef-Aurelium-License

Aurelium

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.

4.9K
Downloads
9
Followers
2 weeks ago
Updated
📦
17
Versions
economygame-mechanicsutilitypaperpurpur
Download Latestv1.5.2-26.1.xView on Modrinth

📖About Aurelium

Aurelium

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 comprehensive, standalone economy plugin for Minecraft Paper.

Compatibility: Paper, Purpur, Pufferfish, Leaves


Table of Contents

  • Features
  • Commands
  • Permissions
  • Setup
  • Configuration
  • FAQ

Features

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
  • Offline Earnings - Get paid for auction sales even when offline

Server Market

A server-owned shop with dynamic pricing and three interface modes:

  • Classic - Traditional chest-based inventory GUI
  • Modern - Styled chest GUI with MiniMessage gradient titles, glass-pane borders, formatted lore
  • Web - Browser dashboard (see Web Dashboard)

Pricing Mechanics:

  • Prices automatically rise on buys (Demand) and fall on sells (Supply)
  • Anti-Exploit: Sell price can never exceed Buy price
  • Price Floor: Can't drop below 20% of base (configurable)
  • Price Ceiling: Can't rise above 500% of base (configurable)
  • Natural Recovery: Prices passively drift toward base value every 10 minutes

Quality of Life:

  • Live UI updates every 1 second while a menu is open
  • Page indicator books showing current page (e.g., "Page 1 of 5")
  • Compass search button to find any item
  • Market Crash Alerts for bargain-priced high-value items
  • Smart inventory: purchases fill partial stacks first

Performance:

  • Viewer-Only Refresh: logic dormant unless a player has a menu open
  • Batched Disk I/O: transaction data saved in background batches
  • O(1) Data Access: local caching for near-zero CPU impact
  • Massive Catalog: all building blocks + 60+ mob spawners

Auction House

A fully self-contained player-driven exchange:

  • 100% GUI Driven: sell items, place bids, make private offers via in-menu buttons
  • Safety Confirmations: dedicated confirmation screen before deducting funds
  • Manage Offers: /ah offers to Accept or Decline incoming deals
  • Live Updates: GUI refreshes instantly for all players on buys, bids, cancels; timers update every second
  • Auto-Refunds: outbid? Money instantly returned

Buy Orders

A global request system for offline purchasing:

  • Request any item (including 120+ enchanted books and ingots) at your price
  • Other players browse and fulfill orders from their inventory
  • Escrow System: money held safely, refunded on cancel
  • Offline Collections: fulfilled items go to /ah collect bin; notified on login
  • Buyer Notifications: real-time when filled, or on next login

Custom Item Detection

Automatically discovers custom items from popular third-party plugins:

  • Auto-Scan on Startup - runs once, detects all custom items
  • Supported Plugins (zero hard dependencies, all via reflection):
    • ItemsAdder, Oraxen, MMOItems, MythicMobs, ExecutableItems, Nexo, SX-Item
  • Discovered items written to config.yml under discovered-items:
  • Persisted in custom_items database table (schema v2, auto-migrates)
  • No supported plugins installed? Scanner silently skips with zero overhead

Web Dashboard

A modern, responsive web app with nearly 100% uptime:

  • Server Market - purchase items from the web, delivered instantly in-game

Web Market

  • Auction House - place bids and buyout items (BIN) from the browser

Web Auction House

  • Buy Orders - fulfill player buy orders from your online inventory

Web Buy Orders

  • Price Tracker - interactive chart with 7-day history, bezier curves, gradient fills, hover tooltips

Web Chart

Web Chart Detail

Web Features:

  • Live Sync: in-game changes reflect instantly on the web and vice-versa
  • Prices recorded every 10 minutes, stored for 7 days
  • Cloud Mode: optional cloud hosting via Render
  • Multi-Currency UI: custom currency symbols synced from config.yml
  • Icon Fallbacks: seamless fallback for older MC versions
  • Secure Sessions: /web in-game generates a time-limited link (rolling 1-hour timeout)
  • Tab Sleep Mode: no network/CPU when tab is inactive; instant wake on return
  • RAM Optimized: per-server memory under 1MB via raw JSON string caching
  • Activation Queue: fair waitlist when cloud server hits its 500MB limit

Commands

Player Commands

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

Admin Commands

Command Description Permission
/eco <give|take|set> <player> <amount> [currency] Modify player balances 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

Permissions

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

Setup

  1. Download the latest Aurelium.jar
  2. Place it in your server's plugins/ folder
  3. Restart the server
    • If Vault is not detected, Aurelium automatically extracts and installs it on first run

Configuration

Database

database:
  type: sqlite          # sqlite or mysql
  file: "database.db"   # SQLite only
  mysql:                # MySQL only
    host: "localhost"
    port: 3306
    database: "aurelium"
    username: "root"
    password: "password"

Economy

economy:
  default-currency: "Aurels"
  currencies:
    Aurels:
      symbol: "₳"
      starting-balance: 100.0
  max-balance: -1       # -1 = unlimited
  min-pay-amount: 0.01

Market Items

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 Settings

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

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

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 Dashboard

web:
  enabled: true
  port: 8585
  # Session timeout: rolling 1 hour of inactivity (hardcoded)

Network Syncing (MySQL Required)

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:

  • Global Balances - player balances refreshed on join across the network
  • Global Auction House - active auctions and collection bin shared across all linked servers
  • Per-Server Markets - dynamic prices stored in each server's local config.yml, allowing different economies per server while players keep the same wallet

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 server console/logs for errors
  • Ensure you have Aurelium.jar in plugins/
  • Ensure you are running Paper (or compatible forks: Purpur, Pufferfish, Leaves)

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

👥 Team & Contributors

APPLEPIE6969
APPLEPIE6969Owner

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
paperpurpur
Minecraft Versions
26.126.1.126.1.2

🔗 Links

Modrinth Page