TitanEconomy

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

Command	Description
/bal	Check your current wallet balance.
/pay	Send money to another player.
/withdraw	Convert balance into a physical Bank Note.
/shop	Open the server Shop GUI.
/sell	Open the sell menu for your inventory and hotbar.
/sellhand	Sell the full stack in your main hand.
/ah	Open the Auction House to buy items.
/ah sell	Sell the item in your hand on the Auction House.
/baltop	View the top 10 richest players.

Admin Commands (Requires titaneconomy.admin)

Command	Description
/eco give	Add money to a player's account.
/eco take	Remove money from a player's account.
/eco set	Set a player's balance to a specific amount.

---

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"