OlaEconomy

Developer API & Events

OlaEconomy is the most interceptable economy plugin in existence. We provide two distinct ways for developers to hook into the engine.

1. The Native API Class

If you want to interact with String-based accounts (like a Guild Bank) or bypass Vault entirely:

import com.olaneria.olaeconomy.api.OlaEconomyAPI;

// Deposit natively into a String-based identifier
OlaEconomyAPI.deposit("guild-12345", BigDecimal.valueOf(500), "coins");

// Query the massive SQL Ledger directly!
CompletableFuture<List<TransactionEntry>> history = OlaEconomyAPI.getTransactionHistory("guild-12345");

2. Advanced Event Hooks

We provide 7 custom Events in the com.olaneria.olaeconomy.api.events package that fire natively through the Bukkit EventBus:

• OlaEconomyTaxEvent: Dynamically change /pay tax rates or route funds on the fly based on player location.
• OlaEconomyBanknoteDepositEvent: Cancel banknote redemptions or deduct convenience fees.
• OlaEconomyBanknoteCreateEvent: Inject custom lore or enchantments into a Banknote ItemStack before it's given to the player.
• OlaEconomyBaltopCalculateEvent: Hide secret admin string-identifiers from the public /baltop leaderboard.
• OlaEconomyMultiplierCalculateEvent: Mathematically inject global multipliers (e.g. a Weekend 2.0x Boost event) overriding permission nodes!
• OlaEconomyPreTransactionLogEvent: Create "Ghost Transactions" by cancelling the SQL logging before it commits.
• OlaEconomyRedisSyncEvent: Temporarily pause cross-server payload syncs for a player trapped in an isolated Minigame arena.