1.1
Compatibility
Changes
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
- Download the built TitanEconomy-1.1.jar.
- Place it in your server's plugins folder.
- [Optional but Recommended] Install Vault for compatibility with other plugins (like EssentialsX, GriefPrevention).
- 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.
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"
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:BNhJSUqR:Dq51lkxT"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:BNhJSUqR:Dq51lkxT"
}

