Ledger - Opensource Economy API

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