# MOProject 专用 UE4SS + ContainerLoader（烽沙 Mod 基础前置）
**版本：v0.4（2026-08-24）**
## 简介
这是烽沙（MOProject）的 Mod 运行基础环境，也是本游戏几乎所有 Mod 的****必装前置****。
本包包含两部分：
**烽沙特化 UE4SS v0.4**：针对当前 MOProject 游戏版本适配的 UE4 Scripting System，注入方式为 `dwmapi.dll`，采用后台运行方式，正常情况下不会弹出额外的控制台窗口。
**ModCraftContainerLoader（内置）**：Pak / IoStore Mod 签名兼容与挂载加载器。无需再安装任何单独的签名补丁或加载器，未签名的作者 Pak 可以在游戏资产加载前完成原生挂载。
## 功能特性
- 完整 UE4SS 环境：内置 BPModLoaderMod、ConsoleEnablerMod、ConsoleCommandsMod、CheatManagerEnablerMod、Keybinds、LineTraceMod、SplitScreenMod 等官方标准 Mod，以及 UEHelpers 共享库。
- 游戏内控制台：默认可通过波浪号键（~）或 F10 打开。
- 内置 ContainerLoader 兼容层，支持两个 Mod 目录：
- `MOProject\Content\Paks\LogicMods`（UE4SS Blueprint Pak 必须保留在此目录，不要移动到 ~mods）
- `MOProject\Content\Paks\~mods`（仅用于 umod_build 返回的 IoStore 三件套）
- 兼容层在 FPakPlatformFile 初始化完成、游戏资源开始加载之前调用引擎原生 Mount，仅挂载上述两个目录内通过预检的未签名 Pak；首个游戏 Tick 只保留为异常情况下的兜底。
- 安全收紧：兼容层只对 LogicMods 中可解析的 V11 未加密 Pak 放行 unsigned reader；~mods 中的 Pak 还必须是 0 文件条目的 detection Pak，并存在同名 .utoc/.ucas。官方 Pak 与其他目录的 Pak 仍保持原签名校验，不会被绕过。
- 运行日志位于 `Win64\ue4ss\UE4SS.log`。日志出现 `Pak-initialization mount complete`，且 attempts 与 successes 一致，即表示签名、挂载及时序阶段均已通过。
## 安装方法
2. 打开游戏目录：
```text
Steam\steamapps\common\mo\MOProject\Binaries\Win64
```
3. 如果目录中已经存在 `dwmapi.dll`，请先将它备份；如果已经存在 `ue4ss` 文件夹，也请先备份或移走。
4. 将压缩包中的以下内容解压到 Win64 目录：
```text
dwmapi.dll
ue4ss\
```
5. 启动游戏即可，无需运行任何额外启动器。
## 使用说明
- 游戏内控制台：按波浪号键（~）或 F10 打开。
- 安装 IoStore 模型 Mod 时，必须保留完整的同名三件套文件组，例如：
```text
Example_P.pak
Example_P.utoc
Example_P.ucas
```
**不要只复制其中的 .pak。**
- 排查问题时查看日志：`Win64\ue4ss\UE4SS.log`。
## 卸载 / 恢复原版本
1. 完全退出游戏。
2. 删除 Win64 目录中的 `ue4ss` 文件夹。
3. 删除本次安装的 `dwmapi.dll`。
4. 将安装前备份的 `dwmapi.dll` 和原有 `ue4ss` 文件夹恢复。
**不要在游戏运行过程中替换或删除 DLL 文件。**
## 注意事项
- 本版本仅针对当前 MOP
