
双持后坐力一致性修复
修复使用双持时左手武器的后坐力减少效果未正确生效的问题,并保留各枪械特有的后坐力特性。
查看大图[size=5][b]Dual Wield Recoil Parity[/b][/size]
版本 1.0.0
2.5 更新后,已确认双持时双手武器加成应用不一致的问题。为解决该问题,首先制作了 Dual Wield Shared Bonus Sync,但即使在属性一致之后,仍存在左手后坐力更大的问题。
进一步调查发现,即使左手武器的当前后坐力属性发生变更,实际后坐力计算中仍可能残留装备时的缓存值。本模组针对每把武器使用游戏自身的计算函数来刷新该缓存。
[b]主要功能[/b]
- 在开火前刷新实际后坐力计算中使用的最小·最大后坐力值。
- 不将右手数值复制到左手,而是对每把枪分别计算。
- 使用不同枪械时,保留各枪械自身的基准后坐力差异。
- 不改变后坐力方向·时间·曲线等其他参数及累积移动。
- 不赋予固定后坐力减少或无后坐力。使用当前装备与加成所产生的结果。
[b]与 Shared Bonus Sync 的关系[/b]
这是独立的后续修正模组。Shared Bonus Sync 修正共通加成数值,Recoil Parity 修正消耗该数值的实际后坐力缓存。可同时使用,互不替代。
即使没有 Shared Bonus Sync 也能加载,此时使用游戏为每把武器提供的当前数值。本模组不会独立修正其他属性加成错误。
[b]需求[/b]
- 赛博朋克 2077 2.5,已测试的 Windows 可执行文件版本 3.0.88.46235
- 支持 API v1 的 RED4ext。测试环境为 RED4ext 1.31。
- 主文件不需要 CET·redscript·Codeware·TweakXL。
仅在可执行文件的时间戳·映像大小·函数签名一致时才应用原生钩子。即使同样标记为 2.5 的游戏,若可执行文件构建不同也可能拒绝加载。并非支持所有游戏构建的通用补丁。
[b]安装[/b]
请通过 MO2 安装主 ZIP,或解压到游戏根目录。
文件位置:red4ext/plugins/DualWieldRecoilParity/DualWieldRecoilParity.dll
请先关闭旧的 Native Trace 测试版本,再启用正式包。请勿重复安装相同的 DLL。诊断用 CET 桥接与 redscript 在发行版中不需要。请重启游戏。
主 DLL 无需放在模组列表最顶部。修改相同原生函数的模组之间的冲突,无法保证通过简单的优先级调整解决。
[b]摄像机可选文件 — 仅安装其中之一[/b]
两个可选文件均为仅接受右手开火的摄像机后坐力动画过渡两处添加了左手开火。使用现有动画与混合,并非重新计算各枪械的摄像机强度或将右手数值复制到左手的功能。
[b]用于原版摄像机[/b]
文件:DWRP-Camera-Event-Parity-1.0.0-Optional.zip
在没有其他修改 player_base.animgraph 的模组的环境中使用。基于已测试的原版图表。请勿与 IFP–ITP 用一同安装。
[b]IFP–ITP 兼容用[/b]
文件:DWRP-Camera-Event-Parity-IFP-ITP-1.0.0-Optional.zip
适用于将已测试的 Immersive First Person – ITP Compatibility 2.2.0 与 IFP 及 Immersive Third Person – Best Of Both Worlds 一同使用的环境。基于已安装的 IFP–ITP 兼容图表,仅添加了两处左手事件。已通过源比较验证其余图表数据得以保留,并验证转换后双手事件过渡仍然存在。
将安装单独的存档:
archive/pc/mod/000_DWRP_CameraParity_IFP_ITP_Compat.archive
不会直接修改 IFP·ITP·IFP–ITP 原始存档。保持现有模组启用状态使用。使用 000_ 文件名以使其优先于 0_ImmersiveFirstPerson_ITP_Compat.archive 应用。更改存档名称或单独加载顺序可能导致实际优先级不同。
这是针对特定版本兼容图表的补丁,不会自动合并其他摄像机模组或其他 IFP/ITP 版本。IFP–ITP 用已通过结构及转换验证,但在该完整环境中的正常运行尚待明确的游戏内确认。
安装主后坐力修正文件后,摄像机可选文件最多仅安装一个(通过 MO2 或解压到游戏根目录)。更换可选文件时,请先关闭或移除之前的摄像机存档。若开发期间在主模组文件夹中放入过摄像机测试存档,请在安装单独可选包之前移除,以避免重复。发行用主 ZIP 仅包含 DLL 与文档。
两个可选文件均替换 player_base.animgraph,并与 DLL 的可执行文件检查分开应用。在未验证的游戏更新后,请同时关闭摄像机可选文件。若仅想还原摄像机更改,只需移除可选存档,主后坐力修正可继续保留。
[b]验证范围[/b]
在开发版本中测试了 Amnesty·Tamayura、相同枪械·不同枪械、后坐力减少达到 0 后坐力的条件以及部分移除减少效果的条件。已通过日志确认各枪械数值差异与左手缓存刷新。
摄像机效果在游玩中确认了体感改善,但未对最终摄像机移动·旋转进行测量以验证双手的数值等同性。
1.0.0 保留了已测试的最小·最大后坐力值刷新,并禁用了诊断专用钩子与逐发日志。已通过编译与模拟回归验证,整理后的 1.0.0 主 DLL 随后也在 2.5 完整配置中测试,确认后坐力减少生效。不声称已解决所有双持专长·义体·摄像机问题。
[b]删除与日志[/b]
结束游戏后关闭或删除模组。可选存档需单独删除。不会向存档文件添加永久记录。
日志:red4ext/plugins/DualWieldRecoilParity/DualWieldRecoilParity.log
在 MO2 中可能记录到 overwrite 或 RootBuilder 相关路径。
READY 表示钩子连接成功,REFUSED 表示因可执行文件或 SDK 检查失败而未应用钩子。
[b]变更历史[/b]
1.0.0:首个发行用包。按武器刷新原生后坐力缓存,禁用诊断专用钩子,提供原版用·IFP–ITP 兼容用摄像机事件补丁可选。保留 IFP/ITP 原始文件。
[size=5][b]Dual Wield Recoil Parity[/b][/size]
Version 1.0.0
After the 2.5 update, dual-wielding could leave bonuses applying differently to the two weapons. I previously created Dual Wield Shared Bonus Sync to address shared stat bonuses, but the left-hand recoil problem remained even when the displayed and live recoil stats matched.
Further investigation found a second issue: the native recoil calculation could keep using the left weapon's initial cached kick values instead of its updated values. This mod refreshes those cached values using the game's own calculation for that individual weapon.
[b]What it does[/b]
- Updates the minimum and maximum recoil kick values used by the native recoil calculation before each shot.
- Calculates each weapon separately. It does not copy the right weapon's final recoil onto the left weapon.
- Preserves differences between guns, including their own base recoil.
- Leaves recoil directions, timing, curves, other cached parameters and existing accumulated movement unchanged.
- Adds no stat modifiers and does not impose a fixed recoil reduction or zero recoil. Your current bonuses determine the result.
[b]Relationship to Shared Bonus Sync[/b]
This is a separate follow-up fix. Shared Bonus Sync addresses shared stat bonuses; Recoil Parity addresses the native recoil cache that consumes those stats. It can be installed alongside Shared Bonus Sync, and does not replace it. Shared Bonus Sync is not a hard loading dependency: without it, Recoil Parity uses whatever current stats the game gives each weapon, and does not independently repair other stat-bonus issues.
[b]Requirements[/b]
- Cyberpunk 2077 2.5, tested Windows executable file version 3.0.88.46235.
- RED4ext with API v1 support (tested with RED4ext 1.31).
- CET, redscript, Codeware and TweakXL are not required by the main file.
The DLL verifies the executable timestamp, image size and native function signatures before installing hooks. Other executable builds, including some builds with the same advertised game version, may be refused. Check the plugin log if it does not load. This is not a universal patch for every game build.
[b]Installation[/b]
Install the Main File through MO2, or extract it into the game root. The DLL should be at:
red4ext/plugins/DualWieldRecoilParity/DualWieldRecoilParity.dll
Disable the old Native Trace test version before enabling this release. Remove old test bridge scripts only if they came from this project's diagnostic package. Do not load two copies of the DLL. Restart the game after installation.
The main DLL does not need to be at the top of the mod list. Avoid another copy of this plugin or a mod that patches the same native functions; load order cannot guarantee compatibility between native hooks.
[b]Optional camera files — choose ONE[/b]
Both camera options add LeftShoot transitions beside the unchanged RightShoot transitions in two camera recoil animation state machines. They reuse the existing clips and blend settings. They do not add a separate per-gun camera-strength formula or copy recoil stats between weapons.
[b]Vanilla Camera Event Parity[/b]
File: DWRP-Camera-Event-Parity-1.0.0-Optional.zip
Use when no other mod replaces base/gameplay/anim_graphs/player_base.animgraph. This version is based on the tested vanilla graph. Do not combine it with the IFP–ITP option.
[b]IFP–ITP Compatibility[/b]
File: DWRP-Camera-Event-Parity-IFP-ITP-1.0.0-Optional.zip
Use with the tested Immersive First Person – ITP Compatibility package (2.2.0), alongside Immersive First Person and Immersive Third Person – Best Of Both Worlds. This option starts from the installed IFP–ITP compatibility graph and adds only the two LeftShoot transitions. Source comparison confirms all other graph data is preserved; CR2W round-trip validation confirms both right/left transition pairs.
It installs a SEPARATE archive:
archive/pc/mod/000_DWRP_CameraParity_IFP_ITP_Compat.archive
The original IFP, ITP and IFP–ITP compatibility archives are not edited. Keep those mods enabled. The 000_ filename is intentional so this graph can take priority over 0_ImmersiveFirstPerson_ITP_Compat.archive. Renaming archives or using custom archive load-order rules may change which graph wins.
This compatibility option targets the specific tested graph. It does not automatically merge arbitrary camera mods, other IFP/ITP versions, or additional graph replacements. The camera compatibility build has passed structural and round-trip validation; runtime behavior in the full IFP/ITP setup is still awaiting explicit confirmation.
Install the main recoil file, then at most ONE camera option through MO2, or extract their files into the game root. Switch options by disabling/removing the previous camera archive first. If you used the development test archive inside the main mod folder, remove that test archive before installing the separate optional package to avoid duplicate copies. The release main ZIP contains only the recoil DLL and documentation.
Both options replace player_base.animgraph and are independent of the DLL's executable fingerprint guard. Disable the camera option after an untested game update. To revert camera changes, remove/disable only the selected optional archive; the native recoil fix can remain installed.
[b]Validation and limits[/b]
Development builds were tested in game with matching and mixed weapons, including Amnesty and Tamayura, with and without enough recoil reduction to reach zero kick. Runtime logs confirmed distinct weapon values and refreshes on the left weapon. Camera behavior was reported as improved during gameplay, but final per-shot camera transforms and numerical left/right camera parity have not been instrumented.
The 1.0.0 release keeps the tested kick-only correction and disables diagnostic-only hooks and per-shot logging. Compilation and controlled regression tests passed. The cleaned 1.0.0 main DLL was subsequently tested in the full 2.5 profile, where recoil reduction was reported working. No claim is made that every dual-wield perk, cyberware effect, or camera behavior is fixed.
[b]Uninstallation[/b]
Close the game and disable/remove the main mod. Remove the optional archive separately if installed. The plugin does not add persistent save records.
[b]Troubleshooting[/b]
Log: red4ext/plugins/DualWieldRecoilParity/DualWieldRecoilParity.log
MO2 may redirect it into overwrite, including RootBuilder-managed paths.
READY: hooks attached. REFUSED: executable fingerprint or SDK check failed; no hooks installed.
[b]Changelog[/b]
1.0.0 - Initial public release package. Native per-weapon kick cache refresh; diagnostic-only hooks disabled; separate optional vanilla and IFP–ITP camera event archives. IFP/ITP originals remain untouched.
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。