模组简介

REFramework 是专为《生化危机：安魂曲》打造的框架级工具模组，主要面向想要为游戏拓展自定义内容、调整底层运行参数的玩家与模组创作者使用。这个模组不会直接修改游戏本体的剧情、关卡或原生资源文件，而是作为底层钩子工具挂载到游戏进程中，为后续各类自定义脚本、第三方插件提供统一的运行基础环境，解决原生游戏不支持外部模组注入、自定义扩展功能无法正常生效的核心问题，让玩家可以基于该框架解锁更多游戏自定义的可能性。

功能要点

  • 提供统一的全局配置菜单，按下键盘 Insert 键即可在游戏运行过程中随时唤出，无需退出到桌面就能调整各类框架参数
  • 支持两类自定义内容的挂载，将脚本文件放入 reframework/autorun 文件夹即可自动在游戏启动时运行，将编译后的插件 DLL 文件放入 reframework/plugins 文件夹即可被框架自动识别加载
  • 自带 fallback 存储机制，当框架无法正常访问游戏当前安装目录时，会自动将所有配置、脚本、插件的存储路径切换到系统环境变量 %APPDATA%/REFramework 目录下，保证功能不会因为权限不足、路径锁定等问题失效
  • 自带独立的日志生成与崩溃转储记录能力，运行过程中会自动生成相关日志文件，出现异常时可留存崩溃转储文件方便排查定位问题，也方便创作者调试自定义的脚本与插件内容

前置依赖

该模组无额外需要提前安装的第三方前置组件，仅需确保《生化危机：安魂曲》游戏本体已经正常安装且可以正常启动运行即可使用。原文未给出的前置相关补充项均以压缩包内附带的说明文档内容为准。

安装方法

你可以选择两种方式完成安装，第一种是通过 神尺管理器 直接完成自动化部署，无需手动调整任何文件路径即可快速完成配置。如果选择手动安装，需要将压缩包内的 dinput8.dll 文件解压放置到《生化危机：安魂曲》对应的游戏安装文件夹内。如果后续需要额外添加自定义脚本，可以将对应脚本文件放入生成的 reframework/autorun 文件夹，添加插件则放入 reframework/plugins 文件夹即可。

如果需要临时停用该框架，仅需从游戏目录中移除 dinput8.dll 文件即可，所有已经配置的脚本与插件内容都会保留不会被删除。如果需要彻底卸载该框架，除了移除上述 DLL 文件之外，还需要同步删除目录下生成的 reframework 文件夹、re2_fw_config.txt 配置文件、re2_framework_log.txt 日志文件，若目录下存在 reframework_crash.dmp 崩溃转储文件也需要一并删除，才能完全清除该框架的所有相关内容。

注意事项与兼容性

该框架属于底层钩子类工具，运行时会优先接管游戏的输入相关调用，部分同样基于 dinput8.dll 实现注入的同类工具可能会和该模组产生加载冲突，出现脚本插件无法识别、框架菜单唤出无响应的情况，建议尽量不要同时挂载多个同类型的底层注入工具。

部分《生化危机：安魂曲》的第三方专用模组会明确要求以该 REFramework 作为运行基础，这类模组无法在没有提前安装该框架的环境下正常启动生效。如果游戏本身的运行权限不足，导致框架无法在游戏目录内生成所需的配置与文件夹，框架会自动切换到系统用户目录下的 %APPDATA%/REFramework 路径存储所有相关内容，此时需要将自定义脚本与插件放入该系统路径对应的子文件夹内才能被识别，不要强行修改游戏目录的读写权限来避免出现不必要的系统安全问题。

常见问题

  • 按下 Insert 键没有反应唤不出框架菜单：首先确认游戏目录中已经正确放置了 dinput8.dll 文件，同时检查当前输入法是否处于中文输入状态，部分中文输入法下的 Insert 快捷键输入可能会被系统拦截，切换到英文输入法后重新按下按键即可正常唤出菜单。
  • 放入 reframework/autorun 文件夹的脚本没有自动运行：首先确认框架当前有没有切换到系统 %APPDATA% 路径存储文件，如果框架无法访问游戏目录，脚本需要放到系统路径对应的 autorun 子文件夹中才能被加载。
  • 卸载之后重新启动游戏仍能看到框架的相关提示：说明没有删除完全部相关文件，需要检查游戏根目录是否残留了 re2_fw_config.txt 这类配置文件，确认删除后重启游戏即可完全恢复原生运行状态。