TideEconomy

插件

· 作者 Suttanfix

一款独立的经济插件,功能全面。

0 本站下载 0 关注 更新于 1 个月前

最新 1.1.0 · 26.1.2 · Paper / Spigot

一键开服(送7天)

TideEconomy (下滑可找到中文翻译)

一个轻量级的独立经济核心插件,为 Minecraft 提供基础货币系统和 HTTP API 接口。

简介

TideEconomy 是一个独立的經濟核心插件,为你的服务器提供完整的货币系统。它内置了 coin 货币,按玩家 UUID 存储资产数据,并提供游戏内命令和 HTTP API,便于与其他插件集成。

  • 独立经济核心:不依赖 Vault 或其他经济插件
  • HTTP API:其他插件可以通过 HTTP POST 请求管理玩家资产
  • 数据持久化:资产数据以 JSON 格式存储,安全可靠
  • 完整日志记录:所有资产变更和错误均被记录

功能

  • 内置 coin 货币,按玩家 UUID 存储
  • 游戏内命令:查询余额、转账和管理操作
  • HTTP API 服务器,用于与其他插件集成
  • SHA-256 passkey 认证
  • 完整操作日志(北京时间)
  • 资产数据持久化至 JSON
  • 安全检查,如防止负余额和溢出

安装

  1. 下载最新版本的 TideEconomy.jar
  2. 将 jar 文件放入服务器的 plugins/ 目录
  3. 重启服务器或使用插件管理器加载

配置

配置文件位置:plugins/TideEconomy/config.yml

enableapiserver: true   # 是否启用 API 服务器
apiserverport: 7200     # API 服务器端口
passkey: "77664455"     # Passkey(明文)

修改配置后,运行 /te_reload 或重启插件以使更改生效。

命令

/coin

查看自己的余额。

  • 权限:任何玩家
  • 用法:/coin
  • 示例:执行后显示 Your balance: 100 coin

/pay <player> <count>

向其他玩家转账。

  • 权限:任何玩家
  • 参数:
    • <player>:目标玩家 ID
    • <count>:转账金额(必须为 ≥ 1 的整数)
  • 示例:/pay Steve 100

/te_admin <action> <player> <count>

作为管理员修改玩家的余额。

  • 权限:仅限 OP
  • 参数:
    • <action>:操作类型,可为 add、take 或 set
    • <player>:目标玩家 ID
    • <count>:金额
  • 示例:
    • /te_admin add Steve 100(增加 100)
    • /te_admin take Steve 50(扣除 50)
    • /te_admin set Steve 200(设置为 200)

/te_reload

重新加载配置文件并重启 API 服务器。

  • 权限:仅限 OP
  • 用法:/te_reload

HTTP API

TideEconomy 内置了一个 HTTP API 服务器,允许其他插件通过 POST 请求管理玩家资产。

端点概览

端点 路径 描述
添加资产 /addplayercoin 为玩家增加金币
扣除资产 /takeplayercoin 从玩家处扣除金币
覆盖资产 /setplayercoin 将玩家的余额设置为指定值

请求格式

所有端点均使用 POST 请求,并附带 JSON 格式的请求体:

{
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "value": 100,
  "passkey": "77664455"
}
字段 类型 描述
uuid string 目标玩家的 UUID
value long 金额
passkey string 通行密钥(明文)

响应格式

成功:

{
  "success": true,
  "message": "操作成功",
  "balance": 200
}

失败:

{
  "success": false,
  "message": "操作失败(金额验证失败或余额不足)"
}

调用示例

curl -X POST http://127.0.0.1:7200/addplayercoin \
  -H "Content-Type: application/json" \
  -d '{"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","value":100,"passkey":"77664455"}'

完整的 API 文档请参阅项目仓库中的 API.md。

数据存储

  • 资产数据:plugins/TideEconomy/data.json(按 UUID 存储)
  • 通行密钥哈希:plugins/TideEconomy/passkey.txt
  • 操作日志:plugins/TideEconomy/process.log

权限

权限节点 描述 默认值
tideeconomy.admin 管理员命令权限 (te_admin, te_reload) OP

常见问题

Q: 为什么 API 请求返回 403? A: API 服务器仅接受来自 127.0.0.1 的请求。请确保从本地机器进行调用。

Q: 为什么 API 请求返回 401? A: 通行密钥不正确。请确认请求中的 passkey 与 config.yml 中的值匹配,并且在修改配置后已执行 /te_reload。

Q: 玩家的余额可以为负数吗? A: 不可以。插件会阻止任何会导致余额为负的操作。

Q: 其他插件如何与其集成? A: 其他插件可以通过 HTTP POST 请求调用 API 端点。详细信息请参阅 API 文档。

如果您在使用过程中遇到任何问题或有建议,请联系作者 Suttanfix:qq3954519717

TideEconomy

一个轻量级的 Minecraft 独立经济核心插件,提供基础货币系统与 HTTP API 接口。

简介

TideEconomy 是一个独立的经济核心插件,为你的服务器提供一套完整的货币系统。它内置 coin 货币,按玩家 UUID 存储资产数据,并提供游戏内命令与 HTTP API 两种操作方式,方便其他插件集成。

  • 独立经济核心:不依赖 Vault 或其他经济插件
  • HTTP API:其他插件可通过 HTTP POST 请求操作玩家资产
  • 数据持久化:资产数据以 JSON 格式存储,安全可靠
  • 完整日志:所有资产变动与错误均记录在案

功能特性

  • 内置 coin 货币,按玩家 UUID 存储
  • 游戏内命令:查看资产、转账、管理操作
  • HTTP API 服务器,供其他插件集成
  • SHA-256 通行密钥认证
  • 完整的操作日志(北京时间)
  • 资产数据 JSON 持久化
  • 防负数、防溢出等安全校验

安装

  1. 下载最新版本的 TideEconomy.jar
  2. 将 jar 文件放入服务器的 plugins/ 目录
  3. 重启服务器或使用插件管理器加载

配置

配置文件位置:plugins/TideEconomy/config.yml

enableapiserver: true   # 是否启用 API 服务器
apiserverport: 7200     # API 服务器端口
passkey: "77664455"     # 通行密钥(明文)

修改配置后,执行 /te_reload 或重启插件以生效。

命令

/coin

查看自己的资产。

  • 权限:任何玩家
  • 用法:/coin
  • 示例:执行后显示 你的资产:100 coin

/pay <player> <count>

向其他玩家转账。

  • 权限:任何玩家
  • 参数:
    • <player>:目标玩家 ID
    • <count>:转账金额(必须 ≥ 1 的整数)
  • 示例:/pay Steve 100

/te_admin <action> <player> <count>

以管理员身份修改玩家资产。

  • 权限:仅 OP
  • 参数:
    • <action>:操作类型,可选 add(增加)、take(扣除)、set(设定)
    • <player>:目标玩家 ID
    • <count>:金额
  • 示例:
    • /te_admin add Steve 100(增加 100)
    • /te_admin take Steve 50(扣除 50)
    • /te_admin set Steve 200(设定为 200)

/te_reload

重载配置文件并重启 API 服务器。

  • 权限:仅 OP
  • 用法:/te_reload

HTTP API

TideEconomy 内置 HTTP API 服务器,允许其他插件通过 POST 请求操作玩家资产。

接口概览

接口 路径 说明
增加资产 /addplayercoin 为玩家增加 coin
扣除资产 /takeplayercoin 从玩家扣除 coin
覆盖资产 /setplayercoin 将玩家资产设定为指定值

请求格式

所有接口均为 POST 请求,请求体为 JSON:

{
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "value": 100,
  "passkey": "77664455"
}
字段 类型 说明
uuid string 目标玩家 UUID
value long 金额
passkey string 通行密钥(明文)

响应格式

成功:

{
  "success": true,
  "message": "操作成功",
  "balance": 200
}

失败:

{
  "success": false,
  "message": "操作失败(金额校验不通过或余额不足)"
}

调用示例

curl -X POST http://127.0.0.1:7200/addplayercoin \
  -H "Content-Type: application/json" \
  -d '{"uuid":"069a79f4-44e9-4726-a5be-fca90e38aaf5","value":100,"passkey":"77664455"}'

完整 API 文档请参阅项目仓库中的 API.md。

数据存储

  • 资产数据:plugins/TideEconomy/data.json(按 UUID 存储)
  • 通行密钥哈希:plugins/TideEconomy/passkey.txt
  • 操作日志:plugins/TideEconomy/process.log

权限

权限节点 说明 默认
tideeconomy.admin 管理命令权限(te_admin、te_reload) OP

常见问题

Q:为什么 API 请求返回 403? A:API 服务器仅接受来自 127.0.0.1 的请求,请确保从本机调用。

Q:为什么 API 请求返回 401? A:通行密钥错误。请确认请求中的 passkey 与 config.yml 中的值一致,且修改配置后已执行 /te_reload。

Q:玩家资产可以为负数吗? A:不可以。插件会阻止任何导致资产为负数的操作。

Q:如何让其他插件集成? A:其他插件可通过 HTTP POST 请求调用 API 接口,详见 API 文档。

如在使用中发现问题或有建议,可联系作者 Suttanfix: qq3954519717

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源