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)

repositories {
    mavenCentral()
    maven("https://repo.papermc.io/repository/maven-public/")
}

dependencies {
    compileOnly("com.olaneria.repo:olavault-api:1.0.2")
}

Gradle (Groovy DSL)

repositories {
    mavenCentral()
    maven { url 'https://repo.papermc.io/repository/maven-public/' }
}

dependencies {
    compileOnly 'com.olaneria.repo:olavault-api:1.0.2'
}

Maven (pom.xml)

<repositories>
    <repository>
        <id>papermc</id>
        <url>https://repo.papermc.io/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.olaneria.repo</groupId>
        <artifactId>olavault-api</artifactId>
        <version>1.0.2</version>
        <scope>provided</scope>
    </dependency>
</dependencies>