1. 先搞清楚UE4SS到底是个什么东西很多人第一次看到UE4SS这四个字母组合第一反应是又一个看不懂的缩写。它的全称是Unreal Engine 4/5 Scripting System直译过来就是虚幻引擎4/5脚本系统。说白了它是一个针对虚幻引擎游戏的脚本注入与运行时修改框架。你玩的一些单机游戏比如那些用虚幻引擎做的作品如果想在游戏里加一些自定义功能——改数值、加菜单、调参数、装MOD——UE4SS就是干这个的。它和传统MOD的区别在哪传统MOD通常是替换游戏文件比如换贴图、换模型改的是静态资源。而UE4SS走的是运行时注入路线它在游戏启动后把自己的脚本系统挂载进去让你能用Lua脚本实时操作游戏内部的对象、函数和变量。这就好比一个是把家具搬进房子另一个是直接给房子装了一套智能控制系统随时可以调灯光、调温度。那为什么最近问ue4ss怎么安装的人突然多了起来因为越来越多的游戏MOD作者开始用UE4SS作为底层框架来发布自己的作品。你想用这些MOD就必须先装好UE4SS。它本身不是一个能直接玩的东西而是一个底座。底座装好了上面才能跑各种脚本MOD。这篇文章面向的是完全没有接触过UE4SS的玩家或者之前装过但没装明白的人。我会从下载、解压、放置、验证、排错一路讲下来把每个步骤背后的原因也一并说清楚。10分钟上手不是夸张但前提是你得知道每一步在干什么而不是机械地复制粘贴。注意UE4SS只适用于单机游戏的本地修改场景。请确保你的使用行为符合游戏本身的用户协议和相关规定。2. 安装前的环境确认与版本选择2.1 确认你的游戏是否支持UE4SS不是所有虚幻引擎游戏都能用UE4SS。它主要支持UE4.20以上以及UE5早期的版本。太老的UE4版本比如4.10、4.15可能缺少必要的API接口太新的UE5版本比如5.3之后也可能因为引擎内部改动导致兼容性问题。怎么判断最直接的办法是去看你玩的游戏的MOD社区。如果已经有其他人在用UE4SS做MOD那基本就没问题。另一个办法是看游戏根目录下有没有Engine文件夹和Binaries文件夹这是虚幻引擎游戏的典型结构。具体来说你需要找到游戏的可执行文件.exe它通常位于类似这样的路径你的游戏目录\游戏名\Binaries\Win64\游戏名-Win64-Shipping.exe注意那个-Win64-Shipping后缀这是虚幻引擎打包后的正式发行版本。UE4SS需要注入的就是这个进程。2.2 选对UE4SS的版本UE4SS在GitHub上持续更新版本迭代比较快。截至我写这篇内容的时候比较稳定的版本是v3.x系列。但这里有个关键点不是越新越好。很多MOD作者会指定他们测试过的UE4SS版本。比如某个MOD的说明里写着需要UE4SS v3.0.1那你就老老实实用v3.0.1别自己升到最新版。因为UE4SS不同版本之间的API可能有细微变化MOD作者没适配新版本的话你装了也跑不起来。下载渠道方面官方发布页在GitHub的Releases区域。下载的时候注意选对包包名适用场景说明UE4SS_vX.X.X.zip标准版大多数情况用这个UE4SS_vX.X.X_Dev.zip开发版包含调试符号普通玩家不需要zCustomGameConfigs.zip自定义配置针对特定游戏的配置文件普通玩家下载标准版就够了。Dev版体积大很多而且对使用没有帮助。2.3 检查运行环境依赖UE4SS依赖Visual C运行库。如果你的系统是Windows 10或11通常已经自带了。但如果你之前没装过什么大型软件可能会缺。判断方法很简单装完UE4SS启动游戏如果弹窗提示缺少VCRUNTIME140.dll或者MSVCP140.dll那就是缺运行库。解决办法是去微软官网下载最新的Visual C Redistributablex64版本装完重启一次就行。这个步骤很多人会忽略然后卡在游戏打不开或者注入失败上绕一大圈才发现是运行库的问题。另外确保你的游戏目录有写入权限。如果游戏装在C盘的Program Files下Windows的权限控制可能会阻止UE4SS写入日志文件。建议把游戏装在非系统盘或者给游戏目录加上当前用户的完全控制权限。3. 手把手完成UE4SS的部署3.1 解压与文件结构解读下载完UE4SS的zip包之后解压到一个临时目录。你会看到这样的结构UE4SS_v3.x.x/ ├── dwmapi.dll ├── ue4ss/ │ ├── UE4SS.dll │ ├── UE4SS-settings.ini │ ├── Mods/ │ │ ├── mods.txt │ │ └── (各种内置MOD文件夹) │ └── ... └── ...这里有几个关键文件需要理解dwmapi.dll这是注入器的入口。它伪装成Windows的桌面窗口管理器API动态库游戏启动时会加载它然后它再把UE4SS.dll注入进去。这种技术叫DLL劫持是MOD框架常用的注入方式。UE4SS.dll核心脚本系统负责解析Lua脚本、管理MOD加载。UE4SS-settings.ini配置文件控制日志级别、控制台开关、MOD加载顺序等。Mods文件夹所有脚本MOD都放在这里每个MOD一个子文件夹。3.2 把文件放到正确的位置这一步是安装过程中最容易出错的环节。很多人直接把整个UE4SS文件夹复制到游戏目录这是不对的。正确的做法是把dwmapi.dll和ue4ss文件夹一起复制到游戏可执行文件所在的目录。也就是前面提到的那个包含-Win64-Shipping.exe的文件夹。举个例子如果你的游戏路径是D:\Games\MyGame\MyGame\Binaries\Win64\MyGame-Win64-Shipping.exe那么复制完成后应该是D:\Games\MyGame\MyGame\Binaries\Win64\ ├── MyGame-Win64-Shipping.exe ├── dwmapi.dll └── ue4ss\ ├── UE4SS.dll ├── UE4SS-settings.ini └── Mods\提示有些游戏的可执行文件不在Binaries\Win64下而是在游戏根目录。判断标准是找到那个体积最大的.exe文件通常就是游戏主程序。3.3 首次启动与验证文件放好之后直接通过Steam或者游戏启动器正常启动游戏。注意不要用管理员权限启动除非游戏本身要求。游戏启动后如果UE4SS正常工作你会看到以下现象之一游戏窗口旁边出现一个黑色的控制台窗口里面滚动着加载日志。游戏目录下生成了UE4SS.log文件里面有详细的加载记录。按键盘上的~键波浪号或者F10键能呼出UE4SS的内置控制台。如果以上都没有说明注入失败了。别急下一节我会详细讲排查方法。验证成功后你可以先试试UE4SS自带的一些内置MOD。在Mods文件夹里通常会有几个示例MOD比如BPModLoaderMod、ConsoleCommandsMod等。打开mods.txt文件你会看到类似这样的内容; Built-in mods BPModLoaderMod : 1 ConsoleCommandsMod : 1 ConsoleEnablerMod : 1后面的数字1表示启用0表示禁用。你可以根据需要开关这些内置MOD。4. 装完UE4SS但游戏里没有Mod Settings菜单怎么办这是搜索量最高的问题之一安装完ue4ss游戏主菜单并没有mod settings。我专门用一节来讲这个因为它的原因不止一种需要逐层排查。4.1 先确认UE4SS本身是否加载成功Mod Settings菜单是UE4SS的一个内置功能模块但它不是默认就显示的。首先你得确认UE4SS确实注入成功了。去看游戏目录下有没有生成UE4SS.log文件打开它搜索关键词Mods和Loaded。如果日志里显示[2024-XX-XX] Starting UE4SS [2024-XX-XX] Loading mods... [2024-XX-XX] Loaded mod: BPModLoaderMod这说明UE4SS在工作。如果日志文件根本没生成那就是注入失败跟Mod Settings菜单没关系得先解决注入问题。4.2 Mod Settings菜单的显示条件UE4SS的Mod Settings菜单默认是通过按键呼出的不是一个常驻在主菜单上的按钮。默认按键通常是Ctrl F10或者F10具体取决于版本和配置。打开UE4SS-settings.ini找到[UI]或者[General]段落看看有没有类似这样的配置[UI] GuiConsoleEnabled 1 GuiConsoleVisible 1 ModSettingsEnabled 1如果ModSettingsEnabled是0那菜单自然不会出现。改成1保存重启游戏。另外有些游戏的输入系统会拦截UE4SS的快捷键。比如游戏本身把F10绑定成了截图功能那UE4SS就收不到这个按键。这时候你需要改UE4SS的快捷键配置换一个游戏没占用的键。4.3 游戏版本与UE4SS版本的匹配问题还有一种情况UE4SS确实加载了日志也正常但Mod Settings菜单就是不出来。这通常是因为UE4SS的UI模块和游戏的渲染层冲突。某些游戏使用了自定义的UI框架UE4SS的ImGui菜单无法正常叠加显示。解决办法是尝试在配置文件里切换渲染后端[General] GraphicsAPI DX11 ; 或者 GraphicsAPI DX12 ; 或者 GraphicsAPI OpenGL不同游戏对渲染API的支持不一样需要逐个试。DX11的兼容性通常最好DX12性能更好但兼容性稍差。4.4 排查清单我把这个问题的排查步骤整理成一张表你可以按顺序检查检查项正常状态异常处理UE4SS.log是否存在存在且有加载记录检查dll是否放对位置ModSettingsEnabled配置值为1改为1并重启快捷键是否被占用按键能呼出控制台修改快捷键配置GraphicsAPI设置与游戏匹配逐个尝试DX11/DX12游戏是否全屏窗口化或无边框切换显示模式试试MOD是否依赖Mod Settings有些MOD自带菜单查看MOD说明文档提示如果你用的是某些整合包或者MOD管理器它们可能会覆盖UE4SS的配置文件。检查一下有没有其他程序在修改UE4SS-settings.ini。5. 脚本MOD的安装与加载顺序管理5.1 手动安装一个脚本MODUE4SS装好之后安装脚本MOD就很简单了。大多数脚本MOD的压缩包里会有一个文件夹里面包含Scripts文件夹和enabled.txt文件。你只需要把这个文件夹整个复制到ue4ss\Mods\目录下。比如你下载了一个叫MyAwesomeMod的MOD解压后得到MyAwesomeMod/ ├── Scripts/ │ └── main.lua └── enabled.txt把它放到游戏目录\...\Win64\ue4ss\Mods\MyAwesomeMod\然后在mods.txt里添加一行MyAwesomeMod : 1重启游戏MOD就会加载。5.2 加载顺序为什么重要UE4SS加载MOD是按照mods.txt里的顺序从上到下依次加载的。这个顺序会影响MOD之间的交互。如果MOD A修改了某个函数MOD B又依赖这个函数的原始版本那加载顺序不对就会出问题。一般来说基础框架类的MOD比如BPModLoaderMod应该排在最前面功能类MOD排在后面。如果你不确定顺序可以看MOD作者的说明通常会注明依赖关系。5.3 常见加载失败原因MOD装了但没生效常见原因有这几个mods.txt里没添加对应的条目或者拼写错误。MOD文件夹层级不对比如多套了一层文件夹。MOD依赖的UE4SS版本和你装的不一致。MOD之间有冲突后加载的覆盖了先加载的。排查方法还是看UE4SS.log里面会记录每个MOD的加载状态和报错信息。如果某个MOD加载失败日志里会有Failed to load mod或者Error executing script之类的提示。6. 那些教程不会告诉你的实操经验6.1 备份是底线在往游戏目录里放任何文件之前先备份原始的游戏目录。特别是dwmapi.dll这个文件有些游戏本身就有这个文件你直接覆盖可能会导致游戏无法启动。如果游戏目录下已经存在dwmapi.dll先把它重命名为dwmapi.dll.bak再把UE4SS的放进去。6.2 杀毒软件误报UE4SS的注入方式DLL劫持和某些恶意软件的行为特征相似所以Windows Defender或者第三方杀毒软件可能会把它隔离掉。如果你发现文件放进去之后莫名其妙消失了去杀毒软件的历史记录里看看是不是被拦了。把游戏目录加入白名单就行。6.3 游戏更新后的处理游戏更新后可执行文件可能会被替换UE4SS的注入可能会失效。这时候你需要重新检查dwmapi.dll是否还在以及UE4SS版本是否需要更新。有些游戏更新会改变内部函数签名导致旧版UE4SS不兼容需要等UE4SS发布适配版本。6.4 性能影响UE4SS本身对游戏性能的影响很小通常只有1-3帧的波动。但如果你装了大量脚本MOD特别是那些每帧都在执行复杂逻辑的MOD可能会有明显掉帧。这时候可以在UE4SS-settings.ini里调整脚本执行频率或者禁用一些不常用的MOD。6.5 日志是你的朋友遇到任何问题第一件事就是看UE4SS.log。这个文件记录了从注入到MOD加载的全过程90%的问题都能从日志里找到线索。日志级别可以在配置文件里调整调试的时候把级别设为Debug能看到更详细的信息。我在实际使用中踩过最坑的一次是游戏目录路径里包含中文字符导致UE4SS的DLL加载失败。后来把游戏移到纯英文路径下就解决了。所以如果你的游戏装在类似D:\游戏\某某游戏\这样的路径下建议改成纯英文路径。另外一个小技巧如果你同时玩多个支持UE4SS的游戏不需要每个游戏都复制一份UE4SS文件。可以建一个统一的UE4SS目录然后用符号链接mklink把dwmapi.dll和ue4ss文件夹链接到各个游戏目录。这样更新UE4SS的时候只需要更新一份所有游戏都生效。命令大概是这样的mklink D:\Games\GameA\Binaries\Win64\dwmapi.dll D:\UE4SS\dwmapi.dll mklink /D D:\Games\GameA\Binaries\Win64\ue4ss D:\UE4SS\ue4ss这个做法在管理多个游戏的时候特别省事但要注意符号链接需要管理员权限才能创建。