- 版权类型
- 转载
- 插件中文名
- ApexKoth
- 插件英文名
- ApexKoth
- 支持的核心 [服务端]
- Spigot
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# ApexKoth
**极专业的山丘之王插件 — 现代视觉效果、全面可定制、零聊天刷屏。**
## 简介
厌倦了那些刷屏聊天框、配置混乱又满是 bug 的老式 KOTH 插件？**ApexKOTH** 从零开始构建，专注性能、易用性与专业服务器体验。它保留了玩家熟悉的经典山丘之王玩法，同时融入服主真正需要的现代功能——智能防刷屏逻辑、自动调度器、简洁美观的视觉呈现，力求成为你最后一个需要安装的 KOTH 插件。
---
## 核心功能
### 动态视觉（Boss 栏 + 动作栏）
告别界面杂乱。**Boss 栏**仅对 KOTH 区域内的玩家显示，展示活动的**剩余总时长**；**动作栏**仅对当前占领者显示**占领进度**，互不干扰。
### KOTH 最大时长（生命周期）
每个 KOTH 可独立配置最大持续时长（例如 20 分钟）。若在时限内无人完成占领，活动自动结束且不产生获胜者，彻底杜绝 KOTH 无限卡死的情况。
### 高级自动调度器
配置一次，无需再管。内置调度器可按固定间隔自动启动 KOTH，支持配置：
- 启动间隔（例如每 120 分钟一次）
- 最低在线玩家要求
- 启动前预告提示消息
- 随机选取 KOTH 区域
### 全面可定制的消息
所有消息、前缀和显示文本均可在 messages.yml 中编辑，轻松完成汉化或针对服务器风格的个性化定制。
### 通用奖励系统
rewards.yml 支持配置无限数量的奖励包。ApexKOTH 通过直接执行控制台命令下发奖励，可与**任意**经济、箱子或权限插件协同工作，包括 Essentials、CMI、UltraEconomy 等。
### 智能防刷屏逻辑
只有**重要事件**才会全服广播：
- KOTH 开始
- KOTH 结束（被占领或超时）
- 占领权转移（更换占领者时）
玩家进出区域不再产生任何刷屏提示。
### 专业"灵魂绑定"管理员魔杖
/koth wand 命令会给予你一个智能且安全的区域选择工具：
- 无法丢弃、存入容器或被转移
- 两个角点均设置完毕后自动消失
### 灵活的时间格式
无需手动换算秒数——/koth create 和 /koth setduration 等命令均接受以下格式：
`1h30m`、`20m`、`45s`，或直接输入数字（例如 `300`）
### 完整 PlaceholderAPI 支持
通过以下变量将 ApexKOTH 数据集成到其他插件：
- `%apexkoth_time_left%`
- `%apexkoth_lifetime_left%`
- `%apexkoth_capper%`
- `%apexkoth_koth_name%`
### 轻量高性能
采用简洁的现代化代码构建，对服务器 TPS 影响极小，在高人数服务器上同样流畅运行。
---
## 五分钟快速上手
### 第一步：获取魔杖
执行命令：
```
/koth wand
```
- 左键单击方块 → 设置位置 1
- 右键单击方块 → 设置位置 2
- 两点均设置完成后魔杖自动消失
### 第二步：创建 KOTH
```
/koth create <名称> [占领时间]
```
示例：
```
/koth create Arena 5m
```
创建一个名为 *Arena*、需要 5 分钟完成占领的 KOTH。
### 第三步：设置最大时长（可选）
```
/koth setduration Arena 30m
```
若 30 分钟内无人完成占领，该 KOTH 自动取消。
### 第四步：设置奖励（可选）
在 rewards.yml 中添加奖励包后，使用以下命令关联：
```
/koth setreward Arena legendary
```
### 第五步：启动 KOTH
手动启动：
```
/koth start Arena
```
或直接开启**调度器**，让插件自动启动。
---
## 占领逻辑（接力系统）
ApexKOTH 采用**单人接力占领机制**：
- 第一个进入区域的玩家成为占领者
- 若占领者离开但区域内仍有其他玩家，系统随机指定一名玩家继续占领
- 若区域内所有玩家均离开，占领进度重置
- 占领权转移时，全服广播"接力"提示
---
## 命令与权限
### 管理员命令（权限节点：`apexkoth.admin.<命令>`）
| 命令 | 说明 |
|---|---|
| /koth `create <名称> [时间]` | 使用当前魔杖选区创建新 KOTH |
| /koth `delete <名称>` | 删除指定 KOTH，若正在进行则先停止 |
| /koth `wand` | 获取灵魂绑定的区域选择魔杖 |
| /koth `start <名称>` | 强制启动指定 KOTH |
| /koth `stop` | 强制停止当前进行中的 KOTH |
| /koth `setduration <koth> <时间>` | 设置指定 KOTH 的最大持续时长 |
| /koth `setreward <koth> <奖励包>` | 将 rewards.yml 中的奖励包关联到指定 KOTH |
| /koth `reload` | 重载所有配置文件并重启调度器 |
### 普通玩家命令（默认权限）
| 命令 | 说明 |
|---|---|
| /koth `schedule` | 查看下一次 KOTH 的启动时间 |
| /koth `feedback <消息>` | 在游戏内直接向开发者发送反馈 |
---
## 配置文件
### config.yml
主配置文件，简洁而功能全面，包含：
- 默认占领时长和生命周期时长
- 调度器间隔、预告消息及最低玩家要求
- 自定义魔杖材质、名称和描述文本
### messages.yml
所有消息均可完整汉化和自定义，包含：
- 全服广播（开始、停止、获胜、超时）
- 动作栏与 Boss 栏显示文本
- 错误提示与管理员反馈消息
### rewards.yml
创建无限数量的奖励包，兼容任意经济、箱子或权限插件。示例：
```yaml
legendary:
commands:
- "eco give %player% 50000"
- "crate key give %player% legendary 1"
- "give %player% netherite_block 1"
```
---
## PlaceholderAPI 变量
| 变量 | 说明 |
|---|---|
| `%apexkoth_status%` | 显示当前状态，如"未激活"、"占领中"等 |
| `%apexkoth_capper%` | 当前占领玩家的名称 |
| `%apexkoth_koth_name%` | 当前 KOTH 的名称 |
| `%apexkoth_time_left%` | 完成占领的剩余时间 |
| `%apexkoth_lifetime_left%` | KOTH 活动结束前的剩余时间 |
---
## 依赖
- **必需依赖：** 无
- **可选依赖：** PlaceholderAPI（用于变量支持）
---
## 反馈与支持
如有问题或建议，可直接在游戏内执行以下命令发送：
```
/koth feedback <消息>
```
[/MD]
# ApexKoth
**极专业的山丘之王插件 — 现代视觉效果、全面可定制、零聊天刷屏。**
## 简介
厌倦了那些刷屏聊天框、配置混乱又满是 bug 的老式 KOTH 插件？**ApexKOTH** 从零开始构建，专注性能、易用性与专业服务器体验。它保留了玩家熟悉的经典山丘之王玩法，同时融入服主真正需要的现代功能——智能防刷屏逻辑、自动调度器、简洁美观的视觉呈现，力求成为你最后一个需要安装的 KOTH 插件。
---
## 核心功能
### 动态视觉（Boss 栏 + 动作栏）
告别界面杂乱。**Boss 栏**仅对 KOTH 区域内的玩家显示，展示活动的**剩余总时长**；**动作栏**仅对当前占领者显示**占领进度**，互不干扰。
### KOTH 最大时长（生命周期）
每个 KOTH 可独立配置最大持续时长（例如 20 分钟）。若在时限内无人完成占领，活动自动结束且不产生获胜者，彻底杜绝 KOTH 无限卡死的情况。
### 高级自动调度器
配置一次，无需再管。内置调度器可按固定间隔自动启动 KOTH，支持配置：
- 启动间隔（例如每 120 分钟一次）
- 最低在线玩家要求
- 启动前预告提示消息
- 随机选取 KOTH 区域
### 全面可定制的消息
所有消息、前缀和显示文本均可在 messages.yml 中编辑，轻松完成汉化或针对服务器风格的个性化定制。
### 通用奖励系统
rewards.yml 支持配置无限数量的奖励包。ApexKOTH 通过直接执行控制台命令下发奖励，可与**任意**经济、箱子或权限插件协同工作，包括 Essentials、CMI、UltraEconomy 等。
### 智能防刷屏逻辑
只有**重要事件**才会全服广播：
- KOTH 开始
- KOTH 结束（被占领或超时）
- 占领权转移（更换占领者时）
玩家进出区域不再产生任何刷屏提示。
### 专业"灵魂绑定"管理员魔杖
/koth wand 命令会给予你一个智能且安全的区域选择工具：
- 无法丢弃、存入容器或被转移
- 两个角点均设置完毕后自动消失
### 灵活的时间格式
无需手动换算秒数——/koth create 和 /koth setduration 等命令均接受以下格式：
`1h30m`、`20m`、`45s`，或直接输入数字（例如 `300`）
### 完整 PlaceholderAPI 支持
通过以下变量将 ApexKOTH 数据集成到其他插件：
- `%apexkoth_time_left%`
- `%apexkoth_lifetime_left%`
- `%apexkoth_capper%`
- `%apexkoth_koth_name%`
### 轻量高性能
采用简洁的现代化代码构建，对服务器 TPS 影响极小，在高人数服务器上同样流畅运行。
---
## 五分钟快速上手
### 第一步：获取魔杖
执行命令：
```
/koth wand
```
- 左键单击方块 → 设置位置 1
- 右键单击方块 → 设置位置 2
- 两点均设置完成后魔杖自动消失
### 第二步：创建 KOTH
```
/koth create <名称> [占领时间]
```
示例：
```
/koth create Arena 5m
```
创建一个名为 *Arena*、需要 5 分钟完成占领的 KOTH。
### 第三步：设置最大时长（可选）
```
/koth setduration Arena 30m
```
若 30 分钟内无人完成占领，该 KOTH 自动取消。
### 第四步：设置奖励（可选）
在 rewards.yml 中添加奖励包后，使用以下命令关联：
```
/koth setreward Arena legendary
```
### 第五步：启动 KOTH
手动启动：
```
/koth start Arena
```
或直接开启**调度器**，让插件自动启动。
---
## 占领逻辑（接力系统）
ApexKOTH 采用**单人接力占领机制**：
- 第一个进入区域的玩家成为占领者
- 若占领者离开但区域内仍有其他玩家，系统随机指定一名玩家继续占领
- 若区域内所有玩家均离开，占领进度重置
- 占领权转移时，全服广播"接力"提示
---
## 命令与权限
### 管理员命令（权限节点：`apexkoth.admin.<命令>`）
| 命令 | 说明 |
|---|---|
| /koth `create <名称> [时间]` | 使用当前魔杖选区创建新 KOTH |
| /koth `delete <名称>` | 删除指定 KOTH，若正在进行则先停止 |
| /koth `wand` | 获取灵魂绑定的区域选择魔杖 |
| /koth `start <名称>` | 强制启动指定 KOTH |
| /koth `stop` | 强制停止当前进行中的 KOTH |
| /koth `setduration <koth> <时间>` | 设置指定 KOTH 的最大持续时长 |
| /koth `setreward <koth> <奖励包>` | 将 rewards.yml 中的奖励包关联到指定 KOTH |
| /koth `reload` | 重载所有配置文件并重启调度器 |
### 普通玩家命令（默认权限）
| 命令 | 说明 |
|---|---|
| /koth `schedule` | 查看下一次 KOTH 的启动时间 |
| /koth `feedback <消息>` | 在游戏内直接向开发者发送反馈 |
---
## 配置文件
### config.yml
主配置文件，简洁而功能全面，包含：
- 默认占领时长和生命周期时长
- 调度器间隔、预告消息及最低玩家要求
- 自定义魔杖材质、名称和描述文本
### messages.yml
所有消息均可完整汉化和自定义，包含：
- 全服广播（开始、停止、获胜、超时）
- 动作栏与 Boss 栏显示文本
- 错误提示与管理员反馈消息
### rewards.yml
创建无限数量的奖励包，兼容任意经济、箱子或权限插件。示例：
```yaml
legendary:
commands:
- "eco give %player% 50000"
- "crate key give %player% legendary 1"
- "give %player% netherite_block 1"
```
---
## PlaceholderAPI 变量
| 变量 | 说明 |
|---|---|
| `%apexkoth_status%` | 显示当前状态，如"未激活"、"占领中"等 |
| `%apexkoth_capper%` | 当前占领玩家的名称 |
| `%apexkoth_koth_name%` | 当前 KOTH 的名称 |
| `%apexkoth_time_left%` | 完成占领的剩余时间 |
| `%apexkoth_lifetime_left%` | KOTH 活动结束前的剩余时间 |
---
## 依赖
- **必需依赖：** 无
- **可选依赖：** PlaceholderAPI（用于变量支持）
---
## 反馈与支持
如有问题或建议，可直接在游戏内执行以下命令发送：
```
/koth feedback <消息>
```
[/MD]