# WarvsWar

---

游戏模式

• TDM（团队死斗）：红蓝对抗，团队击杀累计分数
• FFA（自由乱斗）：个人击杀排名

对局流程

• 大厅投票与倒计时
• 死亡后观战等待复活（复活延迟与复活保护可配置）
• 结算阶段展示排行榜与上局总结

TACZ 集成

• 虚拟战备：扫描 TACZ 枪包并按类型分类
• 虚拟弹药：按枪械类型配置弹匣数量（无需背包携带弹药物品）
• 虚拟改装：无需实体配件即可改装；支持战备锁定后限制改装

HUD

• 经典 BossBar 风格
• 现代 CS2 风格（服务端权威数据 + 客户端平滑倒计时）

Killcam（死亡镜头）

• 客户端创建 ghostCam 相机实体接管镜头，不修改本地玩家实体旋转
• 支持 STATIC_ANCHOR（固定死亡锚点）与 DOLLY_TO_KILLER_HOLD（推进并停靠）
• 当前 Killcam 仅控制镜头，不包含禁止移动/冻结移动包等机制

---

必需

• Minecraft 1.20.1
• Forge 47.2.0
• TACZ（开发环境依赖通常位于 libs/，本项目默认使用 libs:tacz:1.20.1-1.1.7-hotfix）

可选

• Cloth Config（客户端）：提供图形化配置界面（推荐）
• LRTactical：近战与投掷武器（服务端与客户端需同时安装）
• Cosmetic Armor Reworked：装饰盔甲槽位

1. 安装 Forge 与 TACZ（以及可选依赖）
2. 将 warvswar-<version>.jar 放入 mods/
3. 启动游戏或服务器（首次启动会生成配置文件）

# 1) 设置大厅区域（站在大厅中心）
/ww setlobby 10

# 2) 创建地图（打开图标选择界面）
/ww map create 沙漠风暴

# 3) 使用区域魔杖划定区域（出生点/观察者等）
/ww map wand 沙漠风暴 red
/ww map wand 沙漠风暴 blue
/ww map wand 沙漠风暴 ffa
/ww map wand 沙漠风暴 spectator

# 4) 开始游戏
/ww start

---

• 主菜单：Mods → WarvsWar → Config（需要 Cloth Config）
• 游戏内：/ww config（推荐，支持分类与实时保存）
• 配置文件：
  • config/warvswar-server.toml
  • config/warvswar-client.toml

配置文件：config/warvswar-server.toml

deathKillcamLockEnabled = true
deathKillcamLockDurationTicks = 50

deathKillcamFollowEnabled = true
deathKillcamFollowIntervalTicks = 2

deathKillcamCameraMode = "STATIC_ANCHOR" # 或 "DOLLY_TO_KILLER_HOLD"
deathKillcamDollyDurationTicks = 30
deathKillcamDollyStopDistance = 2.0      # 1-5
deathKillcamDollyClipEnabled = true

说明：

• deathKillcamFollowEnabled 会在锁定窗口内推送击杀者目标点，提升高延迟/未追踪到击杀者实体时的镜头稳定性。

---

/ww help
/ww start
/ww stop
/ww config

地图管理：

/ww map list
/ww map create <ID>
/ww map delete <ID>
/ww map info <ID>
/ww map seticon <ID>
/ww map wand <ID> <队伍>

---

.\gradlew build
.\gradlew clean build reobfJar

输出：build/libs/warvswar-<mod_version>.jar

1. 任何代码改动必须更新 mod_version 并通过 .\gradlew build
2. 修改网络包结构必须同步更新 PROTOCOL_VERSION（见 PacketHandler）
3. 修改 zh_cn.json 必须同步更新 en_us.json
4. SavedData 修改后必须调用 setDirty()

---

• CHANGELOG.md
• CHANGELOG-zh.md

---

All Rights Reserved © FIENDLMAO

---