
赛博义体被动加成修复(适用于2.5补丁)
恢复缺失的义体被动加成,包括爆头伤害、潜行伤害、跳弹伤害和闪避耐力消耗降低。同时修正STATS菜单中显示的爆头伤害倍率。
查看大图[size=5][b]义体被动加成修复[/b][/size]
[color=#46CBD9][b]《赛博朋克 2077》2.5 补丁 | Cyber Engine Tweaks | 版本 1.0[/b][/color]
[b]恢复四项未能在 V 的实时属性中正确体现的装备派生义体加成,并修正拔出武器时角色属性(STATS)菜单中显示爆头伤害倍率的问题。[/b]
这是一个范围极窄的缺陷修复,而非平衡性改动。它使用的是你当前实际装备的义体已经生成的值。它不会凭空发明额外加成、不会修改义体属性,也不会永久增强你的构筑。
[size=4][b]背景 —— 这些加成从何而来[/b][/size]
义体除了提供主要效果外,还可以提供可选的被动属性修正。其数值取决于所安装物品当前的词条数值,并且可能受到升级、相关技术(TECH)专长以及工程师进度的影响。例如,技术树中包含用于提升义体属性修正、增加修正数量以及在升级时选择不同修正组合的系统。因此,每件义体所附带的确切加成为[b]构筑相关[/b]。
基于这一原因,本模组[b]不会[/b]硬编码特定植入体列表、固定百分比,或对特定专长效果的猜测。它会查询[b]当前已装备义体物品[/b]上已有的实时 modifier-helper 值,并据此推导出总计值。
2.5 补丁之前所观察到的行为为恢复装备派生加成的目标提供了参考。但本项目并非官方的 CDPR 更新日志对比,也不主张开发者有意或无意在 2.5 补丁中做出了这些更改。
[size=4][b]问题 —— 我的发现[/b][/size]
在我于《赛博朋克 2077》2.5 补丁上进行测试时,若干义体属性加成会显示在单件装备上,但它们在 V 的实际玩家属性总计中缺失或不完整。
关键区别在于,物品的加成与 V 的加成不一定是同一个属性对象。已装备的义体物品拥有自己的属性对象。然后游戏需要将相应的装备派生效果传播到玩家的属性对象上。物品上的正确数值本身并不能证明相同数值已经到达 V 处。
使用 Cyber Engine Tweaks,我检查了两侧:
[list]
[][b]物品侧:[/b]每件已装备义体物品属性对象上对应 [b]ModifierHelper[/b] 属性的值。[/]
[][b]玩家侧:[/b]通过 [b]Game.GetStatsSystem()[/b] 直接查询的 V 上对应实时属性的值。[/]
[][b]受控变更:[/b]移除/重新安装单件义体物品、重复读取,以及不同存档之间的比较。[/]
[/list]物品侧的加成是存在且可测量的。玩家侧的总计并未始终包含它们,直到缺失的贡献被恢复为止。因此这[b]远不止是角色属性(STATS)界面上的简单拼写错误或数字格式问题[/b]:这一差异在 CET 查询的底层玩家属性值中是可观察到的。
[b]链路似乎在哪里失败[/b]
已装备义体 -> 物品属性对象 -> [b]ModifierHelper 值[/b] -> 装备到玩家的传递 -> V 的实时属性 -> 游戏玩法 / 角色属性
在受影响的案例中,helper 值可以被读取,但预期的贡献未出现在 V 的汇总属性中。一次探索性的记录级审计还在部分受影响路径中发现了缺失或不一致的 [b]EquipOnPlayer[/b] 关联,而若干无关的属性记录仍然暴露了 EquipOnPlayer 路径。在一项对照中,被检查的跳弹关联返回了 [b]CTRL_RICO=[] [/b],而一项快速破解对照及其他记录返回了 [b]EquipOnPlayer[/b]。这仅是[b]供进一步调查的线索[/b];它并未确定精确的引擎侧故障,也未证明这四项属性共享同一根本原因。
[color=#E4AF45][b]重要的技术区别:[/b][/color]这确定的是[b]观察到的故障边界[/b],而非导致该故障的精确 CDPR 内部代码更改。我并未证明 2.5 补丁是移除了特定记录引用、更改了 OnEquip/游戏逻辑包、更改了装备修正的附加时机,还是引入了另一种传递/刷新回归。该修复在不需猜测是哪个内部实现细节导致问题的情况下,绕过了缺失的玩家侧贡献。本描述有意明确说明这一不确定性,以便其他模组作者 —— 或 CDPR —— 能够调查底层原因。
[size=4][b]四项受影响的属性[/b][/size]
[b]1. 爆头伤害倍率[/b]
[list]
[][b]玩家属性:[/b]HeadshotDamageMultiplier[/]
[][b]义体来源:[/b]HeadshotDamageMultiplierModifierHelper[/]
[][b]修复:[/b]将当前已装备义体缺失的贡献加到 V 上,而不替换来自其他来源的任何合法加成。[/]
[][b]独立的显示功能:[/b]将当前拔出武器自身的爆头伤害倍率纳入角色属性读数,[b]仅用于显示[/b]。[/]
[/list][b]2. 潜行伤害加成[/b]
[list]
[][b]玩家属性:[/b]StealthHitDamageBonus[/]
[][b]义体来源:[/b]StealthHitDamageBonusModifierHelper[/]
[][b]修复:[/b]恢复已安装义体上记录的装备派生加成。[/]
[][b]范围:[/b]武器专用的消音器和潜行伤害效果不会自动添加到此玩家属性上。这些机制可能使用单独的武器侧属性和倍率。[/]
[/list][b]3. 跳弹额外伤害[/b]
[list]
[][b]玩家属性:[/b]BonusRicochetDamage[/]
[][b]义体来源:[/b]BonusRicochetDamageModifierHelper[/]
[][b]修复:[/b]恢复已安装义体缺失的贡献,并保留游戏已提供的其他合法跳弹加成。[/]
[/list][b]4. 闪避耐力消耗降低[/b]
[list]
[][b]玩家属性:[/b]DodgeStaminaCostReduction[/]
[][b]义体来源:[/b]DodgeStaminaCostReductionModifierHelper[/]
[][b]修复:[/b]恢复已安装义体在总降低量中缺失的份额。现有的非义体加成保持完好。[/]
[/list][b]并非所有义体属性都已损坏。[/b]我的审计检查了其他属性记录,包括与快速破解相关及防御属性。本次发布有意[b]仅修正这四项经过验证的装备派生加成[/b]。它不会无差别地修改暴击几率、暴击伤害、快速破解伤害、护甲、生命恢复、减伤,或所有可用的义体属性。
[size=4][b]修复如何运作 —— 技术细节[/b][/size]
本模组完全以 [b]Cyber Engine Tweaks (Lua)[/b] 实现,自动运行,并与当前已装备义体同步。无需开关或快捷键。
[b]01 —— 解析 V 与已装备义体[/b]
脚本获取 [b]Game.GetPlayer()[/b]、[b]Game.GetStatsSystem()[/b]、[b]EquipmentSystem[/b] 和 [b]TransactionSystem[/b]。通过装备系统的玩家数据,它枚举义体槽位,包括同一身体区域内的多个槽位。
它检查以下 11 个装备区域(当前扫描中为 23 个潜在位置):
[list]
[]FrontalCortexCW(3)、EyesCW(1)、CardiovascularSystemCW(3)[/]
[]ImmuneSystemCW(2)、NervousSystemCW(3)、IntegumentarySystemCW(3)[/]
[]MusculoskeletalSystemCW(3)、HandsCW(2)[/]
[]ArmsCW(1)、LegsCW(1)、SystemReplacementCW(1)[/]
[/list]每个有效的已装备 ItemID 都通过 [b]TransactionSystem:GetItemData[/b] 解析,然后通过 [b]GetStatsObjectID()[/b] 解析。检查的槽位数量并非已安装物品的数量:在我一个全装备验证存档中,扫描发现了 21 件有效义体物品。
[b]02 —— 从物品本身读取加成[/b]
对于每个已安装物品,脚本使用 [b]StatsSystem:GetStatValue(itemStatsObjectID, helperName)[/b] 查询四项对应的 [b]ModifierHelper[/b] 值。这些值来自当前实际装备的装备,包括其当前加成 —— 它们是[b]非硬编码百分比[/b],也不是从物品描述重建的。
每项属性的 helper 值被相加为一个目标装备派生总计。内部原始属性单位被保留:脚本不会假设每项属性都存储在同一数值刻度上。
[b]03 —— 仅在 V 上恢复那些缺失的贡献[/b]
对于四项目标属性中的每一项,脚本使用 [b]RPGManager.CreateStatModifier[/b] 构造一个 [b]Additive[/b] 修正,并使用 [b]StatsSystem:AddModifier(playerEntityID, modifier)[/b] 将其应用到 V 上。
这保留了游戏现有的玩家属性贡献。它[b]不会[/b]使用 RemoveAllModifiers、替换玩家的完整属性、重写义体记录,或全局更改基础游戏数值。
[b]重要的实现细节:[/b]脚本应用的是[b]四个物品侧 helper 值的完整汇总[/b],而不是自动检测玩家当前属性与已知原版基线之间的差异。这在我测试的 2.5 补丁环境中观察到的缺失贡献为其合理性提供了依据,但这也正是本发布版本[b]不得[/b]与另一个应用相同 helper 值的变通方案结合使用的原因,也是必须在未来 CDPR 补丁后重新检查的原因。
[b]04 —— 无堆叠同步[/b]
对账循环每秒运行一次([b]INTERVAL = 1.0[/b])。它将新的装备派生总计与此模组先前应用的数量进行比较。在 [b]EPSILON = 0.00005[/b] 的容差下,未更改的值保持不变。
当目标值发生变化时,脚本在应用替换之前移除[b]其自身先前的修正句柄[/b]。如果装备贡献变为零,则移除先前的修正而不添加新的修正。
这就是装备、替换、升级或移除义体不会反复堆叠相同加成的原因。
[b]05 —— 处理加载、存档切换和玩家替换[/b]
脚本不会跨存档永久保留 PlayerPuppet 对象。它跟踪玩家的 [b]EntityID 哈希[/b]以确定会话归属,并观察 [b]PlayerPuppet.OnDetach[/b] 以处理不同玩家对象复用等效 ID 的情况。
如果游戏系统在加载时暂时不可用,同步会重试。首次空扫描不会立即清除修正;一旦模组观察到已填充的装备状态,真正为空的扫描可以清除它们。模组还会在 V 分离、检测到不同玩家实体以及 CET 关闭时尝试清理。
[b]06 —— 保持输出精简[/b]
正常控制台输出仅限于初始化信息和就绪消息,例如:
[code][Cyberware Passive Bonuses Fix] v1.0 initialized.
[Cyberware Passive Bonuses Fix] Ready: 21 equipped cyberware items synchronized.[/code]错误和长时间加载等待会以有限间隔报告,而不是在每个同步周期重复刷屏。
[size=4][b]爆头伤害:为何属性显示需要单独修复[/b][/size]
上述四项义体修正才是真正的玩家属性修正。拔出武器所显示的加成则是[b]另一个问题[/b],模组有意将其单独处理。
枪械可以在[b]其武器属性对象[/b]上拥有自己的 HeadshotDamageMultiplier。该武器属性并非自动成为 EquipOnPlayer 被动加成,而且[b]不应[/b]被永久添加到 V 的玩家属性中:这样做可能会让一把收起的武器影响无关的计算,或造成重复计算。
相反,模组在原生菜单完成属性行设置后观察 [b]StatsDetailViewController.Setup[/b]。仅针对 HeadshotDamageMultiplier 行,它会:
[list]
[]检查 [b]AttachmentSlots.WeaponRight[/b] 是否存在真正拔出的武器。[/]
[]读取该武器实体的 HeadshotDamageMultiplier。[/]
[]读取 V 的实时 HeadshotDamageMultiplier,包括已恢复的义体贡献。[/]
[]仅更新[b]显示文本[/b]为 [b](玩家 HDM + 拔出武器 HDM) x 100[/b] 的整数部分。[/]
[]当没有拔出武器时,保持原始的仅玩家显示不变。[/]
[/list]在此用途下使用 [b]GetActiveItem("Weapon")[/b] 会产生误导,因为它仍可能识别出一把已收起的武器。特意使用实时 [b]WeaponRight[/b] 挂载以避免显示收起枪械的加成。
[b]我测试中的示例:[/b]
V 的玩家 HDM = 0.768268
拔出的 Unity HDM = 1.500000
合计 = 2.268268
角色属性显示值 = 226%
此示例中的武器部分为[b]仅 UI 显示[/b]。模组不会对 V 应用额外的 150% 伤害修正,也不会重写武器的伤害计算。
[size=4][b]伤害与 DPS —— 这些数字能(与不能)证明什么[/b][/size]
爆头伤害倍率是有条件的。它仅在战斗中对符合条件的爆头生效,而属性菜单的[b]每秒伤害[/b]估算并非对每次爆头、暴击、目标防御或其他情境修正的直接测量。因此,即使恢复了缺失的玩家侧爆头加成,显示的 DPS 也可能保持不变。
此外,更高的加算爆头加成[b]并不[/b]必然等同于最终射击伤害的相同百分比提升。作为一个刻意简化的说明,如果一次射击已经受益于 +170% 的加算爆头伤害,再恢复 +76 个百分点会使爆头系数从 2.70 变为 3.46,在该孤立系数上相对提升约 28.1%。实际伤害取决于哪些加成处于激活状态、伤害散布、武器、双持行为、暴击以及目标。
[size=4][b]验证 —— 实际游戏内结果[/b][/size]
我测试了装备移除与重新安装、同一存档在多次同步周期后的情况,以及另一个具有不同义体配置的存档。以下数字为[b]原始 StatsSystem 值[/b],并非通用百分比;其刻度取决于属性。
[b]测试 A:移除一个跳弹额外伤害的义体来源[/b]
移除前(已安装 21 件义体物品):
玩家 BonusRicochetDamage = 38.336498
义体派生数量 = 1.336499
移除后(已安装 20 件物品):
玩家 BonusRicochetDamage = 37.000000
义体派生数量 = 0.000000
重新安装该物品后(已安装 21 件物品),两次读数均恢复到约 38.336498 和 1.336499。在此特定测试期间,其他被跟踪的玩家属性保持不变。
[b]测试 B:从第三个循环系统槽位移除一件物品[/b]
安装物品时:
玩家 HDM = 0.768268 | 义体 HDM = 0.660268
玩家闪避降低 = 0.644724 | 义体闪避降低 = 0.094724
移除物品时:
玩家 HDM = 0.705910 | 义体 HDM = 0.597910
玩家闪避降低 = 0.618540 | 义体闪避降低 = 0.068540
重新安装物品后恢复了先前的读数。这确认了多项受影响的属性可以在不改变无关总计的情况下,对同一装备变更做出正确响应。
[b]测试 C:不同的已保存角色配置[/b]
存档 1(已安装 21 件物品):
玩家 HDM = 0.884239 | 义体 HDM = 0.848239
玩家潜行加成 = 43.126396 | 义体潜行加成 = 43.126395
玩家跳弹加成 = 38.062592 | 义体跳弹加成 = 1.062593
玩家闪避降低 = 0.578135 | 义体闪避降低 = 0.028135
原始存档(已安装 21 件物品):
玩家 HDM = 0.768268 | 义体 HDM = 0.660268
玩家潜行加成 = 28.158981 | 义体潜行加成 = 28.158981
玩家跳弹加成 = 38.336498 | 义体跳弹加成 = 1.336499
玩家闪避降低 = 0.644724 | 义体闪避降低 = 0.094724
两个存档产生的结果均与其各自的已装备义体配置相匹配。重复的未变更状态检查报告四项被跟踪属性的漂移均为零,这为修复[b]没有累积重复项[/b]提供了证据。
[size=4][b]与双持爆头修复的关系[/b][/size]
单独的[b]双持爆头修复[/b]处理的是 2.5 补丁的另一个不同症状:在测试条件下,新的双持系统未能将来自[b]专注[/b]和[b]神枪手[/b]的无条件 +10% 爆头加成应用到左手手枪/左轮手枪上。该项目修正的是左手武器攻击;本项目修正的是[b]V 上的四项装备派生义体被动[/b]以及[b]属性界面中的武器 HDM 文本[/b]。两个模组不应混淆,本发布版本不实现双持攻击修正。
[size=4][b]致模组作者与 CDPR 开发者的说明[/b][/size]
如果你想检查底层的游戏侧问题,最有用的比较是在装备变更前后,对比已装备义体的 [b]ModifierHelper[/b] 值与 V 对应的 [b]GetStatValue(playerEntityID, targetStat)[/b] —— 最好在一个未经修改的 2.5 安装上进行。
建议的调查要点:
[list]
[]检查负责在装备时传递加成的受影响物品和游戏逻辑记录,包括任何相关的 [b]EquipOnPlayer[/b] 关联和 [b]OnEquip[/b] 包。[/]
[]确定预期的修正是否未能附加到玩家、是否被意外移除,或是否附加到了不同的属性对象上。[/]
[]在装备、卸下、切换存档以及加载游戏前后,比较 helper 的物品侧值与玩家侧属性。[/]
[]检查 UI helper 与实际游戏玩法修正是否被混淆。用于构建物品提示的值并非自动等同于实时玩家修正。[/]
[]一次测试一项属性,并区分玩家装备被动与由激活武器或消音器拥有的加成。[/]
[/list][b]最强的发现[/b]是测试环境中缺失的玩家侧贡献。[b]确切的原始引擎/记录回归[/b]仍是一个假设,直到对底层游戏记录和运行时附加逻辑进行更深入检查为止。我们欢迎官方修复,使这一变通方案变得不必要。
有用的技术参考:
[list]
[][url=https://github.com/CDPR-Modding-Documentation/Cyberpunk-Modding-Docs/blob/main/for-mod-creators-theory/tweaks/stat-modifiers.md]Cyberpunk Modding Documentation —— Stat Modifiers[/url][/]
[][url=https://github.com/Cyberpunk2077-Mods/CyberEngineTweaks]Cyber Engine Tweaks 源代码仓库[/url][/]
[/list][size=4][b]需求与安装[/b][/size]
[list]
[][b]《赛博朋克 2077》2.5 补丁[/b][/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/107][b]Cyber Engine Tweaks (CET)[/b][/url],已针对你的游戏版本更新[/]
[/list][list=1]
[]安装或更新 Cyber Engine Tweaks。[/]
[]将提供的文件夹放入《赛博朋克 2077》的主安装目录内。[/]
[]启动游戏并加载存档。模组会自动启动;等待 CET 就绪消息。[/]
[/list][b]无需菜单、快捷键或手动开关。[/b]模组大约每秒重新检查一次已安装义体,并仅在需要时更新其贡献。
[size=4][b]范围、兼容性与限制[/b][/size]
[list]
[]本发布版本针对[b]2.5 补丁[/b]开发并验证。未来补丁应在使用前重新测试;如果 CDPR 原生恢复了这四项属性,未经修改的此变通方案副本可能会重复应用这些贡献。[/]
[]不要运行另一个独立地将同样的四项义体 helper 总计加到 V 上的修复。防堆叠逻辑可防止[b]本模组[/b]自身堆叠;它无法自动识别由无关模组创建的修正。[/]
[]该修复使用当前装备数据和运行时 Additive 修正。它不会更改义体物品上显示的值,也不会故意更改专长、武器记录或消音器机制。[/]
[]此脚本不会有意向玩家的构筑写入任何已保存或永久修正。模组应用运行时修正,并在分离、所有者变更和关闭时尝试清理其自身的句柄。与任何脚本模组一样,在更改模组化配置之前,请备份重要存档。[/]
[]这四项修正已针对所报告的 2.5 补丁行为进行测试,而非针对所有可能的义体配置、战斗条件、存档组合或交互模组。[/]
[]唯一的直接角色属性文本调整是针对[b]拔出武器的爆头伤害倍率[/b]。其他武器侧加成不在本发布版本的范围内。[/]
[]脚本可容忍临时加载状态失败并重试。如果你遇到持续错误,在报告缺陷时请包含 CET 消息、你的游戏版本以及已装备义体配置。[/*]
[/list][size=4][b]致谢、AI 协助与免责声明[/b][/size]
我希望能把本模组的全部功劳归于自己,但那并不诚实。很大一部分重头工作,尤其是编写和优化 Lua 代码、技术研究、故障排除和文档撰写,是在 AI 协助下完成的。
我自己的编程知识相当基础。我的贡献是在我的游戏中注意到问题、调查其行为、提出方案、检查结果数值、在游戏内测试变更、报告失败,并引导开发走向实用的修复。我还希望这些发现能以足够的细节记录下来,以便更有经验的模组作者,甚至 CDPR 的开发者,能够利用它们进一步调查底层问题。
AI 协助并不能使这成为官方 CDPR 修复,我和所使用的工具都无法保证与所有配置兼容。这些观察、实现细节和遗留的不确定性均已尽可能透明地呈现。欢迎其他模组作者进行纠正、独立验证和改进,但须遵守本模组页面上的分发许可。
感谢 Cyber Engine Tweaks 的开发者、赛博朋克 2077 模组社区,以及所有分享关于游戏系统技术知识的人。
[color=#46CBD9][b]目标很简单:你实际装备的被动加成,应当就是 V 实际获得的加成。[/b][/color]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。