TogglePvp - 开关PvP

TogglePvP 是一款轻量级插件，专为希望实现“自愿参与”式 PvP 的服务器设计。玩家需要通过指令手动开启 PvP 状态才能相互战斗，非常适合生存或空岛服务器，为玩家提供自主选择权。

💡工作原理

PvP 仅在双方玩家都通过 /pvp 指令启用 PvP 状态时才会生效。

支持的攻击方式

• 远程武器与弹射物：完全支持弓箭、三叉戟（包括引雷）等所有弹射物攻击。
• 药水：支持喷溅型药水与滞留型药水效果。
• 已驯服动物：默认支持所有可驯服生物。动物会遵循其主人的 PvP 状态，其他玩家也无法攻击 PvP 关闭玩家所拥有的动物。
• 爆炸与环境伤害：支持 TNT、重生锚、岩浆、床的爆炸等造成的伤害。
• 注意：目前暂不支持 TNT矿车和滴水石的伤害判定。

✨功能特性

• 允许玩家自由开关 PvP 状态。
• 战斗状态下禁止切换 PvP。
• 支持多世界。
• 支持 WorldGuard。
• 支持 PlaceholderAPI。
• 可在战斗中禁用玩家飞行能力。
• 可在战斗中禁用特定指令。
• 当玩家 PvP 状态改变时，可执行自定义指令。
• 可选的 PvP 状态发光效果。
• 可选的战斗日志（Combat Log）功能。

🎮指令与权限

主指令：/togglepvp

指令别名：pvp, pvptoggle, pvpt, tpvp

指令用法

• /pvp 或 /pvp toggle
• 切换自己的 PvP 状态。
• 所需权限：tau.togglepvp.use
• /pvp <on, enable> 或 /pvp <off, disable>
• 启用或禁用自己的 PvP 状态。
• 所需权限：tau.togglepvp.use
• /pvp reload
• 重载插件配置。
• 所需权限：tau.togglepvp.reload
• /pvp <on, off, toggle> <玩家名>
• 切换其他玩家的 PvP 状态。
• 所需权限：tau.togglepvp.other

注意：所有权限均可在配置文件中修改。

🔧WorldGuard 标志

• togglepvp-force-pvp
• 在特定区域强制启用或禁用 PvP。

🔧PlaceholderAPI 占位符

• %togglepvp_state% - 玩家当前生效的 PvP 状态（综合计算区域和世界设置后）。
• %togglepvp_desired_state% - 玩家通过 /pvp 指令设置的偏好状态。
• %togglepvp_forced_state% - 玩家所在区域（世界或 WorldGuard 区域）的强制 PvP 状态。
• %togglepvp_remainingtime% - 玩家在战斗结束后，还需等待多少秒才能切换 PvP 状态。

⭐配置摘要

以下是核心配置选项的概述，完整配置请查阅插件生成的 config.yml 文件。

基础设置

• toggle permission：切换自身 PvP 状态所需的权限。
• combat cooldown：进入战斗后，需等待多少秒才能切换 PvP 状态。
• kill combat loggers：是否击杀在战斗中断开连接的玩家。
• default pvp state：新玩家加入时的默认 PvP 状态。

世界规则

• force pvp enabled worlds：在此列表世界内，PvP 始终强制开启。
• force pvp disabled worlds：在此列表世界内，PvP 始终强制关闭。

战斗与保护

• blocked combat commands：战斗期间禁止玩家执行的指令列表。
• protect tameable animals：是否保护 PvP 关闭或离线玩家的已驯服动物。
• protect from unknown explosions：是否保护 PvP 关闭玩家免受来源不明的爆炸伤害。
• enable knockback：攻击 PvP 关闭的玩家时，攻击者是否应被击退。

状态效果

• state effects：可根据玩家 PvP 状态应用视觉效果。
• pvp glow color / pve glow color：为开启/关闭 PvP 的玩家设置发光颜色。
• pvp tab name / pve tab name：在玩家列表（Tab）中根据 PvP 状态显示不同的名称格式。

消息提示

所有提示信息均可自定义，支持多行和 PlaceholderAPI 占位符。可以配置战斗提示、状态切换提示、攻击被阻挡提示等多种消息。

❓支持与反馈

• 支持的 Minecraft 版本：1.3 至 1.21。
• 如果您遇到问题，请不要在评论中提出。请直接向开发者发送消息或在讨论区留言。
• 开发者其他资源：可访问 GitLab 主页 gitlab.com/TauCu 查看。