SG-Economy 应用程序接口

SG-Economy 应用程序接口

为Minecraft添加了一个可扩展的经济系统,允许模组通过统一API定义、存储和同步货币及玩家余额。

SG经济API

v26.1.0 Discord

概述

SG经济API 为Minecraft添加了一个灵活、现代且可扩展的经济系统。它作为一个模组API,允许玩家、整合包作者、开发者以及服务器管理员以简单且一致的方式创建和集成自定义经济系统。

该经济系统基于持久化的数值余额,直接与玩家数据关联。该余额不以游戏内物品形式呈现,而是作为一个“虚拟钱包”,其名称、含义和用途可根据实现方式或与其他模组的集成而有所不同。

主要特性

💰 灵活的货币系统

支持配置为使用整数或小数数值,使经济适应不同的使用场景(简单货币、带分币的系统等)。配置通过文件完成,并直接影响所存储余额的格式。

🔧 开发者API

提供有文档说明的类和方法,用于:

  • 查询和修改玩家余额
  • 与其他模组的原生集成
  • 创建自定义经济系统

GitHub仓库中包含实用示例和实现指南。

🛠️ 管理命令

包含游戏内经济管理的命令,允许:

  • 余额查询
  • 添加、设定或扣除数值
  • 玩家之间的余额转账(可选)

这些命令可根据服务器需求启用或禁用。

🖥️ 显示界面

在物品栏界面和/或屏幕上以可视化且可配置的方式显示玩家的经济余额。显示内容仅反映玩家数据中存储的数值,与实体物品无关。

⚙️ 配置文件

配置文件允许自定义经济系统的行为,包括货币格式、余额保留规则、可用命令以及界面显示选项。