Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Olaneria

The all new modern economy system.

Report OlaEconomy?

R

1.0.0

[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_transactions ledger. 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 (like olaeconomy.multiplier.vip). Multipliers can be applied globally, or explicitly to specific currencies!
  • Transaction Taxes: Implement global inflation-fighting taxes on all /pay commands, with the option to dynamically route collected funds to a specific String account!
  • Physical Banknotes: Players can /withdraw their money into unforgeable PersistentDataContainer physical 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 50 natively queries an ola_players lookup table, asynchronously resolving Notch's UUID even if they've been offline for years.

🔌 Developer API

  • OlaEconomyAPI Class: 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.

Information

Published
September 5, 2026
Author
0Downloads

Platforms

Paper
Paper
1.20–26.2

Dependencies

PaperPaper

Dependencies: Paper

Plugins and libraries a server needs for this version to run.

No dependencies

Add anything a server has to install alongside this version.