机甲战士5：雇佣兵 的 UE4SS

[size=6][b]适用于《机甲战士5：雇佣兵》的 UE4SS[/b][/size]

UE4SS 让 Lua 脚本和原生 DLL 模组能够在《机甲战士5：雇佣兵》中运行。本下载包含 MW5 所需的运行时文件和设置。

安装一次，然后添加你想使用的脚本模组。每个模组的页面都会说明它是否需要 UE4SS 以及其文件应放置的位置。本包提供共享运行时；你安装的模组提供各自的功能。

它包含脚本模组常用的 UE4SS 工具，例如控制台、控制台命令、蓝图模组加载和按键绑定支持。每一项都可以在 [b]Mods\mods.txt[/b] 中开启或关闭。

[size=4][b]Vortex 安装[/b][/size]

Vortex 用户需要单独的 [url=https://www.nexusmods.com/site/mods/2310]UE4SS for MW5 - Vortex Extension[/url]。通过 Vortex 的 [b]Extensions[/b] 页面使用 [b]Drop File(s)[/b] 安装该配套组件一次，然后重启 Vortex。

重启 Vortex 后，关闭 MW5，并使用 [b]Mods -> Install From File[/b] 选择此 Hub 存档。启用该 Hub 并从 Vortex 部署它。配套组件和此 Hub 下载是独立的包。配套组件的目录和 Nexus Mod Manager 下载途径不属于本安装说明的内容。

[size=4][b]手动安装[/b][/size]

找到包含 [b]MechWarrior-Win64-Shipping.exe[/b] 的文件夹。它通常以以下内容结尾：

[b]MW5Mercs\Binaries\Win64\[/b]

关闭 MW5，并将此下载直接解压到该文件夹中。不要将其放入 [b]Win64[/b] 内的新文件夹中。解压后，[b]UE4SS.dll[/b]、[b]dwmapi.dll[/b] 和 [b]UE4SS-settings.ini[/b] 应位于游戏可执行文件旁边。[b]UE4SS_Signatures[/b] 文件夹也应位于该处，并且其中包含 [b]FText_Constructor.lua[/b]。[b]Mods\mods.txt[/b] 应位于该处的 [b]Mods[/b] 文件夹内。如果这些文件已存在，请先使用下方的升级说明。

双击该文件夹中的 [b]Check-UE4SS.cmd[/b] 以检查安装。它会读取文件并报告缺失文件、冲突的加载器、设置问题以及已知的版本不匹配。它不会更改文件或启动游戏。

启动 MW5。控制台启动时是隐藏的。检查 [b]UE4SS.dll[/b] 旁新生成的 [b]UE4SS.log[/b]，查看版本行和成功的模式扫描。成功的安装检查确认文件和配置；新日志确认启动时发生的情况。

[size=4][b]如果 UE4SS 已经安装[/b][/size]

请先关闭 MW5。在解压此下载之前，备份两个加载器 DLL、[b]UE4SS-settings.ini[/b]、[b]Mods\mods.txt[/b] 以及现有的 [b]FText_Constructor.lua[/b] 签名。随附的 [b]mods.txt[/b] 包含标准 UE4SS 条目。解压后恢复你的设置和模组列表副本，以保留你的偏好、其他脚本模组及其顺序。然后检查下方的兼容性值。

同时替换 [b]UE4SS.dll[/b] 和 [b]dwmapi.dll[/b]，或者保留你现有的两个文件。如果你保留设置文件，请确保它包含以下 MW5 值：

[code]
[EngineVersionOverride]
MajorVersion = 4
MinorVersion = 26
[General]
bUseUObjectArrayCache = false
[Debug]
GraphicsAPI = dx11[/code]
如需小幅修复，只将 [b]UE4SS_Signatures\FText_Constructor.lua[/b] 复制到根目录的 [b]UE4SS_Signatures[/b] 文件夹，并将上述值添加到现有设置中。不要为此次修复覆盖 [b]Mods\mods.txt[/b]。

[size=4][b]显示或隐藏 GUI 控制台[/b][/size]

当 MW5 处于焦点状态时，按 [b]Ctrl+O[/b] 显示或隐藏图形化 UE4SS 控制台。这仅在当前会话中更改它。窗口隐藏时日志仍会被保存。

要在每次启动时显示它，请关闭 MW5，并在 [b]UE4SS-settings.ini[/b] 的 [b][Debug][/b] 下设置 [b]GuiConsoleVisible = 1[/b]。使用 [b]0[/b] 可再次以隐藏状态启动。保持 [b]GuiConsoleEnabled = 1[/b] 以使快捷键有效。单独的文本终端默认处于禁用状态。如果你需要它，请关闭 MW5，并在下次启动前设置 [b]ConsoleEnabled = 1[/b]。要再次隐藏它，请关闭 MW5 并设置 [b]ConsoleEnabled = 0[/b]；Ctrl+O 仅控制图形窗口。

另外，[b]F10[/b] 打开 MW5 的游戏内控制台，[b]Escape[/b] 关闭它。

[size=4][b]如果出现问题[/b][/size]

如果没有新的 [b]UE4SS.log[/b]，请检查两个加载器 DLL 是否位于游戏可执行文件旁边，以及你的安全软件是否隔离了任一文件。日志缺失本身并不能确定原因。出现 [b]PS scan timed out[/b] 消息时，需要检查签名文件以及游戏/UE4SS 版本；游戏更新也可能改变兼容性。

要临时禁用 UE4SS，请关闭 MW5，并将 [b]dwmapi.dll[/b] 重命名为 [b]dwmapi.dll.off[/b]。恢复其名称即可再次启用。这也会禁用所有依赖它的脚本模组，因此崩溃消失只是将问题范围缩小到该组。在没有某个玩法模组的情况下打开重要生涯之前，请遵循该模组的移除指南。

寻求帮助时，请双击 [b]Check-UE4SS.cmd[/b] 并复制其输出。它包含检测到的构建信息和声明的模组顺序，以及可用时日志中的版本横幅。添加你的游戏商店和 MW5 版本、受影响的模组和界面、你做了什么以及发生了什么。日志横幅可能属于更早一次启动，因此请检查其日期。仅在问题需要时分享完整日志或个人文件夹路径。

[size=4][b]移除它[/b][/size]

关闭 MW5，然后同时移除两个加载器 DLL：[b]UE4SS.dll[/b] 和 [b]dwmapi.dll[/b]。如果你可能会重新安装，请保留设置和模组列表的备份。当没有剩余安装需要它们时，你也可以移除此包的设置、README、许可证和 [b]UE4SS_Signatures\FText_Constructor.lua[/b]。除非你知道共享文件夹中的其他文件属于哪个模组，否则请保留它们。仅在你也要移除那些模组时才移除脚本模组文件夹。

[size=4][b]致模组作者[/b][/size]

将此包列为必需项，并告知玩家你的脚本文件应放置的位置。尽可能将你的模组设置和文件保留在其自己的文件夹中。不要用你自己的副本替换玩家共享的 [b]Mods\mods.txt[/b]；请说明你的模组所需的条目以及任何加载顺序要求。对于托管安装，请为单独的 Vortex 配套组件打包你的附加组件，并声明其运行时需求、激活、依赖项和持久数据。

此包使用上游构建 [b]v3.0.1-1005-g0290beda[/b]。与另一个 UE4SS 构建的兼容性需要单独测试。可用的签名和成功启动并不能证明每个反射函数或原生参数都能从 Lua 安全调用。

原生 DLL 模组可能需要特定的 UE4SS 构建。请遵循模组作者的要求；共享的 [b]3.0.1[/b] 版本标签并不保证原生接口匹配。在替换现有运行时之前，请检查确切的构建。

UE4SS 由 [url=https://github.com/UE4SS-RE/RE-UE4SS]UE4SS-RE 团队[/url]制作，并根据 MIT 许可证分发。许可证声明随此下载一起包含。包维护和 MW5 配置由 Crimson Vixen 完成。