Ledger - 开源经济 API

Ledger - 开源经济 API

最强大的Hytale经济API - 多种货币、事件、异步API、交易记录。

图书馆

Ledger - Hytale 的完整经济 API

Hytale 服务器所需的 Vault 式经济解决方案。

Ledger 提供了一个统一、标准化的经济 API，允许插件开发者轻松集成经济功能，而无需担心实现细节。正如 Vault 之于 Minecraft，Ledger 之于 Hytale。

主要特点

对于服务器所有者

  • 零配置要求 - 开箱即用，默认设置合理
  • 多种存储选项 - JSON 简洁，SQLite 高性能
  • 交易日志 - 所有经济活动的完整审计追踪
  • 可定制货币 - 设置你自己的货币名称、符号、小数位数
  • 基于权限的命令 - 精细控制谁可以做什么

对于插件开发者

  • 简单 API - 只需几行代码即可实现存款、取款、转账
  • 完全异步 - 所有操作返回 CompletableFuture，实现非阻塞调用
  • 事件系统 - PreTransaction、PostTransaction、BalanceChange 事件
  • 多货币支持 - 注册和管理多种货币
  • 账户缓存 - 内置缓存以实现最佳性能

命令

命令 描述 权限
/balance 查看你的余额 ledger.balance
/pay <玩家> <金额> 向其他玩家发送货币 ledger.pay
/baltop 查看最富有的玩家 ledger.baltop
/eco give/take/set 管理员经济管理 ledger.admin
/ledger reload 重新加载配置 ledger.admin.reload

开发者快速入门

// 获取经济服务
EconomyService economy = Ledger.getEconomyOrThrow();

// 检查余额
economy.getBalance(playerUuid).thenAccept(balance -> {
    System.out.println("余额：" + balance);
});

// 存款
economy.deposit(playerUuid, 100.0);

// 取款
economy.withdraw(playerUuid, 50.0);

// 玩家间转账
economy.transfer(senderUuid, receiverUuid, 25.0);

配置

所有设置均可通过 config.json 自定义：

  • 货币名称、符号和小数位数
  • 新玩家的初始余额
  • 最小和最大余额限制
  • 交易限制和冷却时间
  • 存储类型（JSON 或 SQLite）
  • 交易日志开关

为什么选择 Ledger？

标准化 - 一个适用于所有经济插件的 API。不再有兼容性问题。

性能 - 从头开始构建，支持异步操作和缓存。

可靠性 - 交易日志确保不会丢失任何资金。

可扩展性 - 事件系统允许其他插件对经济变化做出反应。

支持

发现了一个错误？有功能请求？

请访问我们的 GitHub 仓库

Ledger v1.1.0 - 由 KarmaByte 为 Hytale 社区制作