## 特性
- 经济系统，用于管理游戏内货币（钻石）。
- 存款和取款钻石。
- 向其他玩家发送钻石。
- 检查您的当前余额。
- 查看顶尖玩家的排行榜。
- 支持 [MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式
- PlaceholderAPI 支持
## 服务器兼容性
- **Paper / Folia** 以及任何分支。
- ⚠️ **Spigot**: 未经测试。
- ⚠️ **Bukkit**: 未经测试。
## 数据库存储
Hyeconomy 使用 MariaDB 进行数据库存储。这确保了针对玩家余额和交易的可靠高效的数据存储。
## 指令
### 玩家指令
- `/balance`: 检查您的当前余额。
- `/balance <玩家>`: 检查其他玩家的当前余额。
- `/deposit <金额>`: 将钻石存入您的帐户。
- `/withdraw <金额>`: 从您的帐户取款。
- `/send <玩家> <金额>`: 向其他玩家发送钻石。
- `/top`: 查看顶尖玩家的排行榜。
### 管理员指令
- `/dgive <玩家> <金额>`: 向玩家帐户添加余额。
- `/dtake <玩家> <金额>`: 从玩家帐户扣除余额。
- `/dset <玩家> <金额>`: 设置玩家的特定余额值。
- `/dreset <玩家>`: 将特定玩家的余额重置为 0。
- `/dreload`: 重新加载配置文件和消息。
## 权限
- `hyeconomy.balance`: 使用 `/balance` 指令的权限。
- `hyeconomy.balance.other`: 使用 `/balance` 指令检查其他玩家的权限。
- `hyeconomy.deposit`: 使用 `/deposit` 指令的权限。
- `hyeconomy.withdraw`: 使用 `/withdraw` 指令的权限。
- `hyeconomy.send`: 使用 `/send` 指令的权限。
- `hyeconomy.top`: 使用 `/top` 指令的权限。
- `hyeconomy.give`: 使用 `/dgive` 指令的权限。
- `hyeconomy.take`: 使用 `/dtake` 指令的权限。
- `hyeconomy.set`: 使用 `/dset` 指令的权限。
- `hyeconomy.reset`: 使用 `/dreset` 指令的权限。
- `hyeconomy.reload`: 使用 `/dreload` 指令的权限。
## 配置文件
您可以编辑插件文件夹中的 `config.yml` 和 `messages.yml` 文件，来自定义插件的各种方面，包括消息和数据库设置。
## PlaceholderAPI 集成
安装 [placeholderapi](https://www.spigotmc.org/resources/placeholderapi.6245/)
- 显示玩家余额: `%hyeconomy_balance%`.
- 显示特定玩家的余额，使用 `%hyeconomy_balance_PLAYERNAME%` (将 `PLAYERNAME` 替换为实际玩家的名字)。
- 显示前 10 名玩家的用户名余额，使用 `%hyeconomy_balance_top_username_1%`, `%hyeconomy_balance_top_username_2%`，以此类推，直到 `%hyeconomy_balance_top_username_10%`。
- 显示前 10 名玩家的金额余额，使用 `%hyeconomy_balance_top_amount_1%`, `%hyeconomy_balance_top_amount_2%`，以此类推，直到 `%hyeconomy_balance_top_amount_10%`。
请记住，在第二种占位符类型中，将 `PLAYERNAME` 替换为您要查询的实际玩家姓名。
## 支持
如果您遇到任何问题或有任何疑问，请随时在 GitHub 仓库的 [打开问题](https://github.com/MidnightTale/hyeconomy/issues) 中提问。
## 许可证
此插件是开源的，并可在 [MIT 许可证](LICENSE) 下使用。
## 开发人员 API [](https://repo.hynse.xyz/api/latest/releases/xyz/hynse/api-hyeconomy)
### 信息
Apache Maven `pom.xml`
```xml
hyeconomy
https://repo.hynse.xyz/repository/maven-releases/
xyz.hynse
api-hyeconomy
1.2-SNAPSHOT-1
```
Gradle Groovy DSL `build.gradle`
```gradlee
repositories {
maven { url = "https://repo.hynse.xyz/repository/maven-releases/"}
}
dependencies {
compileOnly 'xyz.hynse:api-hyeconomy:1.2-SNAPSHOT-1'
}
```
### 示例
```java
import xyz.hynse.hyeconomy.API.HyeconomyAPI;
// 当您需要获取或设置玩家余额时：
HyeconomyAPI hyeconomyAPI = Hyeconomy.getAPI();
// 通过 UUID 获取玩家余额
UUID playerUUID = /* 玩家的 UUID */;
int balance = hyeconomyAPI.getPlayerBalance(playerUUID);
// 通过 UUID 设置玩家余额
int newBalance = /* 新的余额 */;
hyeconomyAPI.setPlayerBalance(playerUUID, newBalance);
int amount = /*想要添加或减去的金额*/;
// 通过 UUID 添加玩家余额
HyeconomyAPI.addToPlayerBalance(UUID playerUUID, amount)
// 通过 UUID 减去玩家余额
HyeconomyAPI.subtractFromPlayerBalance(UUID playerUUID, amount)
```