模组简介

这是面向《赛博朋克2077》打造的武器射击模式控制框架类模组，核心作用是给指定武器单独配置按键切换射击模式的功能，不会对游戏内其余未经过配置的武器产生任何原有行为上的干扰。它本身并不会直接修改游戏内任意武器的默认属性，也不会自动为所有武器添加额外的射击模式，本质上是为模组创作者提供一套标准化的开发资源，同时给有自定义武器战斗体验需求的玩家提供可自行调整的底层支持，不管是想要给单发射击的原厂手枪加设全自动模式、还是想要让原本默认开镜才切换连射的智能武器改成手动按键切换，都可以依托这个框架完成对应的调整，不需要改动游戏核心的武器逻辑代码。

功能要点

  • 提供专属的ManualTriggerSwap标签，添加到对应武器的记录中，就能让该武器脱离游戏原生开镜自动切换射击模式的逻辑，改为通过自定义按键手动完成射击模式切换，还附带ForceAuto、RemoveAuto、NoAutomaticReload等更多可用标签适配不同的自定义需求
  • 被动完成音频适配修复，会自动为游戏内原本没有原生配置消音音效、充能音效以及不同射击模式对应专属音效的武器音频集补上对应声音资源，不会出现切换射击模式后开枪音效丢失、错配的问题
  • 新增专属的TweakDB开发资源，提供BaseStats.SecondaryDependantStatModifier字段，可用于制作仅在第二射击模式下生效的属性修正效果，例如单独提升全自动模式下的后坐力、降低连射时的射速，不影响武器半自动模式下的原有属性
  • 新增Prereqs.IsPrimaryTrigger和Prereqs.IsSecondaryTrigger两个 effector 专用前置判定记录，可以根据当前武器所处的射击模式，单独判定对应效果是否生效，方便创作者拆分不同射击模式下的伤害、特效逻辑
  • 提供多份原生消音器的复刻基准资源，这些资源完全保留原版消音器的所有数值玩法效果，但不会修改武器的默认开枪音效，开发者可以直接将其预安装在自定义武器上，或是以它为基准制作自己的自定义消音器配件

前置依赖说明

该模组属于赛博朋克2077的模组开发框架类资源，使用前需要先确保游戏环境已安装对应版本的游戏脚本扩展库，所有具体的前置安装要求可以查看该模组压缩包内附带的说明文档，原文未给出的其余未标注前置项以压缩包内说明为准。

安装方法

该模组不支持神尺一键安装，所有安装步骤请以压缩包内说明为准，安装过程中需要注意将模组内包含的asi、dll、ini、pak等格式文件，按照文档指引放置到对应游戏目录位置，不要随意改动原有游戏核心文件的路径与命名。如果你是模组创作者，还可以根据压缩包内附带的指引文档，调用框架提供的各类标签与TweakDB资源，完成自定义武器射击模式的相关开发工作。

注意事项与兼容性

该模组本身不会主动修改任何游戏内武器的默认行为，所有射击模式的调整都需要通过添加对应标签、修改武器记录的方式手动完成，因此不会和大部分仅修改武器数值、外观的普通模组产生直接冲突。需要注意该框架的所有自定义判定逻辑依托游戏的脚本钩子运行，如果你同时安装了其余大规模修改武器战斗逻辑的模组，可能会出现自定义射击模式不生效的情况，可以通过调整模组加载顺序排查问题。该框架适配《赛博朋克2077》的正式版游戏本体，测试版、测试分支的游戏版本可能存在适配问题，安装前请确认你的游戏版本符合要求。另外该框架提供的无音效消音器基准资源，仅用于模组开发场景，普通玩家如果没有搭配对应的武器配置模组，单独安装这个框架不会直接获得任何新的可使用武器或者消音器配件。

常见问题

部分玩家安装完这个模组之后，进入游戏发现所有武器的射击模式都没有发生任何变化，这是正常现象，因为这个框架本身不会主动修改武器属性，只有搭配其余依托该框架开发的武器自定义模组，或是自己手动给指定武器添加对应标签之后，才能体验到手动切换射击模式的功能。

部分玩家在给武器添加ManualTriggerSwap标签之后，发现该武器依然会在开镜的时候自动切换射击模式，这是因为标签添加的位置有误，没有正确写入该武器的TweakDB对应记录中，可以参考框架附带的文档示例调整标签的写入位置。

使用该框架提供的SecondaryDependantStatModifier制作的射速调整效果，在非第二射击模式下依然生效，可以检查该属性修正的判定条件是否正确绑定了第二射击模式的前置判定，确保没有写错字段的引用路径。