ENEconomy

📄 文档

ENEconomy 是一款轻量级且高效能的模组，旨在为任何 Hytale 服务器实现完整的经济系统。它通过直观的指令及对本地存储和 MySQL 的支持，为管理服务器资金提供了一套稳健的解决方案。

✨ 关键特性

💰 完整财务系统

余额管理： 玩家可随时查询余额
玩家间转账： 安全的 P2P 支付系统
灵活管理： 全面的管理员工具
双重存储： 支持 MySQL 或本地 JSON 文件

🎯 可用指令

玩家指令：

/balance - 查询当前余额
/pay <玩家> <金额> - 向其他玩家转账
/baltop [页数] - 查看财富排行榜

管理指令：

/eco help - 显示所有可用指令
/eco give <玩家> <金额> - 给予玩家金钱
/eco set <玩家> <金额> - 设定玩家余额
/eco reset <玩家> - 将余额重置为默认值
/eco stats - 显示服务器统计信息（流通总额、转账次数、支付次数）
/eco reload - 重载模组配置

🔧 可定制配置

config.yml 文件允许您全面调整经济系统：

# 基础配置
default_money: 500 # 新玩家的初始金钱
currency_symbol: "$" # 货币符号
currency_name: "Dollars" # 货币名称
decimal_places: 2 # 允许的小数位数

# 数据库
mysql: true # true 为 MySQL，false 为 JSON
db-name: "s58_asad" # 数据库名称
db-endpoint: "104.243.47.43:3306" # MySQL 服务器 IP 地址和端口
db-username: "u58_YCPlXnYhY6" # 数据库用户名
db-password: "2.8qkG71KAB..." # 数据库密码

# 性能
baltop_refresh_seconds: 300 # 排行榜刷新时间（秒）

面向开发者的公共 API

ENEconomy 提供了完整的 API，供其他模组集成：

可用函数：

查看玩家余额
修改余额（增加/减少资金）
检查玩家是否有足够资金
监听实时经济事件

事件系统：

EconomyTransactionEvent - 任何交易时触发

BalanceChangeEvent - 玩家余额变化时触发

PaymentEvent - 专门针对 /pay 指令的交易触发

💾 数据存储

MySQL (mysql: true)： 适用于大型服务器，支持多实例间同步。
本地 JSON (mysql: false)： 适用于小型服务器，数据存储在 players.json 中。