转载 前置/API 工具 GPClaimBlocks | GriefPrevention 附加组件 2.1

[MD]
# GPClaimBlocks｜GriefPrevention 附加组件

!(https://img.scdn.io/i/6aa7ec3e5d016_1789389886.webp)

GPClaimBlocks 是一款简洁且完善的 GriefPrevention 附加组件，可根据玩家在 LuckPerms 中的等级自动调整其领地块数量。

当玩家等级发生变化时，插件会按照配置立即更新其领地块总数。它非常适合设有 VIP、会员或多级权限体系的服务器。

- 按等级自动发放额外领地块
- 玩家等级变更后即时同步
- 支持累积模式，可叠加多个等级的奖励
- 支持 PlaceholderAPI 变量

所有功能均可在 `config.yml` 中配置。插件无需数据库，配置简单，占用资源极低。

## 功能特点

- **基于等级的奖励**
可为不同等级设置不同的领地块数量，例如 Default、VIP、MVP 等。

- **即时同步**
当玩家被添加或移出某个 LuckPerms 权限组时，插件会立即更新其 GriefPrevention 数据。

- **累积模式**
可选择将玩家拥有的所有等级奖励叠加计算。

- **PlaceholderAPI 集成**
可在其他支持 PlaceholderAPI 的插件中显示玩家的额外领地块、总领地块或剩余领地块数量。

- **轻量且低影响**
不使用数据库，占用极低，并针对性能进行了优化。

- **已在 1.20.x 上测试**
与现代 Spigot 和 Paper 服务端构建版本兼容。

## 工作原理

1. 服务器启动后，GPClaimBlocks 会加载等级奖励配置。
2. 当玩家加入服务器或其等级发生变化时，插件会检查其权限组。
3. 插件根据配置规则计算应给予的额外领地块：
- 使用玩家最高等级对应的奖励；或
- 在启用累积模式后，合并玩家多个等级的奖励。
4. GPClaimBlocks 会立即更新该玩家在 GriefPrevention 中的领地块数量。
5. 如有需要，可通过 PlaceholderAPI 显示玩家的奖励值或领地块总数。

## 命令与权限

### 命令

- `/gpclaimblocks reload`：重新加载配置文件。
- `/gpclaimblocks info <player>`：查看指定玩家的领地块详情。
- `/gpclaimblocks list`：列出所有已配置的等级奖励。
- `/gpclaimblocks update <player>`：强制更新指定玩家的领地块数据，用于手动同步。

### 权限节点

- `gpclaimblocks.admin`

## PlaceholderAPI 变量

可用变量如下：

| 变量 | 说明 |
| --- | --- |
| `%gpclaimblocks_bonus%` | 玩家获得的额外领地块数量 |
| `%gpclaimblocks_total%` | 玩家当前的领地块总数 |
| `%gpclaimblocks_left%` | 玩家剩余可用的领地块数量 |
| `%gpclaimblocks_rank%` | 用于计算奖励的等级 |

## 说明

GPClaimBlocks 采用全自动运行方式，完成配置后无需日常维护。插件会在后台持续管理领地块调整，确保 LuckPerms 权限组与 GriefPrevention 领地块数据之间始终准确、无缝地同步。
[/MD][/MD]