Open Parties and Claims: Warfare

⚔️ Open Parties and Claims: Warfare

将你和平的 Open Parties and Claims (OPaC) 服务器变成史诗般的领土征服、战术围城与外交战争竞技场！

Open Parties and Claims: Warfare 填补了和平的领地保护与激烈的派系 PvP 之间的空白。玩家可以向敌对领地宣战，展开动态的逐区块围城，在小地图上追踪正在进行的冲突，并为争夺土地而战；同时还能通过可配置的突袭时段保护离线基地。

📚 指南与文档

• 🔄 迁移与升级指南（1.x 至 2.0） — 提供从 1.x（1.6.7.2）或早期 2.0 版本逐步升级的说明。
• 📖 服务器管理员指南 — 涵盖安装、生命周期、突袭时段和服务器实时运维。
• ⚙️ 配置参考 — 完整的选项说明、允许范围和默认值，适用于 opac_warfare-*.toml。
• 🧩 配套模组：Better Protection — 保护机械动力的机械装置（钻头/锯）、炮弹冲击以及 /claimrules。
• ⚔️ 配套模组：Combat Log（Modrinth / CurseForge）— 防止战斗中途退出，并阻止玩家在 PvP 和围城期间逃入安全领地。
• 🏗️ 架构与 WarfareBridge — 开发者说明、平台抽象和外部模组集成。

🌟 主要特色

🚩 战术区块战争与征服

• 基于边界的战争：从边界向邻近的敌对领地宣战。若不先攻下边界区块，就无法绕过领地核心深入腹地！
• 扇区楔形征服：在一场艰苦奋战的战役中，夺取相连领地内具有战略意义的楔形区域。

🛡️ 平衡占领与反人海战术

• 以驻守为基础的占领：进攻方通过控制争夺区域推进围城进度条；防守方则通过守卫领地将进度条推回。
• 反人海保护：收益递减机制可防止大规模人海战术瞬间碾压规模较小但防御坚固的队伍。胜负由技巧与耐力决定！
• AFK 保护：挂机玩家不会推进围城进度。

⏰ 公平的突袭时段与冷却

• 不再凌晨 4 点突袭离线玩家：设定精确的服务器突袭时段（例如 18:00 - 22:00），让战斗只在玩家在线并做好准备时进行。
• 战略冷却：可配置的进攻和防守冷却时间可防止频繁宣战，并给战败方时间重整旗鼓。

❤️ 战争生命值与实时计分板

• 高风险战斗：每位战士在每场围城中都有有限的战争生命值。生命值耗尽，就会退出战斗！
• 侧边栏 HUD：实时计分板会显示剩余生命值和战斗状态，让所有人随时掌握战况。

🗺️ 完整集成 Xaero 地图

• 公平战争标记：直接在 Xaero’s Minimap 和 Xaero’s World Map 上查看正在发生的冲突区域和计时器。
• 右键即可发起战争：只需在 Xaero’s World Map 上右键点击任意符合条件的敌方边界区块，即可发起围城！

🔔 Discord Webhook

• 自动将宣战消息、阶段转换和最终围城结果推送到服务器的 Discord 频道，并附上丰富的嵌入式消息。

⚔️ 围城如何运作

  [ /war start ] ────► [ Preparation Phase ] ────► [ Active Battle ] ────► [ Resolution ]
  Target border chunk     Defenders & attackers      Fight for zone;           100% = Captured!
  or Xaero right-click    gear up & rally           drain enemy lives         Timeout = Defended!

1. 宣战：一方使用/war start或 Xaero 的世界地图菜单，对相邻的敌对区块宣战。
2. 准备阶段：倒计时为防守方争取时间，用来召集盟友、修筑防御工事并准备装备。
3. 进行阶段：该区块进入争夺状态！对参战者而言，常规的认领限制会放宽：

• 站在区域内即可占领或防守。
• 留意占领进度条和侧边栏的生命数。
• 发光效果让参战者保持可见，防止躲在角落里。

1. 结算：

• 如果进攻方达到100% 进度，该区块将被进攻方占领！
• 如果防守方坚持到时间结束或耗尽敌方生命数，围攻失败，和平恢复。

🧩 模组兼容性与生态系统

🛡️ 官方配套模组：Better Protection

想要在围攻期间支持机械动力装置、火炮作战和自定义方块破坏规则？
👉 Open Parties and Claims: Better Protection

• 同时安装后，围攻区域会自动允许机械动力钻头、火炮冲击（Create Big Cannons）以及在活跃争夺区块中的战术突破，同时让和平认领区域保持 100% 安全！

⚔️ 官方配套模组：Combat Log

防止在战争和 PvP 期间战斗记录和战术逃入安全领地：
👉 Open Parties and Claims: Combat Log（Modrinth | CurseForge）

• 防止逃入安全区：阻止被标记的玩家在战斗中撤回安全认领区、和平领地或非 PvP 区域。
• 公平围攻：在 PvP 和领地战争期间标记参战者，惩罚战斗记录行为，确保争夺战打到最后！

🌍 多加载器与多版本

Warfare 开箱即支持你喜欢的模组加载器和版本：

• Minecraft 1.20.1：Forge 与 Fabric
• Minecraft 1.21.1：NeoForge 与 Fabric
• Minecraft 26.1：NeoForge

📦 安装与要求

1. 为你的加载器和 Minecraft 版本安装 Open Parties and Claims（CurseForge / Modrinth）。
2. 下载匹配的 Open Parties and Claims: Warfare jar：

• opac-warfare-1.20.1-forge.jar
• opac-warfare-1.20.1-fabric.jar
• opac-warfare-1.21.1-neoforge.jar
• opac-warfare-1.21.1-fabric.jar
• opac-warfare-26.1-neoforge.jar

1. 将 jar 放入你的服务器（以及客户端）的 mods/ 目录中。
2. （可选）安装 Xaero’s Minimap 或 Xaero’s World Map 以获得路径点和地图功能。

📖 命令与指南

| 命令 | 权限 | 描述 |
|—|—|—|
| /war start | opac.warfare.start | 对你所站的可宣战边界区块宣战。 |
| /war status | opac.warfare.status | 显示你当前活跃战争的状态和占领进度。 |
| /war list | opac.warfare.status | 显示对你可见的活跃战争和正在进行的围攻。 |
| /war near [radius] | opac.warfare.status | 查找区块半径内的战争（默认：8，最大：32）。 |
| /waradmin list | opac.warfare.admin | 查看所有维度中所有活跃和准备中的战争。 |
| /waradmin stop <uuid\|chunk> | opac.warfare.admin | 强制停止战争并将认领恢复给原所有者。 |
| /waradmin setprogress <uuid\|chunk> <0-100> | opac.warfare.admin | 以管理员身份修改占领进度。 |
| /waradmin skip_preparation <chunk> | opac.warfare.admin | 跳过准备倒计时并立即激活围攻。 |

（旧版 customclaims.* 权限仍作为别名受支持，以保持向后兼容。）

有关高级服务器配置、突袭时段设置和权限节点，请查看我们的 Documentation Wiki。