TideEconomy （下滑可找到中文翻译）

A lightweight standalone economy core plugin for Minecraft, providing a basic currency system and an HTTP API interface.

Introduction

TideEconomy is a standalone economy core plugin that provides a complete currency system for your server. It has a built-in coin currency, stores asset data by player UUID, and provides both in-game commands and an HTTP API for easy integration with other plugins.

Standalone economy core: Does not depend on Vault or other economy plugins
HTTP API: Other plugins can manage player assets through HTTP POST requests
Data persistence: Asset data is stored in JSON format, safe and reliable
Complete logging: All asset changes and errors are recorded

Features

Built-in coin currency, stored by player UUID
In-game commands: check balance, transfer, and management operations
HTTP API server for integration with other plugins
SHA-256 passkey authentication
Complete operation logs (Beijing time)
Asset data persisted in JSON
Safety checks such as preventing negative balances and overflow

Installation

Download the latest version of TideEconomy.jar
Place the jar file into the server's plugins/ directory
Restart the server or load it using a plugin manager

Configuration

Configuration file location: plugins/TideEconomy/config.yml

enableapiserver: true   # Whether to enable the API server
apiserverport: 7200     # API server port
passkey: "77664455"     # Passkey (plaintext)

After modifying the configuration, run /te_reload or restart the plugin for the changes to take effect.

Commands

`/coin`

Check your own balance.

Permission: Any player
Usage: /coin
Example: After execution, it displays Your balance: 100 coin

`/pay <player> <count>`

Transfer money to another player.

Permission: Any player
Arguments:
- <player>: Target player ID
- <count>: Transfer amount (must be an integer ≥ 1)
Example: /pay Steve 100

`/te_admin <action> <player> <count>`

Modify a player's balance as an administrator.

Permission: OP only
Arguments:
- <action>: Operation type, can be add, take, or set
- <player>: Target player ID
- <count>: Amount
Examples:
- /te_admin add Steve 100 (add 100)
- /te_admin take Steve 50 (deduct 50)
- /te_admin set Steve 200 (set to 200)

`/te_reload`

Reload the configuration file and restart the API server.

Permission: OP only
Usage: /te_reload

HTTP API

TideEconomy has a built-in HTTP API server that allows other plugins to manage player assets through POST requests.

Endpoint Overview

Endpoint	Path	Description
Add assets	`/addplayercoin`	Add coin to a player
Deduct assets	`/takeplayercoin`	Deduct coin from a player
Overwrite assets	`/setplayercoin`	Set a player's balance to the specified value

Request Format

All endpoints use POST requests with a JSON request body:

{
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "value": 100,
  "passkey": "77664455"
}

Field	Type	Description
uuid	string	Target player UUID
value	long	Amount
passkey	string	Passkey (plaintext)

Response Format

Success:

{
  "success": true,
  "message": "Operation successful",
  "balance": 200
}

Failure:

{
  "success": false,
  "message": "Operation failed (amount validation failed or insufficient balance)"
}

Call Example

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"}'

For the complete API documentation, please refer to API.md in the project repository.

Data Storage

Asset data: plugins/TideEconomy/data.json (stored by UUID)
Passkey hash: plugins/TideEconomy/passkey.txt
Operation logs: plugins/TideEconomy/process.log

Permissions

Permission Node	Description	Default
`tideeconomy.admin`	Permission for admin commands (`te_admin`, `te_reload`)	OP

FAQ

Q: Why does the API request return 403? A: The API server only accepts requests from 127.0.0.1. Please make sure to call it from the local machine.

Q: Why does the API request return 401? A: The passkey is incorrect. Please confirm that the passkey in the request matches the value in config.yml, and that you have run /te_reload after modifying the configuration.

Q: Can a player's balance be negative? A: No. The plugin prevents any operation that would cause a negative balance.

Q: How can other plugins integrate with it? A: Other plugins can call the API endpoints through HTTP POST requests. See the API documentation for details.

If you encounter any issues or have suggestions while using it, you can contact the author Suttanfix: qq3954519717

TideEconomy

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

简介

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

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

功能特性

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

安装

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

配置

配置文件位置：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

TideEconomy

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details

TideEconomy （下滑可找到中文翻译）

Introduction

Features

Installation

Configuration

Commands

/coin

/pay <player> <count>

/te_admin <action> <player> <count>

/te_reload

HTTP API

Endpoint Overview

Request Format

Response Format

Call Example

Data Storage

Permissions

FAQ

TideEconomy

简介

功能特性

安装

配置

命令

/coin

/pay <player> <count>

/te_admin <action> <player> <count>

/te_reload

HTTP API

接口概览

请求格式

响应格式

调用示例

数据存储

权限

常见问题

`/coin`

`/pay <player> <count>`

`/te_admin <action> <player> <count>`

`/te_reload`

`/coin`

`/pay <player> <count>`

`/te_admin <action> <player> <count>`

`/te_reload`