简易模组框架（使用模组前务必手动安装Simple Mod Framework）

《HITMAN 3》Simple Mod Framework 框架使用指南
【核心介绍】
Simple Mod Framework 是《HITMAN 3》官方认可的模组运行与开发基础框架，必须安装才能启用绝大多数功能型 MOD（如自定义合同、图像替换、音效调整等）。
【安装指南】
1. 下载最新版安装程序：从 「Simple Mod Framework」官网或官方 GitHub 发布页 获取 `Setup.exe`；
2. 运行安装程序，按提示选择 《HITMAN 3》游戏根目录（例：`C:/Steam/steamapps/common/HITMAN 3/`），确保路径中不含中文或特殊符号；
3. 安装完成后，启动游戏前需确认：
– 游戏已更新至 最新正式版本（v3.200 或更高）；
– 「Simple Mod Framework」必须优先于其他 MOD 加载（在 `/mods` 文件夹中命名以 `00_` 开头可确保加载顺序）；
– 若使用第三方工具（如 ResourceTool、RPKG 工具链），无需手动配置 CRC32 或哈希值，框架将自动处理。
【功能详情】
✅ 已优化：
– 自动识别并加载 `/mods` 目录下的所有兼容 MOD；
– 支持一键启用/禁用 MOD 功能（通过游戏内「MOD Settings」界面）；
– 兼容合同文件（`.contract`）、图像（`.png/.dds`）、音效（`.wav/.ogg`）等常见资源类型，无需手动重建 ORES 或 RPKG 包。
❌ 未修改：
– 游戏本体代码、核心引擎逻辑、DRM 验证机制；
– 未提供图形渲染层（如光照、粒子）的直接编辑能力。
✨ 额外调整：
– 内置自动更新检查，可一键升级框架本体；
– 提供标准化本地化支持，MOD 作者无需手动管理多语言 CRC 校验。
【使用要求】
– 必备：《HITMAN 3》本体（Steam/Epic 版），且已安装 「血与酒」扩展包（非必需但推荐）；
– 系统：Windows 10 或更高版本，64 位系统；
– 权限：安装及运行时需以管理员身份执行；
– 注意：不支持旧版 HITMAN 3（v3.100 及更早），请先通过平台更新游戏。
【兼容性说明】
– 兼容范围：所有遵循 SMF 规范的 MOD（文件结构含 `manifest.json`，版本声明 ≥ v3.0）；
– 不兼容模组：
– 未声明 SMF 依赖的早期手动补丁类 MOD（如直接替换 `.rpkg` 的旧方案）；
– 修改同一资源但未启用「Patch Stacking」功能的冲突 MOD；
– 兼容补丁：暂未推出针对非 SMF 模组的通用桥接补丁。
【注意事项】
– 若出现“Simple Mod Framework 安装不正确”提示，请检查：
– 游戏根目录路径是否含空格/中文/特殊字符；
– 是否关闭了杀毒软件对 `Setup.exe` 和 `/mods` 文件夹的拦截；
– 是否重复安装多个框架版本（请卸载旧版后再重装）；
– MOD 启用后首次启动游戏可能延迟 10–20 秒（框架初始化资源索引）；
– 框架本身不包含任何游戏内容，仅提供运行环境，所有功能依赖独立 MOD 文件。
【更新日志】
– 2024 年 4 月 12 日：v3.200 兼容性更新，修复部分合同加载失败问题；
– 2023 年 11 月 5 日：新增 MOD 设置缓存机制，降低启动耗时；
– 2023 年 8 月 17 日：正式支持 `.dds` 图像热替换，无需重启游戏。