转载 闭源 工具 经济 领地系统 1.0

[MD]
# Tebex 领取系统

TebexClaimSystem 是一款适用于 Minecraft 1.8 Bukkit/Spigot 服务端的插件。玩家可通过自定义 GUI 在游戏内领取 Tebex 购买的商品；即使购买时不在线，商品也会保留，待玩家下次上线后领取。

## 功能介绍

- 接收由控制台执行的 Tebex 发货格式命令：`tebexclaimsystem add <username> <productName> <quantity>`
- 将待领取商品保存至 YAML 文件，重启服务器后不会丢失
- 玩家上线时，如存在待领取商品，会收到提醒
- 每 30 分钟向拥有待领取商品的在线玩家发送一次提醒
- 提供领取 GUI：每个待领取商品对应一个条目，并附带 **全部领取** 按钮
- 领取前检查玩家背包可用空间
- 按配置执行商品对应的命令，支持 `{player}` 占位符
- 记录每次领取操作，包括时间、玩家、商品和数量

## 安装方法

1. 构建插件 JAR 文件。
2. 将 JAR 文件放入服务端的 `plugins/` 文件夹。
3. 启动或重启服务器。
4. 编辑 `plugins/TebexClaimSystem/config.yml`，使其与自己的商品及执行命令相匹配。
5. 修改配置后执行重载或重启服务器。

## 命令

- `/tebexclaimsystem`：供玩家打开领取 GUI。
- 别名：`/tcs`、`/claimstore`、`/claims`、`/webstoreclaim`、`/wsc`。
- `tebexclaimsystem add <username> <productName> <quantity>`：仅限控制台执行的命令，供 Tebex 发货时调用。
- `/tebexclaimsystem reload`：无需重启服务器即可重载 `config.yml`（权限：`tebexclaimsystem.reload`，默认值：`op`）。

### Tebex 命令示例

```text
```text
tebexclaimsystem add Notch vip_rank 1
tebexclaimsystem add Notch starter_kit 2
```
```

## 配置说明

主配置文件：`plugins/TebexClaimSystem/config.yml`

### `products`

在此处按商品 ID 定义可领取商品。商品 ID 必须与 Tebex 发送的 `<productName>` 保持一致。

- `displayName`：在 GUI 中显示的商品名称
- `itemMaterial`：GUI 中使用的图标材质
- `requiredSlotsPerUnit`：每购买一件商品所需检查的背包空间数量
- `commands`：领取时执行的命令，支持 `{player}` 与 `{quantity}`

示例：

```yaml
```yaml
products:
vip_rank:
displayName: "&6VIP Rank"
itemMaterial: "EMERALD"
requiredSlotsPerUnit: 1
commands:
- "lp user {player} parent set vip"
starter_kit:
displayName: "&bStarter Kit"
itemMaterial: "CHEST"
requiredSlotsPerUnit: 2
commands:
- "give {player} diamond_sword 1"
- "give {player} bread 16"
```
```

### `gui`

- `title`：背包界面标题
- `size`：背包界面大小，范围为 9–54，且必须是 9 的倍数
- `claimAllSlot`：**全部领取** 按钮所在的槽位索引
- `claimAllName` / `claimAllMaterial`：**全部领取** 按钮的显示内容
- `quantityLore`：用于显示数量信息的 Lore 文本行

### `messages`

所有面向玩家的提示及反馈消息均可在此配置。

- 前缀占位符：`{prefix}`
- 颜色支持：`&` 颜色代码

## 运行时数据文件

以下文件会创建在 `plugins/TebexClaimSystem/` 中：

- `pending-claims.yml`：记录各玩家及各商品当前待领取的数量
- `claim-log.txt`：记录商品领取审计日志

每当添加或移除待领取商品时，`pending-claims.yml` 都会立即更新。

## 领取流程

1. Tebex 或服务端控制台执行 `tebexclaimsystem add ...`。
2. TebexClaimSystem 为对应玩家和商品保存待领取数量。
3. 玩家上线后，如存在待领取商品，将收到通知。
4. 玩家执行 `/tebexclaimsystem` 或任意已配置的命令别名，打开领取界面。
5. 玩家点击单个商品，或点击 **全部领取**。
6. 插件检查背包是否有足够的可用槽位。
7. 若空间充足，插件会执行商品命令并移除对应的待领取记录。
8. 本次领取会写入 `claim-log.txt`。

## 常见问题

- 出现 `unknown product` 提示：确认 Tebex 商品 ID 与 `products` 下的配置键完全一致。
- 玩家因背包空间不足而无法领取：清理背包中的空余槽位，或调整 `requiredSlotsPerUnit`。
- 控制台命令无法在游戏内执行：`add` 被设计为仅允许控制台发送。
- GUI 中没有商品条目：确认 `pending-claims.yml` 中存在待领取记录，并检查商品 ID 是否已在 `config.yml` 中定义。
[/MD]