⚡ Conduit

A modern Economy abstraction for Minecraft

Documentation · Source · Maven

Important Note: This plugin depends on adoption from developers. This plugin may not immediately be compatible with the current Economy plugins. I have provided "Bridges" to attempt to close this gap until adoption grows.

Conduit is a clean, single-purpose economy abstraction for Paper and Folia. One interface, many backends: the plugins that spend money and the plugin that stores it never touch each other. It is async-first, BigDecimal-everywhere, and UUID-native, built for modern Minecraft (26.1+, Java 25).

It is not a Vault fork or a drop-in replacement. It is its own API under so.alaz.conduit, designed to fix the things Vault never could.

Why Conduit

Vault's idea was right, but its execution froze a decade ago: player names, synchronous calls that block the main thread, double money, no events, and no Folia support. Conduit keeps the abstraction concept and fixes the execution.

Async by default. Every operation returns a CompletableFuture. Nothing blocks the server thread, so a database-backed economy never costs you TPS.
BigDecimal everywhere. No double anywhere in the API, so rounding errors can never quietly eat a balance.
UUID-first. Accounts are keyed by UUID. Player renames never corrupt balances.
Capability-aware. Banks, multiple currencies, transaction history, and leaderboards are opt-in extension interfaces. Plugins ask what a provider supports before they call it, so there are no UnsupportedOperationException surprises.
Events and interceptors. React to every transaction after it commits, or veto one before it happens (anti-cheat, spending limits, and more).
🪶 Folia-ready. Works on the latest high-performance, multi-threaded servers.

For server owners

Conduit is an abstraction layer. It does not store balances itself. You also need an economy provider: either an economy plugin that supports Conduit natively, or a bridge that adapts an existing one (for example the official EssentialsX bridge).

Requirements


Server	Paper or Folia
Minecraft	26.1 or newer
Java	25

Install

Drop Conduit.jar into your plugins/ folder.
Install an economy provider or bridge (for example EssentialsX plus the Conduit EssentialsX bridge).
Start the server and run /conduit to confirm an active provider is detected.

Anonymous usage metrics are off by default (you opt in), and an optional update checker can notify you of new releases. Conduit sends nothing unless you enable it.

For plugin developers

Add the API as a compileOnly dependency. The runtime classes ship inside the installed Conduit plugin, so you never bundle them.

We recommend visiting https://alaz.so/conduit/docs/consumer-guide for more information on interacting with Conduit API as a consumer.

repositories {
    maven("https://repo.alaz.so/releases")
}

dependencies {
    compileOnly("so.alaz.conduit:conduit-api:0.3.4")
}

Resolve the economy and move money around, fully async, with a typed result you pattern-match:

Conduit.whenProviderAvailable(Economy.class, economy ->
    economy.deposit(playerId, new BigDecimal("100.00"), "daily reward")
        .thenAccept(result -> result.ifSuccess(s ->
            getLogger().info("New balance: " + economy.format(s.newBalance())))));

No load-order races, no main-thread blocking, no double. Full guides for consumers, providers, bridges, and migrating from Vault live at alaz.so/conduit/docs.

Bridges

Conduit talks to existing economy plugins through hot-pluggable bridges. The team maintains a small set of reference bridges (EssentialsX); the rest are community-built from a documented template plus a conformance test suite, so every bridge behaves like every other economy from a consumer's point of view.

For more information, please visit: https://alaz.so/conduit/docs/building-a-bridge

Not a Vault replacement

Conduit does not ship net.milkbowl.vault.* shims and does not let Vault plugins run unchanged. It is economy-only by design. If you need permissions, use LuckPerms; if you need chat formatting, use a chat plugin; if you want Vault, keep Vault. Conduit is for plugins and servers that deliberately adopt so.alaz.conduit.api for economy.