转载 机械 CombatControl 1.1

[MD]
# CombatControl：高级 PvP 管理插件


CombatControl 是一款轻量而强大的插件，旨在让玩家和服务器管理员全面掌控 PvP 互动。插件提供渐变色消息、直观的命令以及高效的玩家状态追踪功能，适合希望提供灵活 PvP 选项的服务器使用。

## 主要功能

- **切换 PvP 状态**：玩家可以自行开启或关闭 PvP 参与状态。
- **渐变色消息**：所有插件消息均支持自定义渐变色，提升显示效果。
- **实时状态查询**：可立即查看自己或其他玩家的 PvP 状态。
- **自动更新通知**：服务器管理员会在有新版本可用时收到通知。
- **支持 Minecraft 1.21**：兼容最新的 Minecraft 功能。
- **高度可配置**：可自定义消息、颜色及默认设置。

## 命令

- `/pvp`：切换自己的 PvP 状态。
- `/pvp enable`：开启自己的 PvP 状态。
- `/pvp disable`：关闭自己的 PvP 状态。
- `/pvp toggle`：另一种切换 PvP 状态的方式。
- `/status`：查看自己的当前 PvP 状态。
- `/status <player>`：查看其他玩家的 PvP 状态。

## 权限节点

| 权限节点 | 说明 | 默认值 |
| --- | --- | --- |
| `combatcontrol.pvp` | 允许使用 `/pvp` 命令 | `true` |
| `combatcontrol.status` | 允许查看自己的 PvP 状态 | `true` |
| `combatcontrol.status.others` | 允许查看其他玩家的 PvP 状态 | `op` |
| `combatcontrol.admin` | 接收插件更新通知 | `op` |

## 配置

插件提供简洁但完整的配置系统，支持以下设置：

- 新玩家首次加入时的默认 PvP 状态。
- 是否启用更新检查。
- 渐变色消息开关与自定义颜色。
- 所有消息文本均可完全自定义。

```yaml
# CombatControl Configuration
# Default PvP state for players when they first join
default-pvp-enabled : false
# Update checker settings
check-for-updates : true
# Gradient settings
use-gradient-messages : true
# Messages
messages :
prefix : '&8 [&bCombatControl&8 ] '
pvp-enabled : '&aPvP has been enabled.'
pvp-disabled : '&cPvP has been disabled.'
status-self : 'Your PvP status is currently : { STATUS } '
status-other : ' { PLAYER } ''s PvP status is currently : { STATUS } '
error-player-only : 'This command can only be used by players.'
error-player-offline : 'Player '' { PLAYER } '' is not online.'
warning-pvp-disabled-self : 'You cannot attack players while your PvP is disabled.'
warning-pvp-disabled-other : ' { PLAYER } has PvP disabled.'
update-available : 'A new version of CombatControl is available! Version { VERSION } can be downloaded from Spigot.'
# Gradient color settings (hex colors)
gradients :
info-start : ' #969696'
info-end : ' #DCDCDC'
success-start : ' #00FF64'
success-end : ' #64FFB4'
warning-start : ' #FFFF00'
warning-end : ' #FFC800'
error-start : ' #FF3232'
error-end : ' #FF6464'
```
[/MD]