第三方视角（TPV摄像机）启用器（已过时）

[size=5][b]📢新模组：Proper Third Person View (TPV Camera)[/b]



我发布了一个全新的、从头构建的第三人称视角模组：[url=https://www.nexusmods.com/kingdomcomedeliverance2/mods/3263]Proper Third Person View (TPV Camera)[/url]。



与TPVToggle 启用游戏内置调试相机不同，它保持游戏处于第一人称视角，并在其之上重建第三人称视角，然后添加了真正重要的部分：相机碰撞（避免穿墙）、基于光线投射的准星对齐、自由观察轨道、缩放以及游戏内预设管理器。它在底层实现上更简单，且在日常游戏中表现更好。



[b]这对 KCD2_TPVToggle 意味着什么：[/b]该模组现已进入维护模式。我将尽可能使其在游戏更新后仍能工作，但此后将不再有功能更新。为了获得更好的体验，请下载上述新模组。



感谢所有使用过TPVToggle 并提供反馈的人。希望你们喜欢新模组！





描述[/size]

此模组允许在《天国：拯救 II》中使用可自定义的热键切换第一人称和第三人称相机视角，为你提供波希米亚中世纪世界的新视角。



[size=5]主要功能[/size]

[list]

[]使用按键切换第一人称和第三人称视角（默认：F3）[/]

[]强制切换第一人称或第三人称视角的专用按键[/]

[]菜单/对话打开时自动切换相机[/]

[]为第三人称视角自定义视野 (FOV) 设置[/]

[]通过 INI 配置文件完全自定义设置[/]

[]开源，完全透明[/]

[/list]



[size=5]需求[/size]

[list]

[]《天国：拯救 II》（Steam 版本）[/]

[/list]



[size=5]安装[/size]

1. 将档案中的所有文件解压到你的游戏目录：

 

[code]<KC:D 2 安装文件夹>/Bin/Win64MasterMasterSteamPGO/[/code]

2. 启动游戏，按 F3（默认）切换相机视角



[size=5]Linux / Steam Deck (Wine/Proton)[/size]

由于此模组使用 dinput8.dll 作为 ASI 加载器，你需要告诉 Wine/Proton 使用捆绑的 DLL 而非其内置版本。



[b]Steam：[/b]前往游戏的属性 → 启动选项，添加：

[code]WINEDLLOVERRIDES="dinput8=n,b" %command%[/code]



[b]命令行：[/b]在你的启动命令前添加：

[code]WINEDLLOVERRIDES="dinput8=n,b"[/code]



[size=5]安装文件夹结构[/size]

[code]

你将下载：

KCD2_TPVToggle.zip

├── KCD2_TPVToggle.asi    # 模组本体

├── KCD2_TPVToggle.ini    # 配置文件

├── dinput8.dll           # Ultimate ASI Loader（为方便已包含）

├── KCD2_TPVToggle_Readme.txt            # 文档

└── KCD2_TPVToggle_Acknowledgements.txt # 第三方许可信息



文件放置位置：

《天国：拯救 II》安装目录

└── Bin

   └── Win64MasterMasterSteamPGO     # 将所有文件复制到此

       ├── KCD2_TPVToggle.asi        ✓

       ├── KCD2_TPVToggle.ini        ✓

       ├── dinput8.dll               ✓

       ├── KingdomCome.exe           （原始游戏文件）

       └── ...                       （其他游戏文件）[/code]



[size=5]依赖项[/size]

此模组严重依赖 ThirteenAG 的 [url=https://github.com/ThirteenAG/Ultimate-ASI-Loader]Ultimate ASI Loader[/url]，该加载器已包含在下载包中。此必要组件：

[list]

[]允许模组作为 ASI 插件注入游戏[/]

[]处理游戏启动时模组的加载和执行[/]

[]只需将文件放置在游戏目录中即可简化安装[/]

[/list]



[size=5]配置[/size]

通过编辑 KCD2_TPVToggle.ini 文件进行配置：

[code]

[Settings]

; 在第一人称和第三人称视角之间切换

; 支持命名键、修饰键和组合键（例如，F3、Ctrl+F3、F3,F4）

; 参见 https://github.com/tkhquang/DetourModKit?tab=readme-ov-file#supported-input-names

ToggleKey = F3



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

FPVKey =



; 始终切换到第三人称视角的键

TPVKey =



; 日志级别：DEBUG, INFO, WARNING, ERROR

LogLevel = INFO



; 启用覆盖层检测和自动相机切换

EnableOverlayFeature = true



; 第三人称视角的自定义视野（度，留空则禁用）

TpvFovDegrees = 68.75[/code]



[size=5]与手柄配合使用[/size]

DetourModKit v2 通过 [b]XInput[/b] API 原生支持游戏手柄输入。在 INI 文件中直接使用手柄按键名称：



[code]

; 示例：用手柄Y键切换视角

ToggleKey = Gamepad_Y



; 示例：使用修饰键组合

ToggleKey = Gamepad_LB+Gamepad_Y



; 示例：多个独立组合（逗号表示组合之间的“或”关系）

; 单独按 F3 或（按住 LB 后按 Y）——键盘和手柄可互换使用

ToggleKey = F3,Gamepad_LB+Gamepad_Y[/code]



支持的输入包括 Gamepad_A、Gamepad_B、Gamepad_X、Gamepad_Y、Gamepad_LB、Gamepad_RB、Gamepad_LT、Gamepad_RT、Gamepad_Start、Gamepad_Back 和方向键方向。



有关完整列表，请参阅 [url=https://github.com/tkhquang/DetourModKit?tab=readme-ov-file#supported-input-names]支持的输入名称[/url] 参考。



[b]仅限 XInput：[/b]Xbox 手柄原生支持。对于 PS4/PS5/Switch 手柄，请使用 [url=https://github.com/Ryochan7/DS4Windows]DS4Windows[/url]、[url=https://github.com/Jehan-HENRY/DualSenseX]DualSenseX[/url]、[url=https://github.com/Davidobot/BetterJoy]BetterJoy[/url] 或 Steam 输入让你的手柄模拟为 XInput。详情请参阅 [url=https://github.com/tkhquang/DetourModKit?tab=readme-ov-file#gamepad-compatibility]手柄兼容性[/url]。



或者，你仍然可以使用 [url=https://joytokey.net/en/]JoyToKey[/url] 或 [url=https://store.steampowered.com/controller]Steam 输入[/url] 将手柄按钮映射为键盘按键。



[size=5]FPV 键[/size]

你可以配置与游戏内 UI 交互（例如 M、P、I、J、N 对应地图、特长、物品栏、日志、 nobility）对应的 FPV 键。这些键会自动将视角切换为第一人称，以避免第三人称视角下的 UI 错误。



如果你使用此功能，请更新 FPVKey 列表以匹配你的游戏内按键绑定。



[size=5]可选功能[/size]

[b]覆盖层检测：[/b]

当 EnableOverlayFeature 设置为 true 时，模组将：

[list]

[]在菜单/对话打开时自动切换到第一人称视角[/]

[]在菜单/对话关闭时恢复先前的视角[/]

[]在覆盖层期间过滤滚轮输入，防止相机移动[/]

[/list]



[b]自定义 FOV：[/b]

将 TpvFovDegrees 设置为 0-180 之间的任意值，以覆盖默认的第三人称视野。常见值为 60-90 度（游戏默认约为 68.75）。



[b]按住滚轮功能：[/b]



引入一项选项，让你在第三人称视角下精确控制鼠标滚轮滚动。



[list]

[]完全可选的按住键机制，用于相机距离调整[/]

[]配置后，默认禁用滚动[/]

[]仅在你选择的特定键被按住时才可滚动[/]

[]与现有的覆盖层检测系统完全兼容[/]

[/list]



[size=5]空键设置[/size]

对于每种键类型，你可以将设置留空以禁用该功能：

[list]

[]设置

[code]ToggleKey = [/code]将禁用切换功能[/]

[]设置

[code]FPVKey = [/code]将禁用自动切换到第一人称视角[/]

[]设置

[code]TPVKey = [/code]将禁用显式切换到第三人称视角[/]

[/list]



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



有关受支持键名的完整列表，请参阅 [url=https://github.com/tkhquang/DetourModKit?tab=readme-ov-file#supported-input-names]支持的输入名称[/url] 参考。十六进制虚拟键码（例如，0x72）也仍然受支持。



[size=5]已知问题和限制[/size]



[b]相机和视角限制：[/b]

[list]

[]第三人称视角下相机可能穿模（无碰撞检测）[/]

[]某些游戏事件或菜单在第三人称视角下可能暂时出现错误（菜单、地图、对话等）

[list]

[] [b]解决方法：[/b]使用默认的 FPV 键（M、P、I、J、N）在使用这些功能时自动切换到第一人称视角，或启用覆盖层检测功能[/]

[/list][/]

[]在某些游戏情况下，相机距离可能意外变化。此行为源于游戏提供的实验性（调试）第三人称模式[/]

[]骑马时相机略微倾斜[/]

[]相机偏移操作功能目前无法与交互射线对齐（准星点将错位）[/]

[/list]



[b]特定场景中的罕见相机行为：[/b]



在汉斯背着亨利的场景中（很可能是游戏开场的剧情关键时刻），在第一人称和第三人称视角间切换可能导致意外的相机和角色模型行为。



[b]详细行为：[/b]

[list]

[]该场景使用带有特定位置的强制相机视角[/]

[]切换到第三人称视角可能会错误地旋转亨利的身躯[/]

[]返回第一人称视角可能无法恢复原始的相机位置[/]

[/list]



[b]影响：[/b]此问题似乎仅出现在这个特定的脚本序列中，其中角色位置由游戏严格掌控。



[b]推荐方法：[/b]

[list]

[]在此特定场景期间，保持游戏处于第一人称视角[/]

[]在场景完成前，避免切换相机视角[/]

[]如果不小心切换了视角，你可能需要重新加载之前的存档[/]

[][b]临时解决方案：[/b]只需将

[code]KCD2_TPVToggle.asi[/code]重命名为

[code]KCD2_TPVToggle.bak[/code]或将其从游戏目录中移除[/]

[/list]



[b]注意：[/b]此行为似乎仅限于此特定故事时刻，并不代表广泛的模组问题。



[b]一般限制：[/b]

[list]

[]第三人称相机使用了游戏的实验性实现，可能并不完美[/]

[]当前仅用游戏的 Steam 版本进行过测试[/]

[/list]



[size=5]故障排除[/size]

如果遇到问题：

[list]

[]在 INI 文件中将 LogLevel 设置为 DEBUG[/]

[]检查游戏目录中的日志文件 (KCD2_TPVToggle.log)[/]

[]如果使用 JoyToKey 或 Steam 输入，请验证你的手柄映射是否正确[/]

[]对于内存模式错误，模组需要为当前游戏版本进行更新[/]

[/list]



[b]游戏更新后：[/b]AOB（字节数组）模式扫描系统会自动适应小幅游戏变更，但如果核心游戏功能被修改，重大更新可能需要模组更新。



[size=5]鸣谢与源代码[/size]

核心功能使用 [url=https://github.com/tkhquang/DetourModKit]DetourModKit[/url] 构建。



[list]

[][url=https://github.com/ThirteenAG]ThirteenAG[/url] 提供 Ultimate ASI Loader[/]

[][url=https://github.com/cursey]cursey[/url] 提供 SafetyHook[/]

[]Brodie Thiesfield 提供 SimpleIni[/]

[]Frans 'Otis_Inf' Bouma 提供他的相机工具和灵感[/]

[]Warhorse Studios 制作了这款精彩的游戏[/]

[/list]



我所有的《天国：拯救 II》模组和工具都可以在这个 [url=https://github.com/tkhquang/KCD2Tools]GitHub 仓库[/url] 中找到。欢迎贡献或提出改进建议！