第三人称视角（TPV镜头）启用器

描述
此模组允许你在《天国：拯救2》中使用可自定义快捷键，在第一人称与第三人称视角之间自由切换，为你带来波西米亚中世纪世界的全新视觉体验。

主要特色

• 按下一个键即可在第一人称与第三人称视角间切换（默认：F3）
• 专用按键强制切换第一人称或第三人称视角
• 菜单/对话打开时自动切换镜头
• 第三方视角自定义视场角设置
• INI配置文件提供完全自定义设置
• 开源透明，所见即所得
  

需求

• 《天国：拯救2》（Steam版）
  

安装
1. 将压缩包内所有文件解压至游戏目录：
 

`<KC:D 2 安装目录>/Bin/Win64MasterMasterSteamPGO/`

2. 启动游戏后，按 F3（默认键）切换视角模式

Linux / Steam Deck (Wine/Proton)
由于本模组使用dinput8.dll作为ASI加载器，需告知Wine/Proton调用捆绑版DLL而非系统内置版本。

Steam： 前往游戏属性 → 启动选项，并添加：

WINEDLLOVERRIDES="dinput8=n,b" %command%

命令行： 在启动命令前添加：

WINEDLLOVERRIDES="dinput8=n,b"

安装文件夹结构

您将下载的内容：
KCD2_TPVToggle.zip
KCD2_TPVToggle.asi # 模组本体
KCD2_TPVToggle.ini # 配置文件
dinput8.dll # 终极 ASI 加载器（附赠，方便使用）
KCD2_第三人称切换_说明.txt # 文档
KCD2_TPVToggle_致谢.txt # 第三方许可信息

文件放置位置：
《天国：拯救2》安装
└── 二进制文件
   └── Win64MasterMasterSteamPGO # 将所有文件复制至此
       KCD2_第一人称切换插件.asi
       KCD2_TPVToggle.ini ✓
       ✓ dinput8.dll
       └── KingdomCome.exe（原版游戏文件）
       ```yaml
语言：中文
翻译：
└── ...（其他游戏文件）
```

依赖关系
此模组依赖于 终极ASI加载器 由ThirteenAG提供，已包含于下载包中。此核心组件：

• 允许该模组以ASI插件形式注入游戏
• 在游戏启动时处理模组的加载与执行。
• 只需将文件放入游戏目录即可轻松安装
  

配置
该模组可通过编辑 KCD2_TPVToggle.ini 文件进行配置：

[设置]
切换第一人称与第三人称视角
; 支持按键名称、修饰键及组合键（例如：F3、Ctrl+F3、F3,F4）
; 参见 https://github.com/tkhquang/DetourModKit?tab=readme-ov-file#supported-input-names
切换键 = F3

; 始终切换到第一人称视角的按键
FPVKey =

; 始终切换至第三人称视角的按键
TPVKey =

; 日志等级：调试、信息、警告、错误
日志等级 = 信息

启用覆盖检测与自动切换镜头
启用覆盖功能 = true

; 第三人称自定义视野（角度，留空以禁用）
TpvFovDegrees = 68.75

使用控制器
DetourModKit v2 原生支持手柄输入 XInput API. 在 INI 文件中直接使用手柄按键名称：

; 示例：使用手柄Y键切换视图
切换键 = 手柄_Y

; 示例：使用组合键
切换键 = 手柄LB+手柄Y

; 示例：多个独立连招（逗号表示连招间的“或”关系）
; 仅按F3 或（按住LB + 按Y）——键盘与手柄通用
切换键 = F3，手柄_LB+手柄_Y

支持的输入包括：手柄A键、B键、X键、Y键、LB键、RB键、LT键、RT键、开始键、返回键以及方向键。

查看完整列表 支持的输入名称 参考。

仅限X输入： Xbox 手柄可直接使用。PS4/PS5/Switch 手柄请使用 DS4Windows, DualSenseX, 更好的手柄体验或使用 Steam 输入功能，将你的控制器模拟为 XInput。详见 手柄兼容性 详情请见。

或者，你依然可以使用 JoyToKey 或 Steam 输入 将手柄按钮映射到键盘按键。

FPV 按键
你可以设置与游戏内UI交互对应的第一人称按键（例如M、P、I、J、N分别对应地图、特长、背包、日志、贵族）。按下这些键会自动切换至第一人称视角，以避免第三人称视角下出现UI错误。

若启用此功能，请更新FPVKey列表以匹配游戏内的按键设置。

可选功能
叠加层检测：
当启用覆盖功能时，模组将：

• 打开菜单/对话时自动切换为第一人称视角
• 关闭菜单/对话框后恢复上一个视角
• 在叠加界面中过滤滚轮输入，防止镜头移动
  

自定义视野：
将第三人称视场角（TpvFovDegrees）设为0-180之间的任意数值，即可覆盖默认第三人称视野范围。常用值为60-90度（游戏默认约68.75度）。

长按滚动功能：

新增选项，令您能在第三人称视角下精准控制鼠标滚轮滚动。

• 完全可选的按键长按机制，用于调整镜头距离
• 默认情况下，滚动功能已关闭
• 仅在你选择的特定按键被按住时，才进行滚动。
• 完全兼容现有的覆盖检测系统
  

空键位设置
对于每种按键类型，留空设置即可禁用该功能：

• 设置

  ToggleKey = 切换按键 

  将禁用切换功能
• 设置

  FPVKey = 

  将禁用自动切换到第一人称视角
• 设置

  TPVKey = 

  将禁用明确切换到第三人称视角
  

如果三个按键设置均为空，模组仍会初始化，但不会监测任何按键。

支持的全部按键名称列表，请参见 支持的输入名称 参考：仍支持十六进制虚拟键码（如0x72）。

已知问题与限制

视角与镜头限制：

• 第三人称视角下，摄像机可能穿过物体（无碰撞检测）
• 部分游戏事件或菜单在第三人称视角下可能暂时出现异常（菜单、地图、对话等）。
  
  • 变通方案： 使用默认第一人称按键（M、P、I、J、N），可在使用这些功能时自动切换至第一人称视角；或启用叠加检测功能。
    
• 在某些游戏场景中，摄像机距离可能会意外变动。这是游戏自带的实验性（调试）第三人称模式本身的特性。
• 骑马时镜头轻微倾斜
• 目前摄像头的偏移操控功能与交互射线检测不匹配（准星点会出现偏移）
  

特定场景下的稀有镜头表现：

在汉斯抱起亨利的过场中（应为游戏开篇的关键剧情节点），切换第一人称与第三人称视角可能导致镜头及角色模型出现异常。

详细行为：

• 场景采用了固定视角的镜头，并设定了特定位置。
• 切换至第三人称视角可能导致亨利身体旋转异常
• 返回第一人称视角可能不会恢复原有的镜头位置
  

冲击力： 此问题似乎仅出现在该特定脚本化片段中，该片段内角色的站位完全由游戏控制。

推荐方式：

• 在此特定场景中保持第一人称视角
• 场景结束前请勿切换视角
• 若误切换视角，需重新载入上一个存档。
• 临时解决方案： 只需重命名

  KCD2_TPVToggle.asi

  至

  KCD2_TPVToggle.bak

  或将其从你的游戏目录中移除
  

注意： 此行为仅限该剧情片段中出现，并非普遍性模组问题。

通用限制：

• 第三人称视角采用了游戏的实验性功能，可能存在不完善之处。
• 目前仅与Steam版游戏完成适配测试
  

故障排除
如果你遇到问题：

• 在INI文件中将LogLevel设为DEBUG
• 检查游戏目录中的日志文件（KCD2_TPVToggle.log）
• 若使用JoyToKey或Steam输入，请确认手柄键位设置无误。
• 针对记忆模式错误，该模组需更新以适应当前游戏版本。
  

游戏更新后： AOB（字节数组）模式扫描系统会自动适配游戏的小幅变更，但如果核心游戏功能发生改动，大型更新可能需要同步升级模组。

**致谢与源代码**
基于 绕路模组工具包 核心功能。

• 十三AG 用于终极ASI加载器
• 诅咒 安全钩
• Brodie Thiesfield 开发，SimpleIni 制作
• 感谢 Frans 'Otis_Inf' Bouma 提供的摄像机工具与创作灵感
• 战马工作室打造了这款令人惊叹的游戏
  

我所有的《天国：拯救2》模组和工具都在这里了。 GitHub代码库欢迎贡献或提出改进建议！