Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
[1.0.0] - 2026-09-04
🚀 OlaEconomy Initial Release
Welcome to the most advanced, high-performance economy engine ever built for PaperMC and Velocity! This initial release brings a massive suite of enterprise-grade features designed to completely redefine how server economies operate.
🌟 Core Architecture
- String-Based Engine: Completely abandoned archaic UUID-only architectures. You can now effortlessly create native bank accounts for Guilds, Factions, Towns, and special events (e.g.
"guild-12345","server-treasury"). - OlaVault Native: Built directly on top of the lightning-fast OlaVault async API. (Legacy Vault is entirely unsupported to ensure maximum performance).
- Massive Network Sync: Natively integrated Redis Pub/Sub support. Player balances synchronize in real-time across your entire BungeeCord or Velocity network with a resilient auto-reconnect engine.
💾 High-Performance Database
- HikariCP Thread Pools: Implemented robust asynchronous SQL pooling supporting both local SQLite and massive networked MariaDB servers.
- O(1) Caffeine Caching: Balances are loaded into dynamic RAM. Memory footprint is infinitely scalable in the config (
cache.max_size). Zero main-thread lag. - Automated Ledger Purging: The engine permanently logs every transaction to an
ola_transactionsledger. The new automated purger safely truncates ancient logs in the background on startup to keep MariaDB blazing fast.
💰 Economy Mechanics
- Unlimited Dynamic Currencies: Natively supports Coins, Gems, Tokens, and anything else you can invent with automatic singular/plural name formatting.
- Dynamic Multipliers: Bind multiplier values (e.g.,
2.0x) directly to permission nodes (likeolaeconomy.multiplier.vip). Multipliers can be applied globally, or explicitly to specific currencies! - Transaction Taxes: Implement global inflation-fighting taxes on all
/paycommands, with the option to dynamically route collected funds to a specific String account! - Physical Banknotes: Players can
/withdrawtheir money into unforgeablePersistentDataContainerphysical items. - Passive Interest: Built-in background cron jobs automatically pay online players a configurable interest percentage on a recurring timer.
- Maximum Balance Caps: Enforce hard caps on digital wealth to prevent hyperinflation and integer overflows.
🖥️ Quality of Life
- PlaceholderAPI (PAPI): Hooked natively into PAPI for Holograms, Tablists, and Scoreboards (
%olaeconomy_balance%,%olaeconomy_baltop_name_1%). - Native Tab-Completion: Full Bukkit tab-completion for all commands, including dynamic online player resolution for
/pay. - Paginated Baltop: Asynchronously sorted
/baltop [page]that never freezes the server thread. - Robust Offline Resolution: Typing
/pay Notch 50natively queries anola_playerslookup table, asynchronously resolving Notch's UUID even if they've been offline for years.
🔌 Developer API
OlaEconomyAPIClass: Exposed a powerful static API for third-party developers to easily deposit/withdraw into custom String-based Faction banks.- Advanced Event Suite: Hooked 7 custom native Bukkit events (
OlaEconomyTaxEvent,OlaEconomyBanknoteDepositEvent,OlaEconomyBaltopCalculateEvent,OlaEconomyRedisSyncEvent, etc.) allowing developers to intercept and modify every single micro-interaction within the engine.
Platforms
Paper
1.20–26.2
Dependencies
Paper
- OlaVault
- PlaceholderAPI Optional