第一人称视角与射线瞄准（CLEO Redux）

GTA IV 第一人称视角与射线瞄准（CLEO Redux）

作者：Blind Holmes 版本：1.1.0

概述

一个全面的 GTA IV 第一人称相机模组，涵盖步行和驾驶玩法。包含头部模型隐藏、速度预判防穿模、步行瞄准射线对齐以及自定义步行准星。

进入和离开车辆时保持第一人称视角启用。相机在过渡期间跟随角色的头部，然后在校准后锁定车辆本地眼位，以实现稳定的驾驶体验。

车内瞄准和射击时临时使用游戏原生的第三人称驾车射击相机和准星。瞄准和开火结束后，第一人称视角恢复。

当玩家控制被禁用或加载了尚未结束的过场动画时，模组让位于游戏相机并锁定 [P]。一旦这些条件解除，之前的视角模式恢复。正常的室内游戏不会锁定 [P]。

操作

• 按 [P] 切换第一人称视角开/关。
• 步行时：瞄准（鼠标右键）和射击（鼠标左键）保持第一人称，自定义准星激活。
• 车内时：按住鼠标右键瞄准或按住鼠标左键射击，使用原生第三人称驾车射击相机和准星。游戏处理武器/车窗动画。松开按键并停止瞄准/射击后返回第一人称。
• [PageUp]：将校准后的车内眼位每次按下升高 0.02 米。
• [PageDown]：将校准后的车内眼位每次按下降低 0.02 米。

车内校准

• 在第一人称已启用的情况下进入车辆时，驾驶员校准至少在坐下后等待 3000 毫秒，并且需要有效的驾驶输入（油门、刹车/倒车或手刹）。此延迟有助于避免在引擎启动动画期间捕获到降低的头部位置。
• 仅被动移动，例如被其他车辆撞击，不会触发驾驶员校准。
• 乘客，包括出租车乘客，在坐下 1000 毫秒后自动校准；无需驾驶输入。
• 在已就座时按 [P] 启用第一人称会立即校准。执行此操作前请等待角色头部处于正常位置。
• PageUp / PageDown 仅在车内第一人称相机激活且其眼位已校准后有效。在原生驾车射击瞄准或相机暂停期间不可用。
• 高度调整立即生效，并在当前脚本会话期间延续到后续的车辆校准。它们不会保存到磁盘；重启游戏或重新加载脚本会将其重置为 CFG.carEyeUp。

需求

• 适用于 GTA IV 的 CLEO Redux（https://cleo.li/）

安装

1. 安装适用于 GTA IV 的 CLEO Redux。
2. 解压并将 "FirstPersonView.js" 复制到游戏的 "CLEO" 文件夹： <GTA IV 根目录>/CLEO/FirstPersonView.js
3. 启动 GTA IV 并按 [P]。

配置

所有关键的相机和玩法变量位于 "FirstPersonView.js" 顶部的 "CFG" 对象内：

• fov：相机视野（默认：55.0）
• eyeForward / eyeUp：步行眼位偏移
• headSmoothing：骨骼跟踪紧密度
• carEyeForward / carEyeUp：车辆本地眼位偏移（默认：0.10 / 0.04 米）。编辑 carEyeUp 以保存首选的基础高度。
• driverCalibDelay：自动驾驶员校准前的最小就座延迟（默认：3000 毫秒）。如果校准仍然捕获到启动动画，请增加此值。
• passengerCalibDelay：自动乘客校准前的就座延迟（默认：1000 毫秒）
• hideHead：在第一人称中隐藏头部组件、帽子和眼镜；在离开第一人称或临时让位于原生相机时恢复它们
• aimOnGameRay / pitchSign：步行瞄准射线对齐设置
• crosshair：自定义步行准星颜色和大小

卸载

从 "CLEO" 文件夹中删除 "FirstPersonView.js"。

更新日志

1.1.0

• 将车内瞄准和射击改为临时使用原生第三人称驾车射击相机和准星，之后返回第一人称。
• 移除了旧的车内瞄准射线对齐限制和准星偏移校准。
• 在进入和离开车辆时保持第一人称启用；头部跟踪覆盖过渡期，直到车辆眼位被校准。
• 添加了延迟驾驶员校准，要求有效的驾驶输入，有助于避免在引擎启动动画期间捕获到降低的头部位置。
• 为出租车和其他乘客座位添加了定时乘客校准。
• 添加了 PageUp / PageDown 手动车内高度调整，步进为 0.02 米，在脚本会话中保留调整后的高度以供后续校准使用。
• 更新了相机暂停，在检测到过场动画或玩家控制丢失时锁定 [P]，并在之后恢复之前的视角模式。
• 修复了 [P] 在安全屋和其他正常室内被错误锁定的问题，通过从暂停检查中移除 IS_INTERIOR_SCENE。

1.0.0

• 初始发布，包含步行和驾驶第一人称视角、头部隐藏、速度预判防穿模、瞄准射线对齐和自定义准星渲染。