PvP选项-多重

⚔️ 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 保持公正。每次有效命中都会对双方玩家启动战斗计时器。你无法在战斗中取消标记逃到安全地带——在它结束前你被锁定其中。
• 😴 可选自动取消标记。管理员可以在一段不活动时间后静默移除玩家的标记，这样忘记 /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 的 XP 修复（需要 expRepair 1.7+）。
cooldownSeconds	30	有效命中后的战斗冷却；在它结束前你无法取消标记（0 = 禁用）。
warmupSeconds	5	/pvp on 实际标记你之前的宽限期倒计时（0 = 立即）。
broadcastToggle	true	当玩家进入或离开 PvP 模式时进行公告。
autoUnflagMinutes	0	在此空闲分钟数后自动取消标记（0 = 永不）。

🔧 与 expRepair 良好协作

如果安装了 expRepair（1.7+），pvpOption 会向其注册一个修复抑制钩子。开启 disableRepairInPvP 后，任何当前已标记 PvP 的玩家，其 XP 修复都会被抑制——这样你就无法在决斗中途补满装备耐久。该钩子仅在实际存在 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 上不需要
端	服务端——支持原版客户端，也支持单人游戏
额外库	无

---

喜欢它吗？加入 Discord · 为仓库点 ⭐ · 探索其他 Lunixia 的 Minecraft QOL 模组

⛏️ 小巧、专注的模组，为你省去无聊的部分。