回头张望 / LookBack

Project Zomboid Build 42 客户端 Mod：边跑边回头张望——按住热键并移动鼠标，视野视锥独立于身体面向转动（身体保持奔跑/行走面向，丧尸发现与渲染跟随你的张望方向）。

依赖：本 Mod 是 Java Mod，核心功能由 Java 补丁实现，必须安装 ZombieBuddy（Java Mod 框架）才能运行。 协议：MIT License

玩僵尸游戏时最常见的死法：边跑边看地图 / 被背后扑倒。原版人物奔跑时视野永远跟着身体朝向，想回头确认身后必须转身或停下。本 Mod 让你按住热键（默认鼠标中键）的同时移动鼠标，即可在奔跑/行走/冲刺中让视野方向脱离身体朝向独立转动——身体照跑，视野照看身后，僵尸的「发现你」判定也会跟随视野方向（转身回头不再等于撞进尸群）。

Getting ambushed from behind while kiting is a classic PZ death. In vanilla, your vision is glued to the direction your body faces while running. This mod lets you hold a hotkey (default: middle mouse button) and move the mouse to turn your line of sight independently of your body while running/walking/sprinting — the body keeps its direction, the view glances around, and zombie line-of-sight discovery follows your glance.

• 视野独立转向：生效时覆写视野方向（getLookAngleRadians/getLookVector），身体保持面向奔跑，视野视锥跟随鼠标，光照/发现判定同步跟随。

• 平滑转向：视野角度插值转向（可配置转速），跨侧切换先回面向再转向，不扭断脖子。

• 角度限制：张望相对面向的最大偏角可配置（默认 180° = 全向）。

• 头部跟随：头部骨骼（Bip01_Head）随张望方向偏航（钳制 ±80°，避免 180° 扭头观感怪异）。

• 场景内 HUD：中文调试面板（视野/面向/分离角/头部骨骼旋转/写入次数等）。

• 配置本地化：配置项随系统语言显示（EN / 简体中文 / 繁体中文）。

• Independent vision: while active, the look vector is overridden — the body keeps facing/running while the vision cone follows the mouse; lighting & zombie discovery follow the glance.

• Smooth turning: the vision angle interpolates at a configurable speed, and crossing from one side to the other passes through facing first.

• Angle limit: configurable max glance angle relative to facing (default 180° = full).

• Head follows: the Bip01_Head bone yaws toward the glance (clamped ±80°).

• In-game HUD: a Chinese debug panel (vision/facing/separation angle/head-bone yaw/apply count).

• Localized: settings follow the system language (EN / Simplified / Traditional Chinese).

本 Mod 的 Java 补丁通过 ZombieBuddy 的 Java agent 注入游戏。每个玩家（客户端）都必须安装 ZombieBuddy。

1. Steam 创意工坊订阅 ZombieBuddy。
2. 运行 ZombieBuddyInstaller.exe 选择 Install（GitHub Releases 下载）。首次进入游戏时，在 ZombieBuddy 审批框选择 Allow。

This Java mod runs through ZombieBuddy's Java agent. Every player must install ZombieBuddy first:

1. Subscribe to ZombieBuddy on the Steam Workshop.
2. Run ZombieBuddyInstaller.exe and choose Install. On first launch, choose Allow in the approval dialog.

• 发布版：Steam 创意工坊订阅「回头张望 / Look Back」，在 Mod 管理器启用。

• 未发布 / 本地测试：把 LookBack/（含 common/、42/）复制到 %USERPROFILE%\Zomboid\mods\LookBack\，在游戏 Mod 管理器启用。

• Published: subscribe on the Steam Workshop and enable in the mod manager.

• Local / unpublished: copy LookBack/ (with common/ and 42/) into %USERPROFILE%\Zomboid\mods\LookBack\ and enable it.

1. 用面板 / FTP 把 LookBack/ 上传到服务器 Zomboid/mods/。

2. 服务器配置 Mods=LookBack（本地 mod 用 Mods=，工坊 mod 用 WorkshopItems= 填工坊 ID）。

3. 重启服务器；客户端也须安装 ZombieBuddy + 本 Mod，mod 列表才能匹配。

4. Upload LookBack/ to the server's Zomboid/mods/.

5. Set Mods=LookBack in the server config.

6. Restart; clients must also have ZombieBuddy + this mod so the mod lists match.

• 热键：默认鼠标中键（按住生效）；Options → Mods → 回头张望 中可改。

• 角度限制 LookAngleLimit：张望相对面向的最大偏角（默认 180）。

• 转向速度 LookTurnSpeed：视野插值转速，度/秒（默认 180）。

• 头部偏航钳制：Java 常量 LookBackService.HEAD_YAW_LIMIT_DEG（默认 80°），需改代码重编译。

• Hotkey: default middle mouse button (hold to glance); remappable in Options → Mods → 回头张望.

• LookAngleLimit: max glance angle relative to facing (default 180).

• LookTurnSpeed: vision interpolation speed, deg/sec (default 180).

• Head yaw clamp: Java constant LookBackService.HEAD_YAW_LIMIT_DEG (default 80°), requires rebuild.

需要 JDK（本项目用 25）。从 java/ 目录：

.\gradlew.bat build             # 编译并安装 42/media/java/client/LookBack.jar
.\gradlew.bat deployLocalMod    # 部署到 %USERPROFILE%\Zomboid\mods\LookBack

build.gradle 中的游戏/ZombieBuddy/部署路径为本机硬编码，按需修改。signJarZBS 每次构建都会重新生成 .zbs 签名。

Requires JDK (this project uses 25). From java/:

.\gradlew.bat build             # compile & install the JAR
.\gradlew.bat deployLocalMod    # deploy to %USERPROFILE%\Zomboid\mods\LookBack

Paths in build.gradle are machine-specific; adjust as needed. signJarZBS re-signs on every build.

LookBack/
├─ common/                    # 跨版本元数据与翻译 (metadata & translations)
│  ├─ mod.info
│  └─ media/lua/shared/Translate/{EN,CN,CH}/*.json
├─ 42/media/                  # B42 内容 (B42 content)
│  ├─ lua/client/             # 模组设置面板 (options panel)
│  └─ java/client/LookBack.jar   # 构建产物 (build output)
└─ java/                      # Java 补丁源码 + Gradle 构建 (Java patches & Gradle)

本项目的作者公钥已合入 ZombieBuddy 的 authors.json（GitHub PR，由 Zed 签名缓存），每次构建都会为 LookBack.jar 生成匹配的 .zbs 签名（Ed25519）。玩家安装后由 ZombieBuddy 校验：先从 authors.json 取公钥，若列表未刷新则回退读取作者 Steam 个人资料简介中的 JavaModZBS:<公钥>。公钥：a140d928eed497c39427d85fb849a202e883146cca5dbfd3c8949796e1f7146a。详见 ZombieBuddy ModSigning。

The author's public key has been merged into ZombieBuddy's authors.json (via a GitHub PR, signed & cached by Zed). Every build produces a matching .zbs Ed25519 signature for LookBack.jar. ZombieBuddy verifies from authors.json first; if the list is stale it falls back to the JavaModZBS:<pubkey> string in the author's Steam profile summary. Public key: a140d928eed497c39427d85fb849a202e883146cca5dbfd3c8949796e1f7146a. See ZombieBuddy's ModSigning doc for details.

• 本项目是开源项目，所有玩家与开发者都可以对源码学习、审查、共同开发。

• MIT License（见 LICENSE）。

• 致谢：ZombieBuddy —— Java mod 补丁框架。

• This project is open source; everyone is welcome to study, audit and co-develop.

• MIT License (see LICENSE).

• Credits: ZombieBuddy — the Java mod framework.