真第一人称射击模组

[center][size=6]TRUE FPS for Shadow of the Tomb Raider
[/size][/center]
=======================================================

适用于《古墓丽影：暗影》的真正第一人称模式：摄像机位于劳拉的眼睛位置，她的头部
和头发在你的视野中被隐藏，而她的身体在你下方保持可见。

这是首个公开版本。核心第一人称体验已可正常使用，但某些
情况、服装或动画可能仍需改进。


[size=4]1. 功能特性[/size]
-----------
- 第一人称摄像机置于劳拉的眼睛位置，可随时用 F6 切换（平滑返回
普通第三人称摄像机）。
- 第一人称下劳拉的头部、面部和头发被隐藏（仅主视角：她的影子保留）。
- 劳拉的身体、手臂和武器保持可见。F7 切换到"仅摄像机"模式，隐藏
整个劳拉。
- 可调节视野（90 到 120，默认 100），在瞄准、射击和
冲刺时保持恒定（LockFov=1）。
- 当你向侧面看超过 80 度时，劳拉的身体会平滑转向摄像机
（仅第一人称玩法）。
- 过场动画：默认使用原版游戏摄像机，或通过
劳拉的眼睛启用实验性"沉浸"模式（F2）。
- 当手、手臂、弓或手持物体过于靠近
眼睛时，摄像机会稍微后退。
- 游戏内菜单（F3）可实时调整每项设置并保存到 TrueFPS.ini。
- 启动时的安全检查：如果无法识别游戏版本，模组中
无法与游戏匹配的部分将保持禁用，游戏正常运行。


[size=4]2. 控制[/size]
-----------
F6 第一人称开 / 关
F3 配置菜单（打开时游戏不会接收鼠标和键盘输入）
F7 身体可见 / 仅摄像机（整个劳拉隐藏）
F2 过场动画摄像机：原版 / 沉浸（实验性）
F8 编辑 TrueFPS.ini 后重新加载

按键可在 F3 菜单或 TrueFPS.ini 的 [General] 部分更改。
游戏始终以普通摄像机启动：进入玩法后按一次 F6。


[size=4]3. 安装（手动）[/size]
------------------------
1. 打开游戏文件夹，即包含 SOTTR.exe 的那个文件夹。
Steam：右键点击游戏 > 管理 > 浏览本地文件。
2. 检查是否已存在名为 winmm.dll 的文件。
- 没有 winmm.dll：转到步骤 3。
- 已存在 winmm.dll：它可能属于另一个模组或另一个 ASI 加载器。
右键点击它 > 属性 > 详细信息。如果产品名称为 "Ultimate-ASI-Loader-x64"，
说明你已拥有该加载器：保留你的文件，不要复制本压缩包中的 winmm.dll。
否则，在复制我们的文件之前，将你现有的 winmm.dll 移到安全位置（例如桌面上的
"backup" 文件夹），以便日后恢复。
3. 将 TrueFPS-SOTTR-v1.0.0 文件夹中的以下文件复制到 SOTTR.exe 旁边：
TrueFPS.asi
TrueFPS.ini
winmm.dll （Ultimate ASI Loader，除非你在步骤 2 中保留了自己的文件）
4. 启动游戏。当你能够控制劳拉后，按 F6。

模组本身不需要管理员权限。如果 Windows 在复制文件时要求管理员权限，
那只是因为你的 Steam 库所在位置。
此版本不支持模组管理器（Vortex 等）：请手动安装。


[size=4]4. 卸载[/size]
-----------------
1. 从游戏文件夹中删除 TrueFPS.asi、TrueFPS.ini 和 TrueFPS.log。
2. winmm.dll：
- 如果你复制了本压缩包中的 winmm.dll 且之前没有 winmm.dll，请删除它
（除非其他 ASI 模组仍在使用它）；
- 如果你在安装步骤 2 中将之前的 winmm.dll 移到了别处，请将其放回；
- 如果你保留了自己的加载器，请保持原样。
切勿删除不是你自己安装的 winmm.dll，除非你拥有它的副本。


[size=4]5. 兼容性[/size]
----------------
测试环境：
- Shadow of the Tomb Raider，Steam 版本，build 11668867（SOTTR.exe 1.0.492.0），
Windows 11 64 位，DirectX 12。
未测试：
- DirectX 11 模式、GOG、Epic Games Store 和 Microsoft Store 版本、其他游戏更新。
在无法识别的版本上，模组会检查它所需的每个部分并禁用无法
找到的部分；游戏随后正常运行（参见 TrueFPS.log）。
其他模组：
- 服装和纹理模组：通常没问题，但某些自定义头部或发型可能无法完全
隐藏。不保证与所有服装或皮肤兼容。
- 其他摄像机、FOV 或拍照工具（摄像机工具、修改器、FOV 补丁）很可能与
第一人称摄像机冲突：请禁用它们，或至少不要同时使用。
- 覆盖层和后期处理注入器（ReShade 等）未经测试。
- 其他 ASI 加载器（dinput8.dll、version.dll、dsound.dll...）：一个加载器就够了。不要
安装两个加载器；使用你自己的或此处提供的 winmm.dll。

已知限制：
- 某些服装、发型或动画可能会短暂显示头部或头发的一部分，或让
摄像机穿入身体。
- 在瞄准、跳跃、攀爬、交互或过场动画期间，身体不会转向
摄像机：这些情况下由游戏控制劳拉。
- 沉浸式过场动画模式是实验性的。它需要劳拉的头部朝向，模组
会在玩法中跑动几秒后自行学习（保存在 TrueFPS.ini 的
[Calibration] 下）；在此之前过场动画使用游戏摄像机。
- 模组仅更改摄像机、屏幕上绘制的内容，以及第一人称玩法中
当 BodyFollow=1 时劳拉的朝向。存档文件不会被修改。


[size=4]6. 故障排除[/size]
------------------
游戏无法启动 / 启动时崩溃
- 移除 TrueFPS.asi 以检查模组是否为原因。如果游戏仍然崩溃，
问题出在另一个模组或加载器（winmm.dll）。
- 确保只安装了一个 ASI 加载器。
- 随报告发送 TrueFPS.log（参见第 7 节）。

模组未加载（F6 无反应，未创建 TrueFPS.log）
- TrueFPS.asi、TrueFPS.ini 和 winmm.dll 必须与 SOTTR.exe 位于同一文件夹，而不是
子文件夹中。
- 检查 winmm.dll 是否为 x64 Ultimate ASI Loader（属性 > 详细信息）。
- 某些杀毒软件会隔离 ASI 加载器：检查你的杀毒软件历史记录。

按 F6 后没有第一人称视角
- 第一人称仅适用于玩法：菜单和过场动画（原版模式）保持游戏
摄像机。当 F3 覆盖层启用时，每次按 F6 都会有屏幕提示确认。
- 打开 TrueFPS.log：出现 "Camera integration disabled" 一行意味着你的游戏版本
不受此版本支持。

劳拉的头部或头发重新出现
- 检查 TrueFPS.ini 中的 HideHead=1、HideHair=1、HeadPartMask=1 和
DrawTableHooks=1。RenderHooks 和 DrawTableHooks 仅在游戏启动时读取：更改后请重启游戏。
- 某些服装或模组头部尚未覆盖：请报告服装名称。

劳拉的身体转向异常
- 在 TrueFPS.ini 中设置 BodyFollow=0 并按 F8（或在 F3 菜单中取消勾选 "Body follow"）：
然后仅由游戏控制劳拉的朝向，如同第三人称。
- MaxRelativeYaw（默认 80）设置身体跟随之前你可以向侧面看多远。
- 如果日志显示 "engine write STOPPED"，模组已停止自行转动身体；
在 F3 菜单中切换 Body follow 或按 F8 重试。

瞄准时 FOV 变化
- 检查 TrueFPS.ini 中的 LockFov=1。LockFov=0 时会故意保留游戏缩放。

按键无响应
- 按键仅在游戏窗口获得焦点时有效（先点击游戏窗口）。
- 另一个程序可能使用相同的 F 键（覆盖层、录制软件、键盘工具）。
在 F3 菜单中更改按键，或在 TrueFPS.ini（[General]）中更改后按 F8。

日志文件
- TrueFPS.log 在每次启动时写入 SOTTR.exe 旁边（游戏文件夹）。它会在
每次启动时被替换：请在问题发生后立即复制它。
- 如需详细报告，在 TrueFPS.ini 中设置 Debug=1 和 Diagnostics=1，复现问题，
然后将它们改回 0。


[size=4]7. 报告问题[/size]
----------------------
请在 Nexus Mods 页面（Bugs 标签）报告可复现的问题，并附上：
- 游戏版本和平台（Steam、DirectX 11 或 12）；
- 模组版本（1.0.0）；
- 发生了什么，以及复现步骤；
- 穿着的服装；
- 第一人称（F6 开启）还是第三人称；
- 如有可能，提供截图或短视频；
- TrueFPS.log。
分类：摄像机、头部遮罩、身体旋转、瞄准 / FOV、动画、崩溃、性能或
兼容性。


[size=4]8. 致谢与许可[/size]
-----------------------
TRUE FPS 由 TRUE FPS 作者制作。权限：参见 Nexus Mods 页面。
第三方组件（许可证文本在 LICENSES 文件夹中）：
- Ultimate ASI Loader，作者 ThirteenAG（MIT）- 以 winmm.dll 形式提供。
- MinHook，作者 Tsuda Kageyu，包含 Hacker Disassembler Engine，作者 Vyacheslav Patkov（BSD-2-Clause）。
- Dear ImGui，作者 Omar Cornut（MIT）- 游戏内菜单。
- 摄像机代码锚点基于 Otis_Inf 的公开 SOTTR 摄像机工具（IGCS，BSD-2-Clause）。
- 模型数据布局来自 TrRebootModTools，作者 arcusmaximus（MIT）。
本压缩包不包含任何游戏文件或其他模组的文件。
Shadow of the Tomb Raider 是其各自所有者的商标。本模组与之无关联，
也未获得其认可。


-----------------------------------------------------------------------------------------------
[center][size=5]FRANCAIS [/size][/center]
-----------------------------------------------------------------------------------------------
TRUE FPS 1.0.0：适用于 Shadow of the Tomb Raider 的真正第一人称视角。
按键：F6 第一人称开/关，F3 菜单，F7 身体可见 / 仅摄像机，F2 过场动画
摄像机，F8 重新加载 TrueFPS.ini。
安装：将 TrueFPS.asi、TrueFPS.ini 和 winmm.dll 复制到 SOTTR.exe 旁边。如果已存在
winmm.dll，请先将其移到别处（或者如果它已经是 Ultimate ASI
Loader x64，则保留它，不要复制我们的文件）。
卸载：删除 TrueFPS.asi、TrueFPS.ini、TrueFPS.log；仅当 winmm.dll
来自本压缩包时才删除它，如果你之前有旧的 winmm.dll，请将其放回。
测试环境：Steam 版本 build 11668867，Windows 11，DirectX 12。日志：游戏文件夹中的
TrueFPS.log。