OlaVault

# OlaVault A modern, thread-safe, and multi-currency replacement for the legacy Vault API, built for modern PaperMC servers. **OlaVault is an API, not a standalone feature plugin.** It acts as a bridge between plugins that *provide* economies, permissions, and chat formatting, and the plugins that want to *consume* those services (like Shops, Scoreboards, and GUIs). ## Why replace the original Vault? The original Vault plugin was incredible for its time, but as Minecraft servers have evolved (especially with Folia and multi-threading), the original API showed its age: * **Thread-Safety:** Legacy Vault was not thread-safe. OlaVault uses Folia-compatible lock-free lookups using `AtomicReference`. * **Float Errors:** Legacy Vault used `double` for currency, leading to floating-point rounding errors on large servers. OlaVault uses strict `BigDecimal` math. * **Multi-Currency:** Legacy Vault only supported a single global currency. OlaVault natively supports unlimited currencies. * **Event-Driven:** In the past, scoreboard plugins had to use laggy timers to check if a player's balance changed. OlaVault introduces 11 specialized Bukkit events (`EconomyTransactionEvent`, `PlayerGroupChangeEvent`, etc.) so plugins update instantly with zero lag. ## Installation If a plugin requires OlaVault, simply drop the `OlaVault.jar` into your `plugins/` folder and restart your server. That's it! ## For Developers OlaVault is published to Maven Central. ### Gradle (Kotlin DSL) ```kotlin repositories { mavenCentral() maven("https://repo.papermc.io/repository/maven-public/") } dependencies { compileOnly("com.olaneria.repo:olavault-api:1.0.2") } ``` ### Gradle (Groovy DSL) ```groovy repositories { mavenCentral() maven { url 'https://repo.papermc.io/repository/maven-public/' } } dependencies { compileOnly 'com.olaneria.repo:olavault-api:1.0.2' } ``` ### Maven (pom.xml) ```xml papermc https://repo.papermc.io/repository/maven-public/ com.olaneria.repo olavault-api 1.0.2 provided ```