RE引擎终极模组管理器 RE2R

制作：Raz0r
Patreon： https://www.patreon.com/_Raz0r

在提出任何问题之前，请先观看这些YouTube视频：
如何安装并运行模组管理器：
从Nexus或这里的夜间构建版本下载并安装最新版REFramework： https://github.com/praydog/REFramework-nightly/releases。非RT版本游戏下载 RE2_TDB66.zip，RT版本下载 RE2.zip。将UltimateModManagerByRaz0r.zip和RE2.zip的内容解压到游戏目录。确保"RESIDENT EVIL 2 BIOHAZARD RE2"目录下存在'reframework'和'ultimate_mod_manager'文件夹。标准安装路径为"C:\SteamLibrary\steamapps\common\RESIDENT EVIL 2 BIOHAZARD RE2" <- 相关文件夹应位于此路径。进入游戏后，模组管理器会在几秒后初始化（您将看到通知）。按Insert键可打开/关闭叠加界面。通过检查 ScriptRunner 和 PluginLoader 确认加载无误 - 应显示"Loaded plugins: ultimate_mod_manager"且无报错。模组管理器设置可在叠加界面的Script Generated UI => RE Engine Ultimate Mod Manager by Raz0r中找到。点击 "Use Separate Window"可使模组管理器在独立窗口中运行。

功能列表：

• 模组可在游戏内安装/卸载 - 大多数情况下无需重启游戏，运行时即可预览并安装模组；
• 文件路径转储器（设置选项卡。生成游戏访问的文件列表，写入game_dir/ultimate_mod_manager/loaded_file_list.list，可与Fluffy的RETool配合提取.pak文件）；
• 支持Steam Deck；
• 兼容Fluffy模组管理器格式（分组及部分分类功能）；
• 支持.rar/.zip/.7z压缩格式模组；
• 支持未压缩模组；
• 不修改游戏原始文件（那些大型.pak文件）；
• 允许选择最多4个自定义模组目录；
• 内置游戏内图片预览功能；
• 内置图片预览同时支持DirectX11和DirectX12；
• 简易安装/卸载；
• 内置搜索功能；
• 全局开关可临时禁用所有模组；
• 将模组放入同一目录即可实现分组管理；
• 模组可实时安装/卸载 - 根据游戏不同，可能需要更换服装或重新加载存档。部分模组无法多次重配置；
• 当前官方支持游戏包括：RE2R（光追与非光追版）/RE3R（光追与非光追版）/RE8/DMCV/RE4R/MHRise/SF6；

模组安装：

在模组管理器窗口中，展开"设置"选项。您可以在此设置模组路径——既可以点击"编辑"按钮（这将打开Windows资源管理器窗口供您查找并选择目录），也可以直接复制粘贴或手动输入路径。完成后点击"重新读取目录"按钮，系统将扫描目录中的模组。在机械硬盘上此过程可能需要较长时间（1000个模组约需5-8分钟）。当您向目录添加新模组后，同样需要点击"重新读取目录"按钮。

请务必遵循模组的安装说明——如果要求先安装基础/主文件，即使使用本管理器也必须遵守！管理器会保持您安装模组的顺序，因此若安装顺序错误（比如先安装发型颜色选项再装主文件），可能导致游戏崩溃/卡死或功能异常！

各游戏特别提示：

• 《生化危机2重制版》需切换不同服装才能使模组生效，仅读取存档无效；
• 《生化危机4重制版》只需重新读取存档即可加载新模组；
• 《鬼泣5》需退出当前任务后继续任务，或返回主菜单重新载入任务才能卸载/加载模组，检查点重启无效；
• 《生化危机8：村庄》需重新读取存档；
• 《生化危机3重制版》需重新读取存档。安装模组后更换服装会导致模组失效，建议在主菜单安装模组，或仅针对当前服装安装。最稳妥的方式是安装模组后重启游戏，该游戏对实时安装/卸载模组的兼容性最差（具体效果因模组而异）。

强烈建议将模组存放在驱动器根目录或尽可能接近的位置（例如E:\RE4R_Mods或E:\Mods\RE4R_Mods），这样基本可避免超出260个字符的路径长度限制。

UI选项说明：

• 显示预览 - 打开新窗口展示模组预览图；
• 重新读取目录 - 刷新模组列表；
• 模组分类 - 类似Fluffy模组管理器的分类方式（通过modinfo.ini中的category标签）；
• 模组分组 - 类似Fluffy模组管理器的分组功能（通过modinfo.ini中的addonfor 和 nameasbundle 标签）；
• 仅显示已安装 - 模组列表仅显示当前已安装的模组；
• 使用独立窗口 - 为模组管理器创建独立窗口；
• 禁用所有模组（临时） - 不卸载模组但暂时禁用，便于测试；
• 卸载所有模组（无需确认） - 直接卸载当前所有已安装模组。

限制：

该模组管理器仅支持使用/安装文件类模组——不支持代码注入器/脚本/插件——仅能修改游戏文件。支持".pak"格式模组——会视为普通压缩包进行解压处理。
请确保模组存放盘符有额外1-2GB空间（管理器会解压screenshot.jpg和modinfo.ini文件进行缓存）。
模组路径长度不应超过260字符（单个文件超限也会触发警告，该文件将被跳过不加载）。若遇此情况，请尝试缩短模组名称或将模组存放在驱动器根目录（例如E:\RE4R_Mods或E:\Mods\RE4R_Mods）。
模组路径不得包含任何非Unicode字符（仅支持拉丁字母）。
模组名称本身不得包含任何非Unicode字符（仅支持拉丁字母）。
部分模组需要重启游戏生效——例如主菜单壁纸或加载画面模组。
部分模组配置仅能修改一次——即安装模组本体及选项后，游戏加载后无法再更改选项（并非所有模组都设计完善）。
部分模组可能导致异常——例如动画故障。以《生化4重制版》为例，给里昂安装艾达的动作模组会永久覆盖里昂原有动作（卸载模组也无法恢复），必须重启游戏。透明度选项通常也无法直接卸载（需重启）。
《生化危机7》非官方支持，但RT版可能部分兼容（未经测试，无支持计划）。
强烈建议在主菜单界面安装/卸载模组（《生化2重制版》仍需通过反复切换服装触发重载）。
压缩包模组（7z/rar/zip）需先经管理器安装。已解压模组（文件夹形式）具有优先级且无需安装。
相比压缩包模组，扫描解压模组几乎瞬时完成。为减小解压模组体积，可启用Windows文件夹压缩功能（约缩减30-40%空间）。

已知问题/疑问：

体积过大的压缩模组（1GB或以上）可能需要几秒钟才会开始显示进度。尤其是在机械硬盘上运行时；
若模组管理器窗口在扫描模组时关闭（当机械硬盘中存在1000个以上模组时可能发生），请在 REFramework 窗口中找到 Script Runner 并点击 Reset scripts 按钮。
模组预览图未显示 - 可能是图片缺失、modinfo.ini配置错误、图片名称不符或根本不存在。
扫描耗时过长 - 若模组存储在机械硬盘而非固态硬盘上属正常现象。首次扫描完成后，后续扫描将采用增量模式。
卸载模组或安装不同选项未生效 - 请参阅"限制事项"章节。
7z.dll 未找到错误 - 请确保游戏目录中存在"ultimate_mod_manager"文件夹且内含"libs\7z.dll"文件。
模组管理器窗口提示"不支持的游戏！" - 当前版本暂不支持您的游戏。
模组文件夹中的c$文件夹是什么？这是管理器存放压缩模组缓存及安装文件的目录。
《生化危机3重制版》模组失效或异常 - 该游戏对实时安装的兼容性最差。建议在主菜单安装模组或重启游戏。同时请确认未将非光追版模组安装在光追版游戏上（反之亦然）。
《生化危机2重制版》模组失效或异常 - 请确认未将非光追版模组安装在光追版游戏上（反之亦然）。
因新安装模组导致游戏无法启动，如何在不运行游戏的情况下卸载？前往游戏目录/ultimate_mod_manager文件夹 创建名为"disable"的文件（不含引号）。下次启动游戏时将暂时禁用所有模组。 卸载导致问题的模组后删除"disable"文件，取消勾选"禁用所有模组（临时）"或再次重启游戏。