简易经济

简易经济

一个全面的Hytale服务器经济插件，提供玩家余额、银行账户以及兼容Cassaforte经济接口的完整经济API。该模组不涉及真实货币交易。

游戏玩法

SimpleEconomy

一款为 Hytale 服务器设计的高性能、轻量级经济系统

SimpleEconomy 是一款专为 Hytale 服务器设计的全面经济管理插件。无论您是在运营小型私人服务器还是大型社区网络，SimpleEconomy 都能为您提供轻松管理服务器金融系统所需的所有工具。

功能特性

核心经济系统

  • 玩家余额 - 追踪每位玩家的货币，首次加入时自动创建账户。
  • 银行账户 - 创建支持多名成员及所有权管理的共享银行账户。
  • 玩家间转账 - 通过直观的命令在玩家之间轻松转移货币。
  • 财富排行榜 - 使用 /bal top 查看服务器上最富有的前 10 名玩家。
  • 基于 UUID 的系统 - 使用 Hytale 的 UUID 系统实现可靠的玩家识别。
  • 自定义货币 - 使用自定义货币名称个性化您的经济系统。

性能与可靠性

  • 闪电般快速 - 采用智能缓存技术，实现即时余额查询。
  • 异步操作 - 所有数据库操作均在后台进行，防止服务器卡顿。
  • 多数据库支持 - 可在 SQLite（设置简单）或 PostgreSQL（针对大型服务器优化）之间选择。
  • 自动配置 - 开箱即用，提供合理的默认设置，完全可根据您的需求自定义。

对开发者友好

  • 标准 API 集成 - 实现了 Cassaforte Economy API，确保与其他插件的兼容性。
  • 清晰的架构 - 使用 Kotlin 构建的现代化代码库，兼具可靠性和高性能。

命令

玩家命令

命令 描述 权限
/balance
/bal
/money		 查看您的余额 economy.user
/balance <玩家>
/bal <玩家>
/money <玩家>		 查看其他玩家的余额 economy.user
/balance top
/bal top
/money top		 显示前 10 名最富有的玩家 economy.user
/pay <玩家> <金额> 向另一名玩家发送货币 economy.user
/bank create <名称> 创建一个新的银行账户 economy.user
/bank balance <名称> 查看一个银行的余额 economy.user
/bank deposit <银行名> <金额> 向银行账户存入货币 economy.user
/bank withdraw <银行名> <金额> 从银行账户取出货币 economy.user

管理员命令

命令 描述 权限
/eco give <玩家> <金额> 给予玩家货币 economy.admin
/eco take <玩家> <金额> 移除玩家的货币 economy.admin
/eco set <玩家> <金额> 将玩家余额设置为指定数额 economy.admin
/eco reset <玩家> 将玩家余额重置为零 economy.admin

配置

SimpleEconomy 在首次启动时会创建一个配置文件 (economy_config.json)，其中包含可自定义的选项：

经济设置

  • 货币名称 - 设置货币的单数和复数名称（默认："coin" / "coins"）。
  • 小数位数 - 控制货币显示的小数位数（设置为 -1 为无小数）。
  • 初始余额 - 设置新玩家的初始余额。
  • 自动创建账户 - 当玩家加入时自动创建账户（可禁用）。

数据库选项

SQLite (默认) - 适用于大多数服务器

  • 无需额外设置
  • 基于文件的存储，位置在 economy_data/economy.db
  • 适合中小型服务器

PostgreSQL - 用于高性能网络

  • 连接池以实现最佳性能
  • 可配置的主机、端口和凭证
  • 推荐用于玩家数量众多的服务器

权限

SimpleEconomy 使用直观的权限系统：

  • economy.user - 标准玩家权限（默认授予所有玩家）

    • 可使用所有玩家和银行命令
    • 查看余额和进行付款

  • economy.admin - 管理员权限（自动授予服务器管理员）

    • 可使用所有 /eco 管理命令
    • 完全控制玩家余额

权限与 Hytale 原生的权限系统无缝集成，并可分配给单个玩家或权限组。

集成与 API

SimpleEconomy 实现了 Cassaforte Economy API，确保与其他启用了经济系统的插件和服务兼容。这种标准集成允许：

  • 其他插件查看和修改玩家余额
  • 在您的插件生态系统中实现一致的经济行为
  • 与未来经济扩展的未来兼容性

财富排行榜

/bal top 命令以精美的奖牌排名展示服务器中最富有的玩家：

=== Top 10 Richest Players ===

🥇 PlayerName1: 50,000 coins
🥈 PlayerName2: 42,500 coins
🥉 PlayerName3: 38,000 coins
#4 PlayerName4: 25,000 coins
#5 PlayerName5: 21,000 coins
...

非常适合用于：

  • 服务器竞赛和活动
  • 经济状况监测
  • 激励玩家和提升参与度

快速入门

  1. 安装 - 将插件放入服务器的插件文件夹中。
  2. 重启 - 启动您的服务器以生成配置文件。
  3. 配置 (可选) - 编辑 economy_config.json 文件以自定义设置。
  4. 游玩 - 经济系统已准备就绪！玩家账户会自动创建。

系统要求

  • Hytale 服务器
  • Java 运行环境

支持

需要帮助？有建议？请在项目页面上报告问题。

SimpleEconomy - 让 Hytale 服务器的经济管理变得简单。