pvpOption-multi

作者：lunixialive

为服务器提供可选择加入的 PvP。只有标记为可战斗的玩家才能互相攻击。包含战斗预热计时器、战斗冷却时间、快捷栏上方 HUD、闲置时自动取消标记、广播消息和完整的管理员控制。可选兼容 expRepair。

模组 Fabric NeoForge 实用服务器工具

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

⚔️ pvpOption

双方同意、主动选择加入的 PvP —— 你只会与报名参与的玩家交战。

在大多数服务器上，PvP 只是一个开关：要么对所有人开启，要么对所有人关闭。pvpOption 用一个按玩家、主动选择加入的标记取代了它。只有在你选择加入时，你才会造成和承受玩家对玩家的伤害——而且只针对同样选择加入的其他玩家。其他所有人始终受到完全保护。不再有误伤，不再有“我不是故意打他的”，也不再有你只想建造时却被人偷袭。

🆕 1.5.5 新增：现在一个 jar 就能在每一个 Minecraft 26.x 版本上运行——26.1、26.1.1、26.1.2、26.2 以及 26.3。

✨ 特性

⚔️ 一条命令即可加入。/pvp 会打开你的标记。首先会进行一段短暂的预热倒计时——一个宽限期，以免有人瞬间偷袭你——然后你的标记才会生效。
🤝 双方都必须同意。只有当攻击者和防御者都带有标记时，攻击才会命中。攻击未标记的玩家时，这次攻击会被取消，并会有一条消息告诉你原因。
⏱️ 战斗冷却让战斗保持公平。每次有效命中都会在双方玩家身上启动一个战斗计时器。你无法在战斗中取消标记并逃到安全地带——在计时器结束前你都被锁定在战斗中。
😴 可选的自动取消标记。管理员可以在玩家一段时间不活跃后悄悄取消其标记，这样忘记执行 /pvp off 的人就不会一直带着标记到处游荡。
📊 实时动作栏 HUD。一眼即可看到你的当前状态——预热倒计时、⚔ PvP 已激活，以及剩余的战斗冷却。
📢 可选的全服广播。当玩家进入或离开 PvP 模式时向全服公告，让所有人都知道谁可以交战。
🛠️ 完整的管理控制。可切换整个系统、实时调整预热 / 冷却 / 自动取消标记、强制开启或关闭某个玩家的标记，并锁定捣乱者使其完全无法参与 PvP。
💾 按 UUID 持久保存状态。标记和管理员锁定在重启后依然保留。没有新方块，没有物品，无需客户端模组。

⌨️ 命令

根命令是 /pvpoption，/pvp 是更短的别名。单独运行它会切换你自己的标记。

玩家命令

命令	作用
`/pvp`	切换你自己的 PvP 标记开或关。
`/pvp on`	选择加入——开始预热，然后为你打上标记。
`/pvp off`	选择退出——取消待处理的预热，或取消你的标记（在战斗冷却期间会被阻止）。
`/pvp status`	显示你自己的标记状态，以及任何剩余的战斗冷却。
`/pvp list`	列出当前所有标记为 PvP 的玩家（以及谁正在战斗中）。

管理员命令

所有管理员子命令都位于 /pvp admin … 下，需要操作员 / 游戏管理员权限（等级 2+）。

命令	作用
`/pvp admin`	显示当前的管理员设置。
`/pvp admin enable` \| `disable`	在整个服务器范围内开启或关闭整个 PvP 系统。
`/pvp admin warmup [seconds]`	显示或设置主动加入的预热时间，单位为秒（`0` = 立即生效）。
`/pvp admin cooldown [seconds]`	显示或设置战斗冷却时间，单位为秒（`0` = 禁用）。
`/pvp admin autoUnflag [minutes]`	显示或设置空闲自动取消标记的时间，单位为分钟（`0` = 禁用）。
`/pvp admin broadcast on` \| `off`	切换“进入/离开 PvP 模式”的公告。
`/pvp admin disableRepair on` \| `off`	切换对被标记玩家的 expRepair 修复抑制。
`/pvp admin reload [silent]`	从磁盘重新加载配置（`silent` 仅向你发送公告）。
`/pvp admin set <player> on` \| `off`	强制开启或关闭某位玩家的标记。
`/pvp admin status <player>`	查看另一位玩家的标记、冷却和锁定状态。
`/pvp admin lock <player>`	取消某位玩家的标记并限制其主动加入 PvP。
`/pvp admin unlock <player>`	解除限制并恢复某位玩家的 PvP 权限。

⚙️ 配置

配置文件位于 config/pvpoption.json，首次启动时会以默认值创建。每个值也都可以通过 /pvp admin … 实时设置，并且 /pvp admin reload 无需重启即可重新读取该文件。每位玩家的标记和锁定状态单独存储在 config/pvpoption/playerdata.json 中。

键	默认值	作用
`pvpEnabled`	`true`	整个系统的总开关（同时同步 `server.properties` 中的 `pvp=`）。
`disableRepairInPvP`	`false`	当玩家被标记时抑制 expRepair 的经验修复（需要 expRepair 1.7+）。
`cooldownSeconds`	`30`	有效命中后的战斗冷却时间；在冷却结束前无法取消标记（`0` = 禁用）。
`warmupSeconds`	`5`	`/pvp on` 实际标记你之前的宽限期倒计时（`0` = 立即生效）。
`broadcastToggle`	`true`	当玩家进入或离开 PvP 模式时进行公告。
`autoUnflagMinutes`	`0`	在空闲这么多分钟后自动取消标记（`0` = 永不）。

🔧 与 expRepair 良好兼容

如果安装了 expRepair（1.7+），pvpOption 会向其注册一个修复抑制钩子。开启 disableRepairInPvP 后，任何当前被标记为 PvP 的玩家的经验修复都会被抑制——因此你无法在决斗中途补满装备耐久。该钩子仅在 expRepair 实际存在时才会接入；若未安装，disableRepair 管理员命令只会报告未安装 expRepair。

🧩 兼容性


加载器	Fabric 和 NeoForge — 单个 jar
Minecraft	26.1 – 26.3 — 单个 jar，v1.5.5 · 1.21.11 和 1.21.1 – 1.21.10 — v1.5.3
Fabric API	在 Fabric 上必需 · 在 NeoForge 上不需要
侧	服务端 — 支持原版客户端，单人游戏也可用
额外前置库	无