# ZPvPToggle
一个允许玩家切换其 PvP 状态的轻量级 Minecraft 插件。玩家只能在双方都启用 PvP 时参与 PvP。
## 特性
- **切换 PvP**: 玩家可以启用或禁用他们的 PvP 状态
- **视觉指示器**: 可定制的粒子环显示哪些玩家启用了 PvP
- **冷却时间**: 玩家进入 PvP 战斗后，切换 PvP 的可配置冷却时间。
- **自定义指示器**: 玩家可以选择自己的指示器。指示器的访问基于权限。
- **管理员控制**: 工作人员可以为其他玩家切换 PvP
- **完全可定制**: 所有消息和粒子效果都可以配置
- **Folia 支持**: 适用于 Folia 服务器软件
- **基于权限**: 具有不同命令的细粒度权限系统
## 命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/pvp` | 切换您的 PvP 状态 | zpvptoggle.user |
| `/pvp toggle` | 切换您的 PvP 状态 | zpvptoggle.user |
| `/pvp on` | 启用您的 PvP 状态 | zpvptoggle.user |
| `/pvp off` | 禁用您的 PvP 状态 | zpvptoggle.user |
| `/pvp hide` | 隐藏 PvP 粒子指示器 | zpvptoggle.user |
| `/pvp show` | 显示 PvP 粒子指示器 | zpvptoggle.user |
| `/pvp indicator ` | 更改您的 PvP 指示器 | zpvptoggle.indicator. |
| `/pvp help` | 显示帮助信息 | zpvptoggle.user |
| `/pvp reload` | 重新加载插件配置 | zpvptoggle.admin |
| `/pvp ` | 为其他玩家切换 PvP | zpvptoggle.admin |
| `/pvp bypass ` | 为您或另一位玩家切换 PvP 绕过状态 | zpvptoggle.admin |
## 权限
| 权限 | 描述 | 默认值 |
|------------|-------------|---------|
| `zpvptoggle.user` | 允许玩家切换自己的 PvP 状态 | true |
| `zpvptoggle.indicator.` | 授予访问特定指示器的权限。 | multiple |
| `zpvptoggle.admin` | 允许工作人员为其他玩家切换 PvP 状态 | op |
## 配置
### config.yml
```yaml
# 是否在玩家死亡时禁用 PvP
disable-pvp-on-death: true
# 是否在玩家首次切换 PvP 时显示警告消息
warning-message-enabled: true
# 是否将 pvp-toggle 保护应用于玩家的宠物
protect-pets: true
# 玩家切换 pvp 或自上次 pvp 交互以来的冷却时间
pvp-cooldown: 10.0
particle-indicator:
# 显示粒子环的刻钟间隔。20 刻钟 = 1 秒。
interval-ticks: 60
# 玩家可以看到 PvP 指示器的最大距离（单位：方块）。
max-view-distance: 32
# 使用的默认指示器（必须与 indicators 部分中的一个键匹配）
default-indicator: default
# 定义多个粒子环指示器
indicators:
# 默认环 - 在脚部周围的红色圆圈
default:
type: REDSTONE
points: 32
random-particle-positions: false
radius: 0.8
y-offset: 0.1
interval: 5
random-offset-vertical: 0.0
random-offset-horizontal: 0.0
speed: 0.01
color: RED
dust-size: 1.0
```
## 兼容性
- Paper 1.21+
- Folia 兼容
- Java 21+
## 依赖项
- [MCKotlin](https://modrinth.com/plugin/mckotlin)
## 安装
1. 从 [Modrinth](https://modrinth.com/plugin/zpvptoggle/versions) 下载 ZPvPToggle 的最新版本。
2. 从 [Modrinth](https://modrinth.com/plugin/mckotlin) 下载 MCKotlin
3. 将下载的 `.jar` 文件放入服务器的 `plugins/` 文件夹中。
4. 重新启动您的服务器。
5. 通过编辑 `plugins/ZPvPtoggle/` 文件夹中的 `.yml` 文件来配置插件，使其符合您的喜好。