Ledger - The Complete Economy API for Hytale

The Vault-like economy solution that Hytale servers need.

Ledger provides a unified, standardized economy API that allows plugin developers to easily integrate economy features without worrying about implementation details. Just like Vault did for Minecraft, Ledger does for Hytale.

Key Features

For Server Owners

Zero Configuration Required - Works out of the box with sensible defaults
Multiple Storage Options - JSON for simplicity, SQLite for performance
Transaction Logging - Full audit trail of all economy activity
Customizable Currency - Set your own currency name, symbol, decimals
Permission-Based Commands - Fine-grained control over who can do what

For Plugin Developers

Simple API - Deposit, withdraw, transfer in just a few lines of code
Fully Async - All operations return CompletableFuture for non-blocking calls
Event System - PreTransaction, PostTransaction, BalanceChange events
Multi-Currency Support - Register and manage multiple currencies
Account Caching - Built-in caching for optimal performance

Commands

Command	Description	Permission
`/balance`	Check your balance	ledger.balance
`/pay <player> <amount>`	Send money to another player	ledger.pay
`/baltop`	View the richest players	ledger.baltop
`/eco give/take/set`	Admin economy management	ledger.admin
`/ledger reload`	Reload configuration	ledger.admin.reload

Quick Start for Developers

// Get the economy service
EconomyService economy = Ledger.getEconomyOrThrow();

// Check balance
economy.getBalance(playerUuid).thenAccept(balance -> {
    System.out.println("Balance: " + balance);
});

// Deposit money
economy.deposit(playerUuid, 100.0);

// Withdraw money
economy.withdraw(playerUuid, 50.0);

// Transfer between players
economy.transfer(senderUuid, receiverUuid, 25.0);

Configuration

All settings are customizable via config.json:

Currency name, symbol, and decimals
Starting balance for new players
Minimum and maximum balance limits
Transaction limits and cooldowns
Storage type (JSON or SQLite)
Transaction logging on/off

Why Choose Ledger?

Standardization - One API for all economy plugins. No more compatibility issues.

Performance - Built with async operations and caching from the ground up.

Reliability - Transaction logging ensures no money is ever lost.

Extensibility - Event system allows other plugins to react to economy changes.

Support

Found a bug? Have a feature request?

Visit our GitHub repository

Ledger v1.1.0 - Made for the Hytale community by KarmaByte

Ledger - Opensource Economy API