Ledger - Opensource Economy API

The most powerful Economy API for Hytale - Multiple currencies, events, async API, transaction logging.

94.0 загрузок

Обновлён 19 дней назад

Геймплей Библиотека Утилиты Разное

Скачать последнюю версию (13.2 МБ)

Описание

Ledger - Полный экономический API для Hytale

Экономичное решение Vault, необходимое серверам Hytale.

Ledger предоставляет унифицированный, стандартизированный API, который позволяет разработчикам плагинов легко интегрировать функции экономики, не беспокоясь о деталях реализации. Как и Vault для Minecraft, Ledger для Hytale.

Ключевые особенности

Для владельцев серверов

Нулевая конфигурация требуемый Работает вне коробки с разумными по умолчанию
Несколько вариантов хранения JSON для простоты, SQLite для производительности
Регистрация сделок Полный аудит всей экономической деятельности
Настраиваемая валюта - Установите собственное имя валюты, символ, десятичные числа
Командования, основанные на разрешении Прекрасный контроль над тем, кто может что

Для разработчиков плагинов

Простой API Депозит, вывод, передача всего в нескольких строках кода
Полностью Async Все операции возвращают CompletableFuture для неблокирующих вызовов
Система событий - Претранзакция, посттранзакция, баланс Измените события
Многовалютная поддержка Регистрация и управление несколькими валютами
Кэширование аккаунта - Встроенный кэш для оптимальной производительности

командование

Командование	Описание	Разрешение
`/ Баланс`	Проверьте свой баланс	бухгалтерский баланс
`/pay <player> <amount>`	Отправить деньги другому игроку	Регистр.pay
`бальто`	Посмотреть Самые богатые игроки	бухгалтерский учет.
`/eco give/take/set`	Административное управление экономикой	Руководитель.
`/ledger скачать`	Конфигурация загрузки	ledger.admin.reload

Быстрый старт для разработчиков

// Получить экономический сервис
Экономика услуг = Ledger.getEconomyOrThrow();

Проверить баланс
economy.getBalance (playerUuid).thenAccept (баланс -> {)
System.out.println («Баланс: + баланс»)
}

// Депозитные деньги
economy.deposit (playerUuid, 100.0);

// Снять деньги
economy.withdraw (playerUuid, 50.0);

Трансфер между игроками
economy.transfer (SenderUuid, receiverUuid, 25.0);

конфигурация

Все настройки настраиваются через config.json:

Название валюты, символ и десятичные знаки
Начало баланса для новых игроков
Минимальные и максимальные лимиты баланса
Ограничения транзакций и охлаждение
Тип хранилища (JSON или SQLite)
Регистрация транзакций on/off

Почему выбирают Ledger?

Стандартизация Один API для всех экономических плагинов. Больше никаких проблем с совместимостью.

Выступление - Построена с асинхронными операциями и кэшированием с нуля.

Надежность Регистрация транзакций гарантирует, что деньги никогда не будут потеряны.

расширяемость Система событий позволяет другим плагинам реагировать на изменения в экономике.

Поддержка

Нашёл жучок? Есть запрос на функцию?

Посетите наш Репозиторий GitHub

Ledger v1.1.0 - Сделано для сообщества Hytale

Показать оригинальное описание (English)

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);