Patch Update: 8 May 2026

• Asynchronous Data Management: Rewrote the data-saving engine to handle player balances, levels, and auction listings on background threads. This eliminates main-thread lag during disk I/O operations.
• Automated Data Protection: Implemented a scheduled asynchronous auto-save task that triggers every 5 minutes to ensure zero data loss in case of unexpected server shutdowns.
• Smart Currency Formatting: Introduced the FormatUtil system to support readable currency suffixes (k, M, B, T, Q). This is integrated into the Scoreboard HUD, Balance commands, Leaderboards, and Shop GUIs.
• High-Performance UI: Updated the Scoreboard and Action Bar systems to utilize Paper's latest Component API, reducing overhead and improving text rendering efficiency.
• Thread-Safe Data Structures: Implemented collection cloning during save cycles to prevent ConcurrentModificationExceptions and ensure system stability under heavy load.

Features

• Advanced Economy: Secure balance management with Vault support and asynchronous processing.
• GUI Shop: Configurable category-based buy/sell shop with x1, x32, x64 quantity selection, /sell, and /sellhand.
• Auction House: Global /ah system for players to sell items to each other with background data persistence.
• RPG Leveling: Earn XP by killing mobs/mining. Higher levels = Higher money multipliers!
• Bank Notes: Withdraw physical money items to trade or store securely.
• Scoreboard HUD: Optimized sidebar display for Balance, Level, and Server Name using modern formatting.
• Leaderboards: View the richest players with /baltop using optimized asynchronous sorting.

Installation

1. Download the built TitanEconomy-1.1.jar.
2. Place it in your server's plugins folder.
3. [Optional but Recommended] Install Vault for compatibility with other plugins (like EssentialsX, GriefPrevention).
4. Restart your server.

Commands & Permissions

Player Commands

Admin Commands (Requires titaneconomy.admin)

Configuration

Adding Items to Shop

You can add unlimited items via plugins/TitanEconomy/shops.yml.

menus:
  food:
    items:
      golden_apple:
        material: GOLDEN_APPLE
        slot: 12
        name: '&6Golden Apple'
        buy: 100.0
        sell: 20.0

buy is the shop purchase price. sell is the price used by /sell and /sellhand.

Legacy entries that still use only price are migrated automatically on startup to buy and sell.

Scoreboard Configuration

You can customize the scoreboard title and footer in plugins/TitanEconomy/config.yml.

scoreboard:
  header: "  &6&lTITAN NETWORK  "
  footer: "&6play.titan.com"

⚔️ TitanEconomy

📂 View Source Code on GitHub

Open Source: Want to edit, customize, or contribute to this plugin? The full source code is available on GitHub!

TitanEconomy is a high-performance, all-in-one economy solution designed for modern Minecraft servers. Stop installing 5 different plugins when you can have one optimized core that handles everything.

Built specifically for Paper, Spigot, and Purpur servers.

✨ Key Features

🛒 Advanced GUI Shop

A professional shop system with no config hassle.

• Categories: Food, Weapons, Armor, Blocks, Ores, and more.
• Smart Buying: Select x1, x32, or x64 quantity with a single click.
• Configurable: Easily add items via shops.yml.

⚖️ Global Auction House

Let your players trade securely.

• Sell: /ah sell <price> to list items instantly.
• Buy: Browse the global GUI to purchase items from other players.
• Offline Support: Money goes straight to your bank even if you are offline.

📈 RPG Leveling System

Grind for status, not just money!

• Earn XP by killing mobs and mining resources.
• Multipliers: Higher levels = more money earned per action.
• Flex: Your level is displayed in the Chat and Scoreboard.

💵 Physical Bank Notes

Turn digital numbers into physical items.

• Withdraw money as a Bank Note item (/withdraw).
• Trade safely or store wealth in chests.
• Secure: Protected with NBT tags to prevent duping.

📊 Sleek Scoreboard HUD

No external plugins required.

• Displays Balance, Level, and Server Name on the sidebar.
• Zero-lag updates (only refreshes on data change).

📜 Commands & Permissions

⚙️ Configuration

Adding Items to Shop

Open plugins/TitanEconomy/shops.yml and add your items:

  diamond_sword:
    material: DIAMOND_SWORD
    slot: 10
    price: 500.0
    name: "&bGod Slayer"