🔥 终极Mod引擎指南：如何用ModEngine2轻松玩转魂系游戏模组

ModEngine2是一款专为魂系游戏打造的运行时注入库，支持《艾尔登法环》《黑暗之魂3》等热门游戏的模组加载与管理。通过简洁的配置和强大的扩展功能，新手也能快速上手，打造个性化的游戏体验！

🎮 支持游戏清单

目前ModEngine2已官方支持以下魂系作品，更多游戏正在开发中：

• ✅ 黑暗之魂3
• ✅ 艾尔登法环
• ⏳ 黑暗之魂2：原罪学者（开发中）
• ⏳ 黑暗之魂：重制版（开发中）
• ⏳ 只狼：影逝二度（开发中）
• ⏳ 血源诅咒（开发中）

🚀 3分钟快速上手

1️⃣ 下载与安装

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/mo/ModEngine2
2. 从Releases下载最新版本
3. 解压至任意目录（推荐命名为ModEngine2以便管理）

2️⃣ 模组文件夹配置

在安装目录中创建mods文件夹，并为每个模组创建独立子目录（如mod\BetterAshes）。典型结构如下：

图：ModEngine2推荐的模组文件夹结构，清晰分类不同模组文件

3️⃣ 编辑配置文件

修改游戏对应配置文件（如config_eldenring.toml），添加模组路径：

mods = [  
  { enabled = true, name = "灰烬美化", path = "mod\\ashes" },  
  { enabled = true, name = "动作模组", path = "mod\\moveset" },  
]  

💡 核心功能亮点

📦 多模组并行加载

告别手动替换文件！通过mods配置项可同时启用多个非冲突模组，支持一键开关：

mods = [  
  { enabled = true, name = "高清材质", path = "mod\\hd_textures" },  
  { enabled = false, name = "敌人随机化", path = "mod\\randomizer" },  # 暂时禁用  
]  

🚀 独立启动器免注入

传统dinput8.dll注入方式已非必需！通过launcher/目录下的启动器程序，可直接预配置启动游戏，避免与其他工具冲突。

🔧 开发者友好工具集

• 调试支持：集成ScyllaHide反调试工具（installer/assets/scyllahide/）
• 性能分析：Optick Profiler实时监控（src/modengine/ext/profiling/）
• 热重载：Lua脚本动态修改游戏逻辑（开发中）

⚙️ 高级配置技巧

调试菜单激活

部分模组需启用调试功能，配置文件中添加：

[debug]  
enabled = true  
menu_key = "F3"  # 自定义呼出按键  

存档与模组隔离

通过save_path参数指定独立存档目录，避免原版与模组存档冲突：

[game]  
save_path = "mod_saves\\eldenring"  

📚 官方资源

• 架构文档：ARCHITECTURE.md
• 配置模板：installer/assets/config.toml
• 扩展开发：src/modengine/ext/

❓ 常见问题

Q：模组冲突怎么办？
A：通过enabled字段临时禁用冲突模组，或调整加载顺序（配置文件中靠后的模组优先级更高）。

Q：支持Steam版游戏吗？
A：完全支持！启动器会自动检测Steam安装路径（launcher/steam_app_path.cpp）。

---

✨ 立即开始你的魂系模组之旅，用ModEngine2解锁无限游戏可能！如有疑问，欢迎参与项目讨论或提交Issue。