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

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