ВЕРСИИ (2)

## 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 <player> <amount> | Send money to another player. | | /withdraw <amount> | 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 <price> | 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 <player> <amt> | Add money to a player's account. | | /eco take <player> <amt> | Remove money from a player's account. | | /eco set <player> <amt> | Set a player's balance to a specific amount. | --- ## Configuration ### Adding Items to Shop You can add unlimited items via plugins/TitanEconomy/shops.yml. ```yaml 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. ```yaml scoreboard: header: " &6&lTITAN NETWORK " footer: "&6play.titan.com" ```

# ⚔️ TitanEconomy [**📂 View Source Code on GitHub**](https://github.com/Sunnymittal112/Minecraft-Custom-Economy-including-shop) > **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 | Command | Description | Permission | | :--- | :--- | :--- | | `/bal` | Check wallet balance. | None | | `/shop` | Open the Server Shop. | None | | `/ah` | Open the Auction House. | None | | `/withdraw <amount>` | Create a Bank Note. | None | | `/pay <player> <amount>` | Send money to a player. | None | | `/baltop` | View top 10 richest players. | None | | `/eco <give/take/set>` | Admin money management. | `titaneconomy.admin` | --- ## ⚙️ Configuration ### Adding Items to Shop Open `plugins/TitanEconomy/shops.yml` and add your items: ```yaml diamond_sword: material: DIAMOND_SWORD slot: 10 price: 500.0 name: "&bGod Slayer"