Unreal Engine 插件

安装

uVersion 插件以预编译的二进制形式分发，由 desktop 客户端管理。 您无需自行编译，也无需处理任何源文件。

支持的 Unreal 版本：5.6 及以上。

步骤

1. 安装 uVersion desktop 客户端
2. 将包含 Unreal 项目的工作区添加到客户端
3. Unreal 面板会自动检测您的 .uproject
4. 客户端会安装与您的 Unreal 版本和平台相匹配的插件
5. 在 Unreal 中打开项目，插件立即生效

更新

desktop 客户端会在您打开项目时以及每 6 小时检查一次新版本。 当有适用于您的 Unreal 的更新版本时，客户端的 Unreal 面板中会出现 « Update ready » 标记。请先关闭 Unreal 编辑器， 然后点击它以应用更新（插件在加载状态下无法被替换）。

首次连接

在 Unreal 编辑器中：Tools → Source Control → Connect to Source Control， 在 Provider 下拉菜单中选择 uVersion。

您的凭据会自动从 desktop 客户端获取，无需重新输入任何内容。 如果由于某种原因未安装 desktop 客户端，编辑器会显示一个表单， 供您输入服务器地址和凭据。

插件在 Unreal 中的功能

原生 Source Control

checkout、checkin、revert、history：全部可从 Content Browser 的右键菜单中访问， 与任何其他 Unreal Source Control Provider 完全一样。 美术人员无需学习任何新东西。

编辑时自动加锁

当您修改资产时，插件会自动在服务器端加锁，无需您手动 checkout。 您只管工作，插件会在后台默默处理加锁。

可视化 Blueprint 差异比较

使用编辑器标准的可视化差异工具，直接在 Unreal 中比较 Blueprint 的两个修订版本。 对历史记录中的任何提交都有效。

checkin 前校验

每次提交前，插件都会对已修改的文件运行一系列检查： Blueprint 编译、命名规范、纹理大小、缺失依赖、 循环依赖等。错误会阻止 checkin，警告则以提示形式显示。 规则可在 desktop 客户端的 Admin 面板中按项目启用和配置。

redirector 清理

当您重命名或移动资产时，Unreal 会创建可能不断累积的 redirector。 插件会在 checkin 时自动检测并清理它们，同时更新 所有受影响资产中的引用。

启动时的对账

项目打开时，插件会检查您的资产状态并将状态与服务器同步。 您正在编辑的文件会自动重新加锁，以防队友 误将您已经开始的工作占为己有。

请求释放锁

如果您想修改被队友锁定的资产，插件允许您 发送一个释放请求。通知会送达队友的 desktop 客户端。

常见问题

« Failed to connect to source control »

请确认您已正确登录 desktop 客户端。持有您凭据的正是它。

插件无法更新

请先关闭 Unreal 编辑器：插件在加载状态下无法被替换。 然后点击 desktop 客户端 Unreal 面板中的插件状态标记， 重新运行检查并应用更新。