模组简介

这是专为《赛博朋克2077》开发的底层输入框架类插件，专门解决过往输入类模组互相覆盖冲突的核心痛点。在没有该加载器的情况下，玩家安装多个自定义键位、操作逻辑修改的模组时，后安装的模组配置文件会直接覆盖原有文件，导致大量自定义操作失效，甚至直接触发游戏启动崩溃。该加载器的核心作用是自动遍历游戏 r6/input/ 路径下所有后缀为 .xml 的输入配置文件，将这些分散的模组输入规则和游戏原生 r6/config/ 目录下的官方输入配置做智能合并，最终生成整合后的统一配置存入 r6/cache/ 目录，完全规避了多输入模组共存时的文件覆盖问题。该模组面向所有需要修改游戏输入逻辑的模组创作者，以及安装了多个自定义操作模组的普通玩家使用，是几乎所有高阶自定义键位、操作体感、快捷功能输入类模组的必备前置工具，能大幅降低这类模组的配置门槛和冲突概率。

功能要点

  • 自动扫描指定目录下所有输入配置文件，无需玩家手动合并多个模组的XML内容，所有规则会按属性标注自动叠加到对应官方配置节点下
  • 支持给任意输入规则节点添加 append="true" 属性，开启该属性后新增的输入逻辑不会覆盖游戏原有默认配置，多个模组的同类规则也能互不干扰共存
  • 自动将合并后的最终输入配置写入对应缓存目录，同时生成专属的 input_loader.ini 配置指引文件告知游戏读取合并后的新输入规则，不需要玩家手动修改游戏原生的输入配置文件
  • 每次启动游戏时自动生成完整运行日志存入 red4ext/logs/input_loader.log，一旦出现输入异常、键位失效等问题，可以直接通过日志定位是哪一个模组的输入配置出现了格式错误，大幅降低排错成本
  • 智能识别不同类型的输入配置节点，自动将对应内容归类写入 inputUserMappings.xml 或 inputContexts.xml 两个官方配置文件，不需要模组作者手动区分文件路径存放内容

前置依赖

使用该输入加载器前必须先安装 RED4ext 插件框架，加载器本身依赖该框架的底层注入能力运行，没有正确安装RED4ext的情况下加载器无法生效，也不会生成对应的缓存配置文件。

安装方法

玩家可以选择两种安装方式中的任意一种完成部署：第一种是使用神尺模组管理器，打开 神尺 后直接在模组库找到该输入加载器，点击一键安装按钮，管理器会自动校验前置依赖、将所有对应文件放到游戏目录的正确位置，安装完成后直接启动游戏即可生效，不需要手动调整任何路径。第二种是手动安装，先确认已经提前部署好RED4ext框架，将 input_loader.zip 压缩包内的所有内容解压到游戏根目录，所有文件对应目录会自动对齐到游戏的 red4ext、r6、engine 相关文件夹下，具体的文件分布细节以压缩包内说明为准，解压完成后不要自行移动任何生成的dll、ini类文件位置。如果后续需要完全卸载该加载器，只需要依次删除 red4ext/input_loader/ 文件夹、r6/cache/inputContexts.xml 文件、r6/cache/inputUserMappings.xml 文件、engine/config/platform/pc/input_loader.ini 文件即可，不会残留任何冗余的配置内容。

兼容性与注意事项

该加载器目前仅支持官方输入配置根节点下的直属子节点，所有需要添加的输入规则都要放在符合要求的层级内，不符合节点规则的配置内容会被自动过滤不会写入最终合并文件，目前支持自动归类写入 inputUserMappings.xml 的节点类型包含mapping、buttonGroup、pairedAxes、preset四类，支持写入 inputContexts.xml 的节点类型包含blend、context、hold、multitap、repeat、toggle、acceptedEvents七类，超出这个范围的节点类型暂不被支持。该加载器和常规的画质增强、任务拓展类模组没有冲突，仅会作用于输入相关的配置逻辑，同时兼容其他基于RED4ext开发的功能插件，不会和同框架下的其他工具产生运行冲突。如果玩家此前手动修改过游戏原生的输入配置文件，建议先备份原有自定义内容，再安装该加载器，避免合并过程中原有手动修改的内容被纳入缓存后出现预期外的变化。游戏大版本更新后，建议玩家先删除 r6/cache/ 目录下由该加载器生成的两个合并后XML文件，重新启动游戏让加载器基于新版本的官方输入配置重新合并所有模组规则，避免旧版本缓存配置和新版本游戏出现不兼容问题。

常见问题

  • 安装完成后部分自定义输入模组的键位没有生效，该怎么排查？首先打开 red4ext/logs/input_loader.log 日志文件，查看日志中是否标记了对应模组XML文件的格式错误提示，大部分情况是模组内的输入节点写法不符合要求导致加载器跳过了该文件的合并，调整节点属性后重新启动游戏即可正常识别。
  • 多个修改同一操作键位的输入模组同时安装后，最终生效的是哪一个配置？如果所有模组都给对应节点添加了 append="true" 属性，那么符合规则的所有键位都会被同时绑定，不存在覆盖问题；如果有模组没有添加该属性，后合并的配置会覆盖前面的同类默认配置，建议所有输入类模组都开启append属性。
  • 加载器生成的缓存配置文件可以手动修改吗？不建议直接修改缓存目录下的合并后XML文件，每次游戏启动时加载器都会重新根据所有源XML生成新的缓存，手动修改的内容会被覆盖，想要调整规则请直接修改 r6/input/ 目录下对应模组的源XML文件。