UE4SS完整安装与使用指南
项目地址: https://gitcode.com/gh_mirrors/re/RE-UE4SS 本文档提供UE4SS（Unreal Engine 4 Scripting System）的完整安装和使用指南，涵盖从环境准备到高级配置的全流程。
环境要求与前置检查
在开始安装UE4SS之前，请确保您的系统环境满足以下要求：
系统环境要求：
- 操作系统：Windows 10/11 64位版本
- 运行库：Visual C++ Redistributable最新版本
- 游戏引擎：Unreal Engine 4.25及以上版本
游戏目录识别： 正确的游戏可执行目录应包含主程序文件，通常为100MB以上的可执行文件。避免将UE4SS文件放置在游戏启动器目录中，这些目录通常只包含Steam包装器等小型文件。
识别方法：右键点击游戏快捷方式，选择"打开文件所在位置"，通过文件大小判断主程序所在目录。
版本选择与核心组件部署
UE4SS提供多个版本以满足不同用户的需求：
| 版本类型 | 适用场景 | 功能特点 |
|---|---|---|
| 基础版 | 普通玩家使用Mod | 安装简单，无额外窗口 |
| 开发者版 | Mod开发者调试 | 包含控制台和调试工具 |
| 实验版 | 体验最新功能 | 可能包含未稳定功能 |
标准安装流程：
- 下载对应版本的UE4SS压缩包
- 解压所有文件到游戏主程序目录
- 确保所有文件与游戏可执行文件位于同一层级
文件结构验证： 安装完成后，游戏目录应包含以下核心文件：
- UE4SS.dll：主程序模块
- dwmapi.dll：注入接口文件
- 配置文件目录：包含Mods、Settings等子目录
从源码构建UE4SS
如果您需要自定义功能或进行开发，可以从源码构建UE4SS：
构建要求：
- 运行Windows的计算机
- 支持C++23的MSVC版本：
- MSVC工具集版本 >= 14.39.0
- MSVC版本 >= 19.39.0
- Visual Studio版本 >= 17.9
- Rust工具链 >= 1.73.0
- CMake >= 3.22
- 构建系统：Ninja或MSVC
构建步骤：
- 克隆仓库：
git clone https://gitcode.com/gh_mirrors/re/RE-UE4SS - 更新子模块：
git submodule update --init --recursive - 使用CMake配置和构建项目
核心功能特性
UE4SS提供以下主要功能：
Lua脚本API： 基于UE对象系统编写Lua模组，支持游戏功能扩展和个性化体验。
蓝图模组加载器： 无需编辑或替换游戏文件即可自动生成蓝图模组。
C++模组API： 基于UE对象系统编写C++模组，为开发者提供强大的调试能力。
实时属性查看器和编辑器： 搜索、查看、编辑和监视每个加载对象的属性，非常适合调试模组或了解运行时值的更改方式。
UHT转储器： 为游戏生成Unreal Header Tool兼容的C++头文件，用于创建镜像.uproject。
功能验证与测试
安装完成后，需要通过系统化测试验证UE4SS是否正常工作。
基础功能测试：
- 启动游戏进程
- 使用快捷键（@或F10）激活控制台
- 检查UE4SS.log文件的时间戳和内容
验证指标：
- 控制台界面正常显示和响应
- 日志文件无错误信息记录
- 游戏运行稳定性不受影响
高级配置选项
对于需要定制化安装的用户，UE4SS支持多种高级配置方案。
多游戏集中管理： 通过创建统一的UE4SS根目录，用户可以为多个游戏提供共享的UE4SS服务。每个游戏目录只需保留dwmapi.dll文件，通过配置文件指向集中的UE4SS.dll模块。
自定义路径配置： 在游戏目录创建override.txt文件，指定UE4SS组件的自定义存储位置。支持绝对路径和相对路径两种格式。
命令行选项与环境变量
命令行选项：
--disable-ue4ss- 临时禁用UE4SS而无需卸载--ue4ss-path <path>- 指定UE4SS.dll的自定义路径
环境变量：
UE4SS_MODS_PATHS- 分号分隔的额外模组目录列表
常见故障排除
当安装后遇到问题时，可按照以下步骤进行系统化排查。
启动失败处理：
- 验证文件位置：确保所有UE4SS文件位于游戏主程序同一目录
- 版本兼容性检查：确认UE4SS版本与游戏引擎版本匹配
- 安全软件设置：将UE4SS目录添加到防病毒软件白名单
紧急修复措施：
- 删除dwmapi.dll文件后重新解压
- 重启系统后再次尝试安装
- 查阅官方文档获取特定游戏配置
维护与更新建议
为确保UE4SS长期稳定运行，建议遵循以下维护原则。
定期检查：
- 监控UE4SS官方更新动态
- 定期备份重要配置文件
- 参与社区交流获取技术支持
通过以上系统化的安装和维护流程，用户可以确保UE4SS在各种Unreal Engine游戏环境中稳定运行，充分发挥其脚本注入和开发工具的功能优势。
转载自CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/gitblog_00964/article/details/155687401
