KCDDSX - 通过DSX实现DualSense自适应扳机

[size=5][b]下载提醒 — 2026-11-01[/b][/size]
[b]请暂缓下载安装，等待复核结果。[/b] Windows 0.5.0 主文件目前被 Nexus Mods 自动安全检查隔离，暂时无法下载。已提交人工复核申请，正在等待结果，目前尚不能确认属于误报。请勿为运行此文件绕过安全警告或关闭安全软件。可选的 Source Code 文件仅供审阅和自行构建，不能直接当作游戏 Mod 安装。收到复核结果后将更新本页。
[line]

[size=6][b]KCDDSX Adaptive Triggers / 自适应扳机[/b][/size]
英文在前 · 中文说明见下方

[size=5][b]English[/b][/size]
为《天国：拯救 1》提供 DualSense 自适应扳机反馈，由 DSX 驱动。

[size=4][b]Features[/b][/size]
[list]
[]在你拉动 R2 之前，弓的阻力就已存在。[/]
[]ReadyToFire 阶段会增加阻力。取消或射出后恢复到所持弓的基准阻力。[/]
[]近战和空手：当体力低于 80% 时，L2 和 R2 都会逐渐变重。[/]
[]起手挥击保持轻量；恢复会降低阻力。[/]
[]暂停、对话和缺少游戏遥感数据时会释放效果。[/]
[]独立 Lua mod 与便携式中英文桥接程序。不依赖 Cheat，也无需安装 Python。[/]
[/list][size=4][b]Requirements[/b][/size]
Windows x64、KCD1、DualSense 手柄，以及已启用 Incoming UDP 的 [url=https://store.steampowered.com/app/1812620/DSX/]DSX[/url]。默认值：127.0.0.1:6969，手柄索引 0。独立 0.5.0 包已在 USB DualSense / Steam KCD1 1.9.7 / DSX 3.1.7 环境下测试。玩家确认自动加载、拉弓/取消/放箭、持剑与空拳疲劳/恢复，以及暂停/恢复均正常工作。

[b]使用 DSX 手柄模拟时，请为本游戏关闭 Steam 输入[/b]，以防止输入重复。

[size=4][b]Install[/b][/size]
[list=1]
[]关闭游戏并解压 Windows ZIP。[/]
[]将 KCDDSX 拖入 KingdomComeDeliverance/Mods。[/]
[]清单文件必须位于 Mods/KCDDSX/mod.manifest，而不是嵌套在另一个 KCDDSX 文件夹内。[/]
[]如果你使用 Mods/mod_order.txt，请添加一行 KCDDSX，并保留其他条目。[/]
[]启动 DSX 并启用 Incoming UDP。双击 Mods/KCDDSX/KCDDSXBridge.exe。它会自动检测游戏目录并自动启动。[/]
[]保持桥接窗口打开，启动游戏并加载存档。[/]
[/list]支持手动安装；Vortex 部署尚未测试。

[size=4][b]Uninstall[/b][/size]
关闭桥接以释放效果并恢复 DSX 配置。关闭游戏，然后移除 Mods/KCDDSX 及其可选的 mod_order.txt 行。可选偏好设置位于 %LOCALAPPDATA%/KCDDSX/settings.json。

[size=4][b]Known limits[/b][/size]
[list]
[]弓的反馈基于离散的动画/动作事件，而非连续拉弓百分比。[/]
[]空手疲劳也会在低体力下行走/冲刺后生效；不仅限于持续的拳击架势。[/]
[]疲劳约每 500 毫秒更新一次。端到端延迟尚未基准测试。[/]
[]应只有一个自适应扳机写入程序控制此手柄。请停止旧的原型桥接程序。[/]
[]KCD2、蓝牙、DualSense Edge、其他商店/版本以及 Vortex 部署均未测试。[/]
[]EXE 未签名；源码与构建说明单独提供。[/]
[/list]此版本不替换图形 DLL/配置、DLSS 或帧生成文件、按键绑定或存档。它读取游戏状态，但不修改体力、物品栏或战斗平衡。不包含 Cheat 或提取的游戏资源。网络通信仅限于本机 DSX UDP。

[size=4][b]Troubleshooting[/b][/size]
等待游戏：加载存档并检查 Mod 是否启用，以及游戏根目录的 kcd.log 是否在更新。DSX 连接失败：检查 Incoming UDP、端口、USB 连接和手柄索引。输入重复：禁用本游戏的 Steam 输入。详见随附的中英文 README。

原始项目代码采用 MIT 许可；捆绑的运行时保留各自许可。非官方社区项目，与 Warhorse Studios、Sony 或 Paliverse 无隶属关系。

[line]
[size=5][b]中文说明[/b][/size]
通过 DSX 为《天国：拯救 1》加入 DualSense 自适应扳机反馈。

[size=4][b]主要功能[/b][/size]
[list]
[]只要拿着弓，R2 就有基础阻力，不必等开始拉弓后才变紧。[/]
[]拉弓到 ReadyToFire 阶段后，R2 阻力进一步增强；取消拉弓或射出箭后，回到持弓基础阻力。[/]
[]拔出近战武器或空手时，体力低于 80% 后，L2 和 R2 会随体力减少逐级变紧；体力恢复后变松。[/]
[]前几下保持轻松：体力 80%–100% 时不加疲劳阻力，耗尽时最高 6/8。[/]
[]暂停、对话或缺少游戏状态时释放扳机效果。[/]
[]独立 Lua Mod，附中英文便携桥接程序，不要求安装 Cheat 或 Python。[/]
[/list][size=4][b]运行要求与实测环境[/b][/size]
Windows 64 位、《天国：拯救》一代、DualSense 手柄，以及 [url=https://store.steampowered.com/app/1812620/DSX/]DSX[/url]。在 DSX 中开启“传入 UDP”，默认地址 127.0.0.1、端口 6969、手柄索引 0。

独立 0.5.0 已在 Steam 游戏版 1.9.7、DSX 3.1.7、USB 连接的 DualSense 上实测。用户确认自动加载、持弓阻力、拉弓取消/放箭、持剑与空拳体力反馈、恢复及暂停/继续均正常。

[b]使用 DSX 模拟手柄时，请关闭本游戏的 Steam 输入，避免一次按键触发两次操作。[/b]

[size=4][b]拖放安装[/b][/size]
[list=1]
[]退出游戏，解压 Windows ZIP。[/]
[]把里面的 KCDDSX 文件夹拖进 KingdomComeDeliverance/Mods。[/]
[]确认路径是 Mods/KCDDSX/mod.manifest，避免多嵌套一层文件夹。[/]
[]如果使用 Mods/mod_order.txt，在其中加入 KCDDSX 一行，并保留其他条目；没有这个文件则不必创建。[/]
[]启动 DSX，开启传入 UDP，再双击 Mods/KCDDSX/KCDDSXBridge.exe。程序会自动识别游戏目录并开始桥接。[/]
[]保持桥接窗口打开，启动游戏并进入存档。[/]
[/list]无需管理员权限或 -devmode。桥接窗口有 English / 中文切换按钮。手动拖放安装已验证，Vortex 部署尚未测试。

[size=4][b]更新与卸载[/b][/size]
更新前退出游戏和桥接程序，只替换 Mods/KCDDSX 文件夹。

卸载时先关闭桥接窗口，程序会释放扳机并发送 DSX 配置还原指令。退出游戏后移除 Mods/KCDDSX；如果添加过 mod_order.txt 条目，也移除对应一行。可选的本机偏好设置保存在 %LOCALAPPDATA%/KCDDSX/settings.json。

[size=4][b]效果细节与限制[/b][/size]
[list]
[]弓箭按动作与动画事件分档，不是连续拉弓百分比。持弓时 R2 基础阻力为 3/8，ReadyToFire 后为 4/8；取消或放箭后保留 3/8。[/]
[]空手疲劳也会在空手行走、冲刺后体力不足时生效，不限于拳击。独自挥拳时，游戏没有可靠的持续举拳标记。[/]
[]体力反馈约每 500 毫秒更新；未正式测量端到端延迟。超过 2 秒没有新游戏状态时释放效果。[/]
[]同一手柄同时运行其他自适应扳机控制程序可能冲突；使用本版前请停止旧原型桥接。[/]
[]二代、蓝牙连接、DualSense Edge、其他商店/游戏版本和 Vortex 部署尚未验证。[/]
[]EXE 尚未签名，可使用单独提供的源码自行构建。[/]
[/list]本 Mod 不替换画质 DLL/配置、DLSS 或帧生成文件，不修改按键、存档、体力数值、物品和战斗平衡。公开包不包含 Cheat 或提取的游戏文件，网络通信只用于本机 DSX UDP。

[size=4][b]常见问题[/b][/size]
[list]
[]桥接显示“等待游戏状态”：先进入存档，确认 Mod 启用且游戏根目录的 kcd.log 在更新。[/]
[]DSX 连接失败：检查传入 UDP、端口、USB 连接与手柄索引。[/]
[]一次按键执行两次：关闭本游戏的 Steam 输入，检查是否运行其他手柄模拟软件。[/]
[]体力很高时拳击、近战扳机很轻：这是预期效果，低于 80% 后才增加疲劳阻力。[/]
[/list]安装包内附中英文 README，包含更完整的排错、兼容性和源码说明。项目原创代码采用 MIT 许可，第三方运行库保留各自许可。这是社区非官方项目，与 Warhorse Studios、Sony 或 Paliverse 无隶属关系。

[line]
[size=4][b]致谢与原作者[/b][/size]
[list]
[][url=https://github.com/Paliverse/DSX]Paliverse / DSX[/url] — 必需应用程序及官方 UDP mod 系统参考。[/]
[][url=https://github.com/pryans/kcd-cheat]pryans / KCD Cheat[/url] · [url=https://www.nexusmods.com/kingdomcomedeliverance/mods/106]Original Nexus page[/url] — 私有原型加载器及 API/调试参考。发布清单：spraguep；当前 Nexus 页面致谢：Othiden。独立版本不包含任何 Cheat 文件。[/]
[][url=https://www.nexusmods.com/kingdomcomedeliverance/mods/1344]dataframe - benjaminfoo / How-to Lua[/url] · [url=https://github.com/benjaminfoo/KCD-Coding-Guide]KCD Coding Guide[/url] — 启动与 Lua 脚本编写参考。[/]
[][url=https://github.com/python/cpython]CPython contributors[/url]、[url=https://github.com/tcltk]Tcl/Tk authors[/url]、[url=https://github.com/pyinstaller/pyinstaller]PyInstaller contributors[/url]，以及 [url=https://github.com/scoder/lupa]Stefan Behnel / Lupa contributors[/url] — 运行时、构建与开发测试。[/]
[/list]原作者链接、各项目的实际用途及第三方许可声明，均保存在玩家包和源码压缩包中的 CREDITS.md 与 THIRD_PARTY_NOTICES.md 中。
原作者链接、各项目的实际用途及第三方许可声明，均保存在安装包和源码的 CREDITS.md 与 THIRD_PARTY_NOTICES.md 中。