虚幻引擎 4.14 版本信息

全新内容

虚幻引擎 4.14 版本包含一个针对 VR 进行优化的全新 前向着色渲染器，在游戏中启用清晰的 多重采样抗锯齿。全新的 接触阴影（Contact Shadows） 功能可渲染出复杂物体的美丽阴影细节。此版本中还加入了一个全新静态网格体 自动 LOD 生成（automatic LOD generation） 功能。此功能不需要第三方库。

我们 简化了动画工具，以便提高生产效率，为 Sequencer（UE4 的非线性动画工具）添加了诸多新功能，并对载具、布料和动画进行了改良。

移动开发者的好消息：现在可以在兼容的安卓设备上使用 Vulkan！此外我们还添加了多项全新 移动渲染功能，如从场景色彩和深度进行读取，以及在 UI 上绘制 3D 物体。

Windows 平台上的 C++ 程序员现可使用 Visual Studio "15” 进行开发。仍然支持 Visual Studio 2015。

此版本包含 Epic 的数百项更新，以及 GitHub 虚幻引擎开发者社区提交的 71 项改良！特此对虚幻引擎 4.14 版本的每位贡献者表达诚挚谢意：

Adam Moss（adamnv）、Alan Edwardes（alanedwardes）、Andreas Axelsson （judgeaxl）、Andreas Schultes（andreasschultes）、Andrew Armbruster（aarmbruster）、Artem V. Navrotskiy（bozaro）、Audiokinetic Inc.（audiokinetic）、BaxterJF、CA-ADuran、Cameron Angus （kamrann）、Cengiz Terzibas （yaakuro）、Christian Hutsch （UnrealEverything）、CodeSpartan、Cuo Xia （shrimpy56）、Damir Halilovic（DamirHalilovic）、dcyoung、Deniz Piri（DenizPiri）、Dennis Wissel（dsine-de）、Dominic Guana（jobs-git）、Dorgon Chang（dorgonman）、dsine-de、Filip Brcic（brcha）、Hakki Ozturk（ozturkhakki）、Hannah Gamiel（hgamiel）、Hao Wang（haowang1013）、Jarl Gullberg（Nihlus）、Jason（Abatron）、Jeff Rous（JeffRous）、Jeremy Yeung（jeremyyeung）、Jørgen P. Tjernø（jorgenpt）、Josh Kay（joshkay）、jpl-mac、KashiKyrios、Kory Postma（korypostma）、Kyle Langley（Vawx）、Laurie（Laurie-Hedge）、Lei Lei（adcentury）、Leszek Godlewski（inequation）、Marat Radchenko（slonopotamus）、Matthew Davey（reapazor）、Matthias Huerbe（MatzeOGH）、Matthijs Lavrijsen（Mattiwatti）、mbGIT、Michael Geary（geary）、Michail Nikolaev（michail-nikolaev）、Moritz Wundke（moritz-wundke）、Narendra Umate（ardneran）、Nelson Rodrigues（NelsonBilber）、null7238、Paul Evans（paulevans）、PjotrSvetachov、projectgheist、Rama（EverNewJoy）、rcywongaa、rekko、Ryan C. Gordon（rcgordon）、sangpan、Sébastien Rombauts（SRombauts）、Shihai（geediiiiky）、stfx、straymist、Theodoros Ntakouris（Zarkopafilis）、tmiv、ungalyant、Webster Sheets（Web-eWorks）、x414e54、yehaike、YossiMHWF、Yukariin、Zachary Burke（error454）、Zhiguang Wang（zhiguangwang）

主要功能

新鲜出炉：带 MSAA 的前向着色渲染器

全新的前向着色渲染器结合了高精度 UE4 灯光功能和多重采样抗锯齿（MSAA）支持！前向渲染器拥有 MSAA 和启用每个材质优化的选项，非常适用于 VR。

前向渲染器的工作原理是将灯光和反射捕捉剔除到一个视锥空间网格。前向通道中的每个像素在对其产生影响的灯光和反射捕捉上迭代，对它们带有的材质进行着色。静态光照的动态阴影为提前计算，并被打包到屏幕空间阴影遮罩的通道中，以便高效利用多个阴影投射功能。

启用 Rendering Project 设置中的“Forward Shading”并重启编辑器即可使用前向渲染器。

支持的 前向渲染功能 包括：

• 完整支持静态光照。包括来自可移动物体的动态阴影，此阴影将和预计算环境阴影混合

• 混合的多个反射捕捉（带视差矫正）

• 部分场景的平面反射，将合成到反射捕捉中

• D-Buffer 贴图

• 预计算光照和天光

• 无阴影的可移动光照

• 胶囊体阴影

• 兼容实例化立体

前向着色 暂不支持 以下功能：

• 屏幕空间技术（SSR、SSAO、接触阴影）

• 投射阴影的可移动光照

• 动态阴影半透明度

• 从静态光照获取环境阴影的半透明度

• 光照函数和 IES 配置文件

• 透明覆盖

• D-Buffer 贴图上的 MSAA、动态模糊、动态阴影和胶囊体阴影

前向渲染器支持多重采样抗锯齿（MSAA）和随机采样抗锯齿（TAA）。在多数情况下 TAA 更为可取，因为它能移除几何体锯齿和反射锯齿。在 VR 项目中，头部追踪引起的恒定亚像素运动会造成不必要的模糊。MSAA 方为更佳选择。

选择使用 MSAA 的项目将需要编译内容，以减轻反射锯齿。“Normal to Roughness”功能有助于弱化细节法线贴图上的反射锯齿。静态网格体的自动 LOD 生成可抹平远处模型上的特征，有助于弱化小三角形导致的锯齿。

在我们的测试中，使用 MSAA（替代 TAA）提高了约 25% 的 GPU 帧时。实际开销将依内容而定。

在 Rendering 项目设置中设置默认抗锯齿方法即可使用 MSAA：

控制台变量“r.MSAACount”控制每个像素计算的 MSAA 采样数。“r.MSAACount 1”拥有特殊含义并可返回随机采样抗锯齿，便于在抗锯齿方法之间切换。

性能

进行一些渲染时，前向渲染器的速度比延迟渲染器更快。可在每个材质上禁用的功能可以实现最大的性能提升。默认情况如下：只有最近的反射捕捉应用时不带视差矫正，除非材质使用高精度反射、高度雾按每个顶点计算、平面反射只应用到启用的材质上。

在 Epic 最新的 VR 游戏《Robo Recall》上平衡这些选项。在使用 NVIDIA 970 GTX 显卡的情况下，前向渲染器比延迟渲染器的速度快约 22%。

新鲜出炉：接触阴影

接触阴影（Contact Shadows）可在物体上实现高细节动态阴影。

下图中的常春藤只是一些扁平的片，但由于材质中输出的 Pixel Depth Offset，其自身形成的阴影十分真实。

接触阴影功能针对深度缓冲在屏幕空间中添加一个短光线投射，了解像素是否从给定光照被遮挡。这能够在几何体的连接点处形成锐化的细节阴影。通过其他算法所形成阴影的接触点可能出现缺失或模糊，存在多种原因。通常这是由于缺乏分辨率或深度偏差。无论原因如何，全新的接触阴影功能能够以较小的开销填补空缺。

接触阴影可用于设置光照上的 Contact Shadow Length 属性。此属性控制屏幕空间中光线投射的长度。如设为 1，则光线投射将穿过屏幕。如设置的值较大，精度和性能将会下降。因此在实现需要的效果时请尽量将长度保持在最短。

接触阴影的另一个使用情况是从任意光照的视差遮蔽映射获得自阴影。这需要在材质中输出像素深度偏移。此动画显示了一个视差遮蔽映射的表面，接触阴影的长度设为 0.1。

新鲜出炉：自动 LOD 生成

虚幻引擎最新版本可以自动减少静态网格体的多边形数量来创建 LOD！

上面的动画显示了自动生成的五个 LOD。每个 LOD 的三角形数量均为上一个的一半。

自动 LOD 生成使用名为二次网格体简化的功能。网格体简化器将把生成的两个顶点合并，以计算与边缘发生重叠的视觉差的量。它将选取视觉影响量最小的边缘，然后与之重叠。执行此操作时，它将选取最佳位置放置新合并的顶点，并移除沿边缘重叠的三角形。它将继续以此方式重叠边缘，直到达到所要求的三角形目标数量。

此网格体简化器将维持 UV，包括生成的光照图 UV、法线、切线和顶点颜色。UV 被维持后，则可使用相同的材质，且所有 LOD 均可共享相同的光照图。

控制所生成 LOD 的高级设置在静态网格体查看器中的 LOD Settings 下。

“LOD Group”包含预设列表。可根据项目在 BaseEngine.ini 文件的 [StaticMeshLODSettings] 下进行修改。我们建议为项目设置好类别并尽量使用 LOD 群组，而不对每个 LOD 的细节进行控制。

需要注意一个重要设置：“Auto Compute LOD Distances”。因为算法了解每个边缘重叠所添加的视觉差量，所以它可以用此信息决定可接受的距离误差量。这意味着它也将自动为每个 LOD 计算所使用的屏幕尺寸。

如需了解每个 LOD 自动生成的细节，可在 Reduction Settings 中进行查看。请注意：此功能当前只可用于静态网格体，尚不支持网格体代理 LOD 生成。

新鲜出炉：预计算光照情景

最新版本现支持同一几何体在多个光照设置下的预计算光照！这在 VR 和建筑视觉表现的使用实例中尤为重要，因为这些项目要求尽量高的精度和性能。

在上例中，定向光照、天空光照和天空盒已放置到一个名为 DayScenario 的光照情景关卡中。街灯已被放置到 NightScenario 中。

使用光照情景的方法：

• 右键点击 Levels 窗口中的子关卡并将其改为 Lighting Scenario。当光照情景关卡为可见时，其光照图将被应用到世界场景。

• 在光照情景关卡上变更到蓝图的关卡流送方法

• 将网格体和灯放置到此关卡中并构建光照

• 在不变关卡的关卡蓝图的 BeginPlay 中，在需要激活的光照情景关卡上执行一个 Load Stream Level。

限制：

• 在游戏中一次只存在一个可见光照情景关卡。

• 光照情景关卡出现后，来自所有子关卡的光照图数据均会被放置在其中，因此白天时只加载 DayScenario 光照图。所以，光照图将不再由子关卡进行流送。

• 让光照情景关卡出现时将强制进行反射捕捉更新，将导致加载时间变长。

新鲜出炉：逐像素半透明光照改良

在延迟渲染器中，全新的前向着色功能现可用于半透明表面，从多个灯光处获得反射高光、从视差矫正反射捕捉获得基于图像的反射。

新鲜出炉：全分辨率皮肤着色

UE4 现支持下表面轮廓着色模型的全分辨率皮肤着色。这可生成表面细节（如毛孔和皱纹）的高保真度光照。

棋盘格渲染皮肤（左图）、全分辨率皮肤（右图） （注释：头部模型由 Lee Perry-Smith 创建）

表面细节 - 棋盘格（左图）、全分辨率（右图）

之前，皮肤上的光照使用棋盘格图案展示，一半像素包含弥散光照、另一半像素包含反射光照。光照在最终的下表面轮廓全屏通道中重组。此方法可生成下表面光照的良好效果（原始即为低频），但它可能导致表面细节光照的保真度较低。

新方法将把包含弥散和反射光照信息的每个像素打包到 RGBA 编码中。利用它可在最终的下表面轮廓全屏通道中重建全分辨率光照，通过随机采样抗锯齿获得表面细节的更佳效果和更稳定的表现。

兼容性

全分辨率皮肤着色需要至少 64 位的场景色彩格式（带完整透明通道）。默认的 FloatRGBA 场景色彩格式可正常使用，但不支持 FloatRGB 之类的 32 位表示。如场景色彩格式与全分辨率皮肤不兼容，则会退回以棋盘格为基础的光照。

使用 r.SSS.Checkerboard 控制台变量可覆盖此行为。可以使用的数值为：

0：禁用棋盘格（全分辨率）

1：启用棋盘格（旧行为）

2：自动（默认）- 如场景色彩像素格式支持，将使用全分辨率

限制

全分辨率皮肤着色是一个近似，但毫无意义。它在多数情况下均工作正常，但因编码方法不同，特定材质特征可能出现问题。以下材质尤为如是：

• 金属材质

• 自发光材质

这些特征将正常工作，但由于打包 RGBA 弥散/反射编码的缘故，输出与棋盘格之间可能存在差异。

制作材质时可以解决特定问题：将不需要进行皮肤着色的区域的不透明度设为 0 即可。为进行着色，不透明度为 0 的像素将作为默认光照。

注解：出于性能原因，以此方式对具有透明度的像素进行遮罩为可取之法——因为下表面后期处理将略过这些像素。

性能注意事项

如游戏拥有 64 位场景色彩格式，全分辨率下表面光照的处理速度通常比棋盘格更快（由于纹理提取数量更少）。而如果游戏拥有 32 位场景色彩，减少纹理带宽所换取的性能益处较大（但这取决于硬件）。

新鲜出炉：反射捕捉精度提升

使用反射捕捉时，引擎将混合来自反射捕捉的间接反射和来自光照图的间接弥散。因为反射立方体贴图只在空间中的一个点捕捉，这将有助于减少泄露，但光照图会在所有接收物表面进行计算并包含本地阴影。

（左图带光照图混合，右图则不带）

混合在不平表面效果较好。但在平滑表面上，来自反射捕捉的反射与来自其他方法的反射（如屏幕空间反射或平面反射）不相匹配。

十分平滑的表面上将不再进行光照图混合。粗糙度为 .3 的表面将获得完整光照图混合，粗糙度 .1 及以下的表面将逐渐淡出至无光照图混合。这允许反射捕捉和 SSR 进行更好的匹配，过渡更不明显。

下图的镜头展示了前后的镜面表面反射。注意 SSR 和反射捕捉之间墙壁反射的区别。在动态效果下穿帮尤其明显，因为它将随摄像机一同运动（由于存在 SSR 限制）。

这会对现有内容产生影响 - 在反射泄露在平滑表面的情况下，泄露将更为明显。为解决此问题，可放置更多反射探头减少泄露。关卡最小应拥有一个大型球体捕捉。也可通过渲染项目设置恢复旧的光照图渲染行为：

新鲜出炉：Visual Studio“15”支持

虚幻引擎 4.14 版本自然支持即将推出的 Visual Studio“15”。仍然支持 Visual Studio 2015。可从 微软 Visual Studio 网站 的“Preview”部分获取 Visual Studio“15”。

如您已安装 Visual Studio 的多个版本，可在“Editor Preferences”的“Source Code”部分选择使用的版本。

新鲜出炉：从 Actor 创建静态网格体

现在可以右键点击关卡视口中的 actor 并将其当前状态转换为一个新的静态网格体资源。这个方法甚至可用于骨架网格体，因此可以从摆好姿势的角色上获取网格体。

新鲜出炉：NVIDIA Ansel 支持

UE4 4.14 新增了对 NVIDIA Ansel 摄影的支持！

Ansel 是 NVIDIA 退出的一款新工具，便于玩家在游戏中进行截图。在 Ansel 模式中时，游戏将暂停，玩家可控制摄像机构图，然后进行截图。可抓取多种截图，从 HDR 到 360 立体均可。在 NVIDIA 网站中查阅更多详情： https://www.geforce.com/hardware/technology/ansel

Ansel 现已作为全新的 UE4 插件公开。在项目中启用插件后，即可在 standalone 游戏会话中访问 Ansel。

（在网页浏览器中查看 Ansel 360 捕捉）

我们也在 Player Camera Manager 类上公开了函数，以便游戏对 Ansel 捕捉行为进行自定义。游戏可能需要限制摄像机运动的距离、禁用 UI 元素、禁用/启用特定的光照或后期处理效果，等等。感谢 Adam Moss 和 NVIDIA 提供实现。

如要开始使用此功能，请查阅 Ansel 插件文档 。

新鲜出炉：改良缆绳组件（Cable Component）

缆绳组件插件已更新新特性，包括碰撞支持和附着物体或效果的套接字。

缆绳组件现包含以下新特性：

• 包含摩擦设置的简单碰撞

• 尝试减少弯曲的刚性设置

• 缆绳每端的套接字

• 将任意一端设为“自由”的功能

新鲜出炉：UI 字体外框

UMG 和 Slate 的字体现在拥有一个可应用的任选外框。

指定字体的控件可以变更外框设置、颜色、或外框所使用的材质。

外框上字体材质的使用方法与其他字体材质的使用方法相同，唯一的区别是对外框指定的材质只能应用到外框。字体材质可在外框上使用，创建出许多不同效果。

新鲜出炉：可编辑的 Map 与 Set 属性

现可在 Details 面板中编辑 Map 与 Set 属性！

Sets 和阵列相似，但无法在一个集中两次拥有相同元素，且元素的排序无法保证。然而在一个 set 中进行查找确定其是否包含元素的速度十分之快。

Maps 拥有一个键和一个值，可在 details 面板中对这二者进行编辑。和 Sets 相同，所有的键必须独一无二，元素的排序不保证留存。然而，元素值的查找速度非常快（只要明确它是一个键）。

材质中的矢量noise">新鲜出炉：材质中的矢量 Noise

Noise 材质图表节点包含数个适用于过程着色的函数，生成一个单值（标量）结果。

新的 Vector Noise 节点添加数个 3D 或 4D 矢量结果。这些函数存在运行时开销，因此建议它们开发出一个查找后，使用 4.13 版本中加入的 Draw Material to Render Target 蓝图特性将所有或部分计算烘焙到纹理中。这些材质图表节点允许过程查看在引擎中的最终资源上开发，是用外部工具应用到引擎中资源、创建过程生成纹理的另一种方法。

这些新函数包括

1. Cellnoise：为 3D 网格中的每个单元返回一个随机色彩（即从数学下截断应用至节点输入）。特定位置的结果固定不变，是为材质增加随机性的好方法。该 Vector Noise 节点的计算开销极低，因此不需要将其烘焙到纹理中提升性能。

2. Perlin 3D Noise：用 3D 矢量输出计算 Perlin Simplex Noise 的一个版本。每个输出组件在范围 -1 到 1 之间。同时计算三个 noise 通道的开销比合并三个标量 noise 函数结果的开销更低。

3. Perlin Gradient：计算标量 Perlin Simplex Noise 的分析 3D 梯度。输出为四个通道，前三个（RGB）为梯度，第四个（A）为标量 noise。这适用于表面上的凹凸贴图和流型贴图。

4. Perlin Curl：计算矢量 Perlin Simplex Noise（又称 Curl Noise）的分析 3D 旋度。输出为一个 3D 签名旋度矢量。这适用于流体或粒子流。

5. Voronoi：将相同 Voronoi noise 作为标量 Noise 材质节点进行计算。标量 Voronoi noise 在 3D 空间中散布种子点并返回到最近点的距离。Vector Noise 版本返回 RGB 中最近种子点的位置，以及 A 中到该点的距离。尤其是配合 Cellnoise 使用后，这能形成每个 Voronoi 单元的一些随机行为。

下图是一个简单的石床材质，使用 Vector Noise / Voronoi 的距离组件调制一些表面的凹凸、混合裂缝中的苔藓，以及种子位置和 Vector Noise / Cellnoise，用于变更每块岩石的色彩和凹凸高度。

Perlin Curl 和 Perlin Gradient 可在倍频中被一同添加（只作为常规 Perlin noise 容器）。对于更复杂的表达式而言，有必要计算表达式结果的梯度。为进行协助，可放置表达式计算为一个材质函数，并将其结合助手节点 Prepare3DDeriv、Compute3DDeriv、或 GradFrom3DDeriv/CurlFrom3DDeriv 进行使用。它们使用位于四面体图案中的基础表达式的四个求值来近似这些基于导数的操作。例如，此网络使用梯度从一个凹凸高度函数计算凹凸法线。

新鲜出炉：PhysX 3.4 升级

虚幻引擎现使用 NVIDIA PhysX 最新的 3.4 版本。这改善了刚体和场景查询的性能和内存使用（尤其是多核性能）。

这个版本的 PhysX 支持 运动物体 上的 连续碰撞检测（Continuous Collision Detection）（CCD），可在高速运动的刚体之间形成精确的碰撞。在下方的 Robo Recall 测试关卡动画中，玩家挥舞武器反弹迎面而来的子弹。

可立即在 UE4 中使用的新特性：

运动物体的连续碰撞检测（CCD）（见上方动画）

• 加速运动物体更新

• 加速凸包制作

在未来版本中，我们将加入更多 PhysX 最新版本中拥有的新物理特性。

新鲜出炉：动画编辑器改良

与动画相关的工具被拆分为单独的资源编辑器，无需再在多个模式中使用一个编辑器。

还进行了多项其他改良。每个编辑器的常用功能基本均显示在视口和改良的骨架树中。

• 骨架网格体编辑器的布局和资源细节面板均有修改，材质和 LOD 部分的修改较大。

• 骨架编辑器的布局已作调整，骨架树已进行优化。

• 动画编辑器的布局已作调整，可在资源浏览器中选择性地添加和移除栏目。

• 动画蓝图编辑器的布局已作调整，更接近标准蓝图编辑器的布局。动画预览编辑器现在可以选择性地将对预览属性均进行的修改应用到类默认上。

资源快捷工具栏

使用改良的资源快捷工具栏可在共享骨架的相关动画资源之间切换。

录制移至传送功能按钮

之前的版本中，录制通过工具栏上的一个按钮进行。最新版本中，录制按钮已移至传送功能按钮中（与 Sequencer 相似）。

预览场景设置

通过“Scene Setup”菜单即可在每个编辑器中编辑场景中的物体和它们的动画。使用该功能可以应用预览动画、设置不同的预览网格体（这是针对骨架或单个动画），并附加额外的网格体。额外的网格体现可指定为单独的纯编辑器资源。这些资源将定义作为主网格体从属进行驱动的一套骨架网格体。

新鲜出炉：动画曲线窗口

在最新版本中，使用动画编辑器中的全新专属窗口即可便利地对动画曲线进行调整。编辑时即可进行即时预览。

在之前的版本中只能在动画资源上配置曲线，而在最新版本中可在骨架上进行设置。

新鲜出炉：Child Actor 模板

通过 Child Actor 模板即可自定义添加到蓝图的子 Actor 组件的属性。

添加子 Actor 组件后，拥有 Actor 的蓝图编辑器的 Details 面板中便会出现一个可展开模板。可从此处访问子 Actor 的全部属性，包括公开变量。

例如，Blueprint_A 包含一个 PointLight 组件（使用公开变量驱动其色彩），然后将该蓝图设为 Blueprint_B 中的一个子 Actor 组件，即可从 Blueprint_B 的 Details 面板中调整颜色变量。

这是一项重大改良。之前的版本中用户被限制在子 Actor 组件的默认属性中，只能通过游戏脚本进行更新。

新鲜出炉：默认动画蓝图

现可指定动画蓝图到骨架网格体。动画蓝图在组件中被指派后，该骨架网格体将固定运行。无论网格体是在动画工具中查看、只是一个 Sequencer 过场，或只是放置在关卡中，均可对固定应用的动画动态或其他控制器进行设置。

这将使动态、控制器、IK 或其他动画蓝图特性与网格体产生关联，无需在每个动画蓝图中进行复制即可在此网格体上进行使用。

“后期处理”动画蓝图也拥有其原生特性和蓝图更新步骤，因此参数可被读取或计算，以便在动画图表中使用。

新鲜出炉：VR 中的地形编辑

在新版本中可使用 VR 运动控制器创建并设计地貌，并绘制地形材质。

可在快捷菜单的“Modes”面板中打开地形编辑工具。然后从 UI 中选择笔刷并开始绘制！长按运动控制器上的“Modifier”按钮即可消除。

新鲜出炉：载具改良

新版本中轮胎力的应用点已发生变化。之前的版本中，轮胎力的应用点位于载具的质量中心。新版本中轮胎力的应用点位于 轮胎的质量中心，更容易实现车辆的载荷摆振。

此外我们还添加了 简单轮式载具移动组件（Simple Wheeled Vehicle Movement Component），无需复杂的引擎和传动模拟即可实现车轮悬挂和轮胎摩擦。利用此组件可轻松 在单个轮胎上应用扭矩。在新版本中，继承自 Wheeled Vehicle Movement Component 的全部组件均可在任意组件上使用，无需依赖于 Wheeled Vehicle Actor。

已有内容的 Deprecated Spring Offset Mode 将自动设为 true，以维持之前的行为。变更 Suspension Force Offset 即可对此行为进行进一步调整。

新鲜出炉：安卓 Vulkan 改良

在虚幻引擎 4.14 版本中可发布支持 Vulkan 的游戏。

• UE4 支持带 Vulkan 驱动的 Android 7（Nougat）设备，以及运行最新 OTA 更新的三星 Galaxy S7。

• Android 设备上的 UE4 Vulkan 渲染器已修复许多渲染问题。

• 在不支持 Vulkan 的 Android 设备上运行时，渲染器将自动撤回 OpenGL ES。

• 现可使用设备配置文件启用或禁用特定设备和驱动版本上的 Vulkan 支持，以及到 ES 3.1 和 ES 2 的撤回。这使得 UE4 游戏可在 Vulkan 实现不完整或损坏的手机上禁用 Vulkan 支持，转而使用 OpenGL ES。

新鲜出炉：支持移动设备的自定义深度

新版本的移动渲染通道中已支持自定义深度。自定义后期处理材质现在可从场景深度、自定义深度以及场景色彩取样。

需要后期处理，因此必须启用移动 HDR。但在当前版本中，移动 MSAA 启用时该功能无法正常工作。

新鲜出炉：移动设备场景捕捉改良

在最新版本中，渲染场景进行捕捉时，移动设备支持输出 Inverse Opacity 和 Depth 值的 Scene Capture Source 设置。

• “SceneColor (HDR) in RGB, Inv Opacity in A”选项可用于将带半透明度的物体渲染为纹理，然后在场景或控件蓝图上进行透明混合。

• 同样，使用结果纹理时深度值可用作遮罩。

• 生成不透明度数据存在一些开销，因此可以在不需要不透明度时使用“SceneColor (HDR) in RGB, Inv Opacity in A”优化性能。

• 场景捕捉现可在不支持浮点目标的设备上正常使用，如 Android 6 之前的 Galaxy S6。

新鲜出炉：布料蒙皮改良

我们在引擎中加入了计算模型对模型布料蒙皮数据的功能。因此无需使用导出为 .apx 或 .apb 文件的渲染数据，而使用 UE4 已拥有的渲染数据。从 APEX 导出资源选取模拟模型，并在此模型上重新蒙皮渲染数据。这意味着最终数据的效果应和最初导入的数据一样好。

这将带来一些益处。之前法线可能存在显示错误（见下图），并且限制在一个 UV 通道上。全新蒙皮系统将这两个问题一举解决。

新鲜出炉：材质属性节点

持续不断的更新改善了材质属性的可延展性，使材质属性更加易读，且不易出现错误。

• GetMaterialAttributes - 此节点是 BreakMaterialAttributes 的精炼替代品

• SetMaterialAttributes - 此节点是 MakeMaterialAttributes 的精炼替代品

• BlendMaterialAttributes - 这个新节点使材质属性结构的混合更为便捷。

Get 和 Set 节点的主要改良是引脚为选择性添加，与默认公开全部属性的 Break 和 Make 节点不同。这使得图表可避开需要手动连接每个属性引脚的老工作流程。选择一个节点将在细节面板中显示当前引脚的列表，可展开或移除此列表。例如，下图中的材质函数抓取一个属性集，然后将基础色彩（Base Color）和粗糙度（Roughness）混合到一个光亮的红色表面。

为使图表更加简洁，这些节点利用许多后端变更，对项目可能需要添加的自定义材质属性形成前向兼容。缺失的属性将被自动检测，用户可以对错误进行处理，在项目之间共享材质更为可行。在节点上非显式排列的属性（包括材质图表创建后添加的属性）将通过主 Material Attributes 引脚传递。新引脚添加 Make 和 Break 节点后，所有图表均需要手动更新。

新的 Blend 节点将实现使用一个遮罩的多个属性集的混合，这是结合材质细节层使用时的常见操作。下图实例平均地混合了红色和绿色材质（定义为函数），一个节点将为结果应用透明层。

Blend 节点默认为所有使用 Alpha 输入的材质属性执行线性插值。利用此节点的复选框可退出顶点/像素层面的混合，更易于控制纯顶点或纯像素遮罩数据的使用。与前文提到的 Get 和 Set 节点相似，Blend 节点将自动处理新属性的添加或移除，使程序员在注册属性时指定自定义混合行为。

材质中的预蒙皮本地位置">新鲜出炉：材质中的预蒙皮本地位置

在新版本中，材质可访问骨架网格体的参考动作位置，以在每个顶点的输出中使用。这可在动画角色上形成局部效果。该节点可在静态网格体之间共享，也可在返回标准本地位置的网格体之间共享。下面的图表实例在局部空间中创建了一个网格图案，它在动画中和骨架网格体之间保持相对关系。

新鲜出炉：Sequencer 镜头导入/导出改良

影片录制时可以对每个镜头进行帧处理。新版本中，在每个镜头的开头和末尾可多渲染主序列的帧。通过剪辑决定列表（EDL）即可将这些额外的帧剪入和剪出。此列表可在外部视频编辑包中使用，调整镜头之间的剪辑。

新鲜出炉：摄像机升降架改良

新版本调整了摄像机升降架的行为，可模拟物理升降架的运动。

• 摄像机升降架绕 Z 轴和 Y 轴的旋转量为 0。

• 添加升降架绕 Z 轴和 Y 轴旋转量的锁定开关。它们默认为不锁定，因此摄像机将和地面保持水平。

新鲜出炉：Sequencer 音频录制

在新版本中，录制序列时可通过话筒录制音频。

新鲜出炉：Pose Driver 改良

Pose Driver 节点使骨骼基于一套“范例动作”驱动动画的其他方面。在此版本中，该节点可驱动骨骼变形以及变形目标。例如基于手臂的旋转驱动护肩骨。此外还添加了使用驱动骨平移的选项（而不使用其方向）。已改良调试绘制，显示每个“目标”动作和骨骼当前与其之间的接近程度。

新鲜出炉：虚拟骨骼

新版本中加入了对骨架添加“虚拟骨骼”的功能。无法对虚拟骨骼进行蒙皮，但其会在骨架上两个现有骨骼之间被约束。骨架上每个动画的虚拟骨骼数据将自动生成。例如，可添加一个关节（手的子项），但其会受到手掌关节的约束。与套接字不同，此关节可作为一个目标（即 IK 目标或查看目标）在动画蓝图中使用，或在 AnimBP 中对其进行修改，以便之后使用。

这有助于改善角色迭代时间。之前的版本中，如果需要变更 IK 或瞄准的目标关节层级，需要在引擎外进行操作，DCC，然后导回所有动画修复带新关节的动画数据。而利用虚拟骨骼可跳过这些步骤，在引擎中执行全部工作。然而这需要对动画数据进行重新压缩，将关节重新纳入动画数据中。

如需了解虚拟骨骼的更多实际使用，请查阅“Paragon 中使用的动画技术”。它的出现让重新定位目标或变更控制器参考帧变得更容易，用于 Paragon 中的定位和斜坡变形。

新鲜出炉：变形目标调试视图模式

利用全新的变形目标调试视图模式（Morph Target View Mode）可更容易地确定每个变形目标所影响的顶点。

新鲜出炉：子动画蒙太奇

基于父蒙太奇创建子蒙太奇，以便替换动画片段，同时保持整体时间设置。可用于为行动添加变量，同时保证其不会影响到游戏进程。

新鲜出炉：MIDI Device 插件

新版本包含与音乐硬件交互的全新“MIDI Device”插件。这是一个简单 MIDI 界面，从连接到电脑的设备上接收 MIDI 事件。当前只支持输入。

这是它在蓝图中的使用方法：

• 使用插件 UI 启用“MIDI Device”插件，然后重启虚幻编辑器。

• 在 Blueprint RMB 菜单中查找“MIDI Device Manager”。

• 调用“Find MIDI Devices”选择中意的设备。

• 打开“Found MIDI Device”结构体查看可用内容。

• 然后对所需设备调用“Create MIDI Device Controller”。将其保存在一个变量中。（将对对象的引用保存在变量中十分重要，否则它将被垃圾回收，无法接收事件！）

• 在 MIDI Device Controller 上将自己的事件绑定到“On MIDI Event”事件。存在至少一个要接收的新 MIDI 事件时，它将在每个游戏 Tick 上调用。

• 对传入事件的数据进行处理，使项目正常运行！

新鲜出炉：地形镜像工具

新版本中的地形镜像工具可将几何体复制到镜面平面，创建斜向对称的多人游戏地图。

新鲜出炉：网格体材质槽导入改良

新版本中的材质流程已修改，可对静态和骨架网格体中每个材质的使用进行更大程度的控制并获得更多信息，改善导入网格体时材质排序的不一致。

列表中的每个元素为带下列信息的材质槽

• 槽名称

  • 槽名称用于在重新导入时匹配材质。网格体被重新导入时，将在 FBX 文件中寻找此名称，以确定匹配到现有材质的哪个部分。在之前的版本中，这依赖于索引排序，容易出现顺序混乱。
    

  • 在此修改前导入网格体的材质槽将设为空。在此修改后导入网格体的材质槽将默认设为导入的材质名。

• 材质资源引用

• 原始导入的材质名（在提示文本中）

在蓝图和 C++ 中，现可使用材质槽名检索材质槽（不使用硬编码索引）。调用 Set Material By Name 在骨架网格体或静态网格体组件上设置动态材质。如网格体上的材质排序发生变化，使用名称查找（不使用索引）可确保游戏代码正常工作。

新鲜出炉：平台 SDK 升级

在每个更新版本中，我们都将更新引擎，以支持平台合作伙伴的 SDK 版本。

• Xbox One：升至 August 2016 QFE 2

• Playstation 4：升至 PSR SDK 4.008.061

• HTML5：升至 Emscripten 1.36.13

• macOS：现支持 10.12 Sierra, Xcode 8.1

• iOS/tvOS：现支持 iOS10/tvOS10, Xcode 8.1

新鲜出炉：移动下载/补丁蓝图库

全新 移动补丁应用蓝图库 包含移动游戏从云端网站 下载并安装游戏内容和补丁（而非从 App Store 上进行初始下载）的所有必备功能。

这些功能可确定是否有更新游戏内容、开始下载、跟踪进程、处理错误，并在最后安装成功下载的内容包。此外还包含检查存储空间和 WiFi 连接的功能，以便蓝图在这些情况下提醒用户。支持 Android 和 iOS。

新鲜出炉：Kindle Fire 的 Amazon GameCircle 插件

新版本中包含全新在线子系统 GameCircle（Online Subsystem GameCircle）插件！

支持 GameCircle 成就、排行榜、好友和 Amazon 内购。启用此插件后，即可在 Plugins 类目下访问全新的 Amazon GameCircle 项目设置面板。针对 Fire TV 的 AndroidManifest.xml 变更可在此处启用。

新鲜出炉：实时 GPU 分析工具

UE 4.14 包含一个实时 GPU 分析工具，可提供主要渲染类型的逐帧数据。输入控制台命令“stat gpu”即可使用。*'**也可通过 Viewport Options 下拉菜单中的“Stat”子菜单将数据在编辑器中打开。

这些数据为累积式，非层级式。因此不需要从事件树向下寻找即可看到主要类型。例如，阴影投影为所有光照的全部投影（在所有镜头中）的总和。

游戏运行时，通过屏幕上的 GPU 数据即可简单了解到 GPU 负载情况。数据也可用于即时测量变化带来的影响。例如修改控制台变量时，即时修改编辑器中的材质、或修改并重新编译着色器（recompileshaders 已修改）。

游戏运行时，GPU 数据可录入到一个文件中，以便之后进行分析。和现有数据相同，可使用控制台命令“stat startfile”和“stat stopfile”即将数据录入到一个 ue4stats 文件。在 Unreal Frontend 工具中打开文件即可查看数据。

使用 UnrealFrontend 对 GPU 进行分析。总共会显示后期处理和基础通过时间

数据在代码中被声明为浮点计数器，如：

DECLARE_FLOAT_COUNTER_STAT(TEXT("Postprocessing"), Stat_GPU_Postprocessing, STATGROUP_GPU);

渲染线程上的代码块即可通过 SCOPED_GPU_STAT 宏（这些宏引用那些数据名）进行 instrument。这与 SCOPED_DRAW_EVENT 的工作方式相似。例如：

SCOPED_GPU_STAT(RHICmdList, Stat_GPU_Postprocessing);

未显式 instrument 的 GPU 工作将包含在一个包罗 [unaccounted]数据中。如数据非常高，则说明丢失的工作需要一些额外的 SCOPED_GPU_STAT 事件。与绘制事件不同，GPU 数据为累积式。可以为相同数据添加多个输入，这些输入在帧上进行聚合。

在一些 CPU 受限情况下，GPU 时间设置可能受到 CPU 瓶颈（气泡）影响（此时 GPU 在等待 CPU 同步）。如果绘制线程时间很高，且出现异常情况，则需要考虑这点。在 PlayStation 4 上，我们将命令列表提交之间的时间从时间设置中移除，纠正了这些气泡。在未来的版本中，我们将把此功能延伸到其他主流渲染 API 上。

新鲜出炉：合并 Actor 纹理图谱改良（实验性）

新版本中推出了一个新选项生成 加权（二进制）图谱纹理（替代每个材质平均加权的图谱纹理），从而改善了合并 actor 和组合材质时 纹理空间的应用方式。

（左图：平均加权的材质。右图：二进制法）

新功能首先计算单个材质的重要性（根据其采样的最大尺寸纹理）。之后这些值用于计算材质应占据空间量，并迭代式地将每个纹理添加到图谱纹理。这使图谱纹理对输入材质更具有代表性，因为它在计算它在图谱纹理中占据的最终空间时会把原始纹理数据的大小考虑在内。

新鲜出炉：在 Linux 上支持 Android

由于社区用户呼声较高，新版本已在 Linux 上支持 Android。设置所需 NDK 和 SDK 工具最简单的方法是使用 NVIDIA 提供的 CodeWorks for Android（Linux 平台）。此外需要安装 OpenJDK 1.8；设置 JAVA_HOME 指向安装。请注意：新版本尚未在 Linux 上支持 Android Vulkan。

新鲜出炉：媒体播放器编辑器

新版本中，用户可从电脑上拖放文件到媒体播放器的视口中，无需创建 FileMediaSource 资源即可预览视频文件。

• 已添加一个解码器性能数据标签。输出取决于用于播放的玩家插件。

  

新鲜出炉：移动 VR 多视图

现在可以在支持设备上使用移动多视图通道！移动多视图和桌面上的实例化立体，为 CPU 上的立体渲染提供了一个优化通道。

如需使用此功能，在 Project Settings 下的 VR 部分将其启用即可。为使功能正常工作，应将 Android 编译设置设为 OpenGL ES2、禁用 Mobile HDR，并禁用实例化立体。当前版本中，此功能兼容基于 Mali 的主流 GPU。如打包时开启了此功能但 GPU 不兼容，其在运行时将被禁用。

此功能仍在实验性阶段，我们还需要验证它与更多功能和设备之间的兼容性。

如上图所示在 Project Settings 菜单中启用移动多视图，然后重启编辑器使变更生效。

新鲜出炉：SteamVR 和 PSVR 分层

新版本已支持 SteamVR 和 PSVR 分层！它的工作方式和 Oculus Rift 插件完全相同——使用 Stereo Layer 组件。

新鲜出炉：VR 加载影片

引擎新版本支持 Oculus、GearVR、SteamVR 和 PSVR 上的加载影片。影片在渲染线程上运行，可掩盖加载内容时的帧率小问题。

如需使用启动画面，可设置一个纹理使用“Set Splash Screen”节点，或选择在使用“Enable Auto Loading Splash Screen”节点加载地图时使其自动出现。

新鲜出炉：PSVR 支持多个帧率目标

新版本支持 PSVR 的原生 90Hz 到 90Hz 投射和 120Hz 到 120Hz 投射！这意味着可选则更高的帧率运行，将延迟和投影穿帮最小化。引擎将把帧率锁定在选择上，但使用者仍需努力保证帧率的稳定！

新鲜出炉：Windows 多点触控

使用触控屏时，将在 Windows 7、8 和 10 上生成触控事件。拥有此功能后，即可在全新的 Windows 平板上实现触控游戏和体验。此外，无需部署到目标设备即可对移动游戏的触控操作进行测试。

新鲜出炉：快速异步加载系统（实验性）

打包版本现可使用全新的事件驱动加载器（Event Driven Loader），效率远高于之前使用的流送代码。使用 EDL 后，游戏的加载时间将缩短约 50%，多数情况下加载速度极快。

事件驱动加载器加载资源的代码路径统一。这意味着所有包均使用新的异步路径，不再使用旧的块路径。

EDL 当前仍为实验性功能，默认为禁用，但可通过项目设置轻松开启。

新鲜出炉：Game Mode 和 Game State 类简化

新版本中添加了全新 Game Mode Base 和 Game State Base 类，作为现有 Game Mode 和 Game State 类的父项。所有游戏必需的核心功能位于 Base 类中，而旧版本和射击游戏特有的功能位于 Game Mode/Game State 中。新创建的项目将继承自 Base 类，而已创建的项目将默认使用旧版本中的类。此外，一些新函数已对蓝图公开。

这项修改是一个长期的更新工作，使旧的游戏性类更容易被理解，并编入所有类型项目的子类。所有范例均已更新使用 Base 类（Shooter Game 除外），而 Shooter Game 将说明如何在旧的类中使用射击游戏特有的功能。新版本将继续支持 Game Mode/Game State，使用者应将把适合自身游戏的版本编入子类。

新鲜出炉：网络复制加速

新版本中，从服务器到连接客户端复制属性的方式已进行内部重构。

我们已对代码进行修改，以便高效低在诸多连接之间高效地共享属性复制工作。在此修改之前，我们只共享无条件属性（以 DOREPLIFETIME，而非 DOREPLIFETIME_CONDITION 注册的属性）的工作。而现在，我们共享所有类型属性的工作。这意味着属性发生改变（需要被发送）时需要执行检查工作的频率将大幅降低。

内部测试的结果显示降低率已高达 40%。还有更多工作需要完善，但我们同时也希望告知大家开发进度，分享好消息！

Release Notes

AI

• New: Added an "Enable AI System" flag to the World Settings that controls whether the AI System will be created for the given map.

• Bugfix: Fixed an issue with AI Sense Sight's time slicing unintentionally skipping queue-aging if the given time limit was reached.

• Bugfix: Fixed an issue basing whether the AI should turn or not by comparing the current desired rotation vs the last update's desired rotation. The AI should be turning based on whether or not the current desired rotation is different from the rotation of the Pawn.

• Improvements for the consistency of loudness usage in AI Sense Hearing.

• Minor cosmetic fix to EQS test scoring function's preview.

• Selecting Geometry trace mode will no longer project onto the Nav Mesh first in the Projected Points EQS generators.

Behavior Tree

• New: Expanded the BT Decorator Is At Location function with an option to use AI Data Provider.

• New: Multi-node comments are now supported in the Behavior Tree editor. This is similar functionality to the Blueprint editor.

• Bugfix: Fixed an issue with BT Decorator Compare BB Entries function so that it works regardless of the order of the supplied BB keys.

• Bugfix: Blackboard key synchronization mechanics correctly handle more edge cases and complex inheritance scenarios.

• Bugfix: Fixed an issue in propagation of persistent Blackboard keys resulting in these keys missing or being doubled in child Blackboard assets.

• Bugfix: Fixed an issue for derived Blackboard sometimes getting post-load mechanics run before their parents.

Navigation

• Bugfix: Aborting previous movement requests as part of requesting a new one no longer resets the agent's current velocity.

• Bugfix: Blueprint "AI Move To" function no longer uses the default AI Controller's navigation filter.

• Bugfix: Fixed navigation export for landscape not handling mirroring and async gathering correctly.

• Bugfix: Fixed an issue with navigation export for the capsule component.
  

• Bugfix: Navlink's "Snap to cheapest area" mode now works correctly with dynamic navmeshes.

• Bugfix: Navmesh generation no longer gets stuck in an infinite loop.

• Bugfix: Fixed an issue with parameters of vehicle RVO avoidance.

• Bugfix: Fixed an issue with Path Following Component for "Has Reached" not using the Goal's Radius when "Use Nav Agent Goal Location" is set to false. When "Use Nav Agent Goal Location" is set to true, we want to avoid using the Goal's location on the navmesh, but instead the acceptability of a radius should be based on the Goal's radius.

• Path Following Component distinguishes between partial and full paths in terms of acceptance radius used. This will make partial paths behave as expected with non-trivial big acceptance radii.

• Layer limit for navmesh generation has been increased.

• Update Move Focus will only clear the focus if the path following component is idle. This keeps the AI rotated in the correct direction when movements get paused.

Animation

• New: Added "Strip Animation Data On Dedicated Server" option to Animation Settings. This will remove all compressed data from cooked server data. Disabled by Default.

• New: Added "Aim Offset Look At" node. Aim Offset node that drives its inputs automatically from a Target Location and a Source Socket.

• New: Added Conversion settings to the Alembic import process. This enables the following:

  • Inverting UV Channels.

  • Applying a conversion matrix to the Alembic File.

  • Presets for Autodesk Maya and 3DS Max.

• New: Added "LegIK" Anim node, which supports two or more bones per limb with min compression rotational constraint.

• New: Added logic to separate overlapping notifies onto separate tracks. Notifies can no longer end up hidden from the user by occupying the same time on the same track.

• New: Added the option to copy selected Morph Target names to clipboard.

• New: Added a start time to Montage Play node and Play Slot Animation as Dynamic Montage.

• New: Added the ability to skip empty "preroll" frames when importing an Alembic file and improved the frame information for the Import Options UI.

• New: The animation "Sequence Length" property can now be read in Blueprints.

• New: Added the ability to open Anim Montage to open asset from the context menu of the segment.

• New: Added ability for selected Morph Target to view the modified vertices while in the Persona.

• New: Added option to now insert current pose to the Pose Asset with Insert Pose.

• New: Added SmartName Deterministic Cooking:

  • SmartName discards GUID during cooking and DisplayName becomes the identifier during cooking.

  • The GUID created nondeterministic cooking causing patch size to become huge without any actual data change.

• Bugfix: Fixed a crash when attaching slave components with differing bone counts.

• Bugfix: Fixed a crash with retargeting Additive Animation Montage.

• Bugfix: Fixed a crash when routing a wire through multiple re-route nodes in an Animation Blueprint.

• Bugfix: Fixed a crash in "Get Post Curve" when importing a pose to pose asset.

• Bugfix: Fixed a crash when retargeting Anim Blueprint with "Allow remapping to existing assets" was enabled.

• Bugfix: Fixed a crash when calling "Set Animation Mode" on a component with no Skeletal Mesh.

• Bugfix: Fixed an issue when re-creating a skeleton due to a merge conflict it will add all Skeletal Meshes back to the skeleton so that it recreates all hierarchy.

• Bugfix: Fixed an issue with invalid bound calculation in Calculate LOD Count.

• Bugfix: Ensure the runaway loop counter gets reset when processing parallel animation.

• Bugfix: Fixed an issue for fast path struct copy being broken for Vectors.

• Bugfix: Fixed an issue for warning triggered by calling "Get Bone Transform" before the master pose component has been registered

• Bugfix: Fixed an issue where layered blend per bone odd/even connection counts alternately working/not working

• Bugfix: Fixed an issue with offset of the floor mesh in Persona when Auto-Alignment was enabled.

• Bugfix: Fixed an issue with pose flickering on LOD change when using "Layered Blend by Bone" node.

• Bugfix: Fixed an issue to stop empty states being created when dragging montages into State Machines.

• Bugfix: Fixed an issue with Anim Instance "Is Running Parallel Evaluation" check to correctly test if the Skeletal Mesh Component still references the Anim Instance being used.

• Bugfix: Fixed an issue with "generated" string appearing for a Skeletal Mesh LOD that was previously auto-generated but had been reimported from an FBX.

• Bugfix: Fixed an issue with displaying one more frame for an animation.

  • For example, for 30 frames, it was displaying 0-30, which is incorrect and should be 0-29.

  • To avoid confusion, now it doesn't display key count. It will display the last frame number, so it will look different, but the data is still the same.

• Bugfix: Fixed an issue with a number of cases where sub-instance animation instance functions weren't being correctly passed through the main instance.

• Bugfix: Fixed an issue with "auto" check box in the Morph Target panel.

• Bugfix: Fixed an issue with functionality of "show uncompressed animation" option in Persona viewports.

• Bugfix: Fixed an issue with entries in the Anim Curves tab losing "auto" state when hidden/reshown.

• Bugfix: Removed errant asterisks in the tooltips on the "Rotation Multiplier" node.

• Bugfix: Fixed incorrect tooltips on the "Hand IK Retargeting" node.

• Bugfix: Fixed an issue in montages where the wrong section was updated with changes from a Details panel when clicking on a different section.

• Bugfix: Fixed an issue when duplicating an Anim Sequence that has been layer-edited would apply the layer twice.

• Bugfix: Fixed an issue where Geometry Cache objects would not be visible in Standalone (packaged) builds.

• Bugfix: Fixed an issue with keyboard shortcuts for Pose Asset editor panel.

• Bugfix: Fixed an issue with keyboard shortcuts in the Curve Viewer panel.

• Bugfix: Fixed an issue with notify states not ending when the Animation Instance was cleared.

• Bugfix: Fixed an issue with orphaned transition nodes being created when they were duplicated or pasted without two valid pin links.

• Bugfix: Fixed an issue with Override Materials hanging around when setting Skeletal Meshes.

• Bugfix: Fixed an issue with pin defaults on sub-instance nodes overwriting the defaults on the inner class.

  • The class defaults will now be copied out to the pin.

• Bugfix: Fixed an issue with pose asset blending.

  • Normalization has been removed for weights that are less than one so the poses do not instantly snap.

• Bugfix: Fixed an issue where Pose Asset was evaluating the curve in the wrong frame.

• Bugfix: Fixed an issue where the Pose Asset editor list was not updating when changing the source animation.

• Bugfix: Fixed an issue with "Remove Linear Key" for Additive Animations since DDC has been added.

• Bugfix: Fixed an issue with "Root Motion from everything" calculating incorrect root motion when animations haven't been ticking.

• Bugfix: Fixed an issue with sample rate not applied for non-default sample rate when importing an animation.

• Bugfix: Fixed some inconsistencies in IK editing in the viewports inside Persona when changing effector spaces.

• Bugfix: Fixed an issue with split struct pins on animation nodes sometimes losing their links on editor restart.

• Bugfix: Fixed an issue where sub-instance automatic properties would appear in the Details panel.

• Bugfix: Fixed a typo in "Root motion from everything" accumulation code where we calculated root motion weight using the wrong variable.

• Bugfix: Fixed an issue where Undoing and Redoing would force the Skeletal Mesh into T-pose.

• Bugfix: Fixed an issue when importing Morph Targets with fixed frame count.

• Bugfix: Fixed an issue with Blendspace triangulation.

• Improved editor response during dragging on additive frame index (stop animation compression happening for each mouse move).

• Non-POD structs can now be copied using the 'fast path' in animation blueprints.

• Prevented invalid GUIDs from being saved into SmartName containers.

• Removed save warning about empty animations from assets that contain curve data.

• Animation Curve Cached UID list has now been moved to Bone Container from Anim Instance in preparation of supporting curve linking to bone feature, so that you could cull out for a certain LOD.

• Changed "Create Physics Asset" in the context menu for Skeletal Meshes to enable creation of a Physics Asset without having to assign it to the Skeletal Mesh. This makes it easier to make new assets for Capsule Shadows.

• Changed inline curve name editing to only change the name of that specific curve, instead of renaming the SmartName itself.

Animation Blueprint

• Bugfix: Fixed a crash using anim debug with sub-instances that are preceded by branching nodes.

• Bugfix: Fixed a crash when forcing ref pose during Anim Blueprint initialization when using sub anim instances.

• Bugfix: Fixed a crash when using sub-instances in non-entry states.

Tools

• New: Added Skeletal LOD workflow refactor.

  • Now we track source files for LODs to save time when reimporting LODs often.

Audio

• New: Added a debug command to solo specific sound waves, sound cues, and sound classes.

• New: Audio thread is now enabled by default.

• New: Gameplay Statics' "Create Sound 2D" and "Spawn Sound 2D" now have a boolean parameter that specifies the sound should persist across level transitions.

  • Note that the returned component must continue to be referenced by something (Game Instance is a good option) or else it will be garbage collected and the sound will stop.

• New: Looping sounds are now searchable by the asset registry.

• New: Making ability to suppress subtitles a UPROPERTY.

• New: Added support for parsing .wav files with a WAVE_FORMAT_EXTENSIBLE format chunk.

• New: Added support for pausing individual audio components.

• Bugfix: Fixed a crash which would occur when copying and pasting an undefined custom sound node from one project to a project which doesn't have the custom node.

• Bugfix: Fixed an issue for one-shot sound wave instances triggering unintentionally from active sounds when volume mix is 0.

• Bugfix: Fixed an issue for sound cue delay not consuming startime correctly.

• Bugfix: Fixed an issue with attenuation on 2D multi-channel sound sources.

• Bugfix: Fixed an issue with concurrency resolution rule stop quietest with looping sound waves.

• Bugfix: Fixed an issue with sound node distance cross fade for case of looping sounds.

• Bugfix: Fixed an issue where Undo in Sound Cue editor does not undo looping changes.

• Bugfix: Fixed various thread safety issues with occlusion on the audio thread.

• Hooked up compression quality settings to AT9 files.

• Prevent procedural sound waves from stopping if they generate 0 bytes of data.

• Read Compressed Info calculates duration for ADPCM audio.

Automation

• New: Added a json summary report file generation as part of all automated test summaries.

• New: Functional tests now support warnings as errors on a per test basis.

• New: Included .tps files in the installed build to make it easier for users to identify third party software in use. Also included source for additional programs to Installed Build.

• New: Added Documentation/Extras in Installed Build.

• Bugfix: Fixed an issue with Test Equal Add Error Message in Automation Test Base

• Bugfix: Fixed issues with Mobile Device Interface in Installed Builds.

• Bugfix: Fixed an issue with Android sessions not appearing in the Session Frontend.

• Bugfix: Fixed support for PS4 in Installed Builds.

• Bugfix: Fixed various connection reliability issues with TCP Message Transport used for automation testing on mobile devices.

• Bugfix: Fixed various issues for PS4 deployment.

• Bugfix: Fixed support for Xbox for Installed Builds created via Build Graph script.

• Automation - Presets are now stored in json files stored in Config so they can be shared, and human readable. Working on screenshot automation, getting it where it needs to be to permit us to have repeatable tests for comparison.

• Each session launched from the Session Frontend Launch tab now has a unique GUID and they will correctly appear as separate sessions in the Automation tab.

• Excluded some more intermediates from the Installed Build.

• Functional Tests now run correctly in non-editor build.

• Functional tests will no longer move the camera if the user is using a debug camera.

Blueprints

• New: Added a new "Is Standalone" node which returns true if the game is running in Standalone.

• New: Added ability to change curves used by a Timeline at runtime.

• New: Added an option in Editor Preferences Blueprint section to "Display Unique Names for Blueprint Nodes" rather than the node type.

• New: Blueprint Nativization: Reduced size of the executable file.

• New: Added ability to flag Components added via Blueprints as editor only.

• New: Exposed "Get Component By Class" to Blueprints.

• New: Exposed the method to "Is Any Rigid Body Awake" for primitive components to Blueprints. This enables a Blueprint to determine if Physics Simulation is being done on the object and fulfills a request to determine if an object is "awake" or "asleep".

• New: Replication condition property flags are now exposed to Blueprints. This can be set in the Properties Details panel.

• New: Single layout Blueprint is no longer an experimental feature. The option to disable it has been removed.

• New: Widget and Animation rich diff tool is no longer experimental.

  • Some changes are not detectable by the diff tool, but they are mentioned in a warning to the user.

• New: Enabled instances of Hierarchical Instanced Mesh Components to be moved around with the transform widget in the Blueprint Editor, just like Instanced Mesh Components!

• Bugfix: Fixed a crash in the Blueprint Profiler when compiling or profiling that had the following:

  • Contains a loop.

  • Nested Macros.

  • Collapsed Nodes.

  • Called parent functions or events.

• Bugfix: Fixed a crash caused when compiling a Blueprint after hot-reloading its base class.

• Bugfix: Fixed a crash when compiling particularly cross-dependent Blueprints.

• Bugfix: Fixed a crash when trying to pick a debug world for the Blueprint debugger.

• Bugfix: Fixed a crash when implementing an interface to a child Blueprint and then implementing it with a parent Blueprint.

• Bugfix: Fixed a crash that could occur when reparenting a child Blueprint class that had inherited its default scene root component from the parent class.

• Bugfix: Fixed a crash that would occur on a right-click in the Blueprint editor's component tree view after having copied one or more BSP actors to the clipboard.

• Bugfix: Fixed a crash that could happen when pasting a copied "Select" node.

• Bugfix: Fixed a crash on load in "Remove Node and Promote Children" when removing a corrupted SCS node if it has no parent link (the children are moved to the root node instead).

• Bugfix: Fixed a rare crash in "Get Default Value Visibility" after removing a pin from a Blueprint node.

• Bugfix: Fixed a crash when one attempts to generate an abstract class from a Blueprint.

• Bugfix: Fixed a crash in FCDODiffControl when CDOs being compared had different numbers of properties.

• Bugfix: Fixed a crash that could occur when pasting graph nodes with orphaned connections to a different graph.

• Bugfix: Fixed a crash when deleting many Blueprint assets.

• Bugfix: Fixed an issue where a function, created from collapsed nodes, cannot have a parameter of a weak pointer type.

• Bugfix: Fixed an issue with assets referenced by a function's local variables won't be garbage-collected.

• Bugfix: Fixed an issue where the Blueprint Editor viewport now correctly displays the result of an undo action that changes the default transformation of the Blueprint Actor.

• Bugfix: Fixed an issue where changes in User Defined Structure will be properly applied in local variables, without resetting the values.

• Bugfix: Fixed circular dependencies introduced by default values on User Defined Structs that are now loaded correctly. This fixes on cause of data resetting to default on load.

• Bugfix: Fixed an issue where compiling a Blueprint would trigger the World Outliner to sometimes detach.

• Bugfix: Fixed an issue where entering "foreach" in the Blueprint Editor context menu will not result in "For Each Loop" being the first selection.

• Bugfix: Fixed an issue where moving a variable from a child class to a parent class would break variable Blueprint nodes.

• Bugfix: Fixed an issue in the Blueprint context menu where options would be unavailable when you hid a sub-level.

• Bugfix: Fixed an issue so that the "Create Save Game Object" node will now change its output type to match the class you select.

• Bugfix: Fixed an issue that caused comment bubbles to display incorrectly when using Play-In-Editor.

• Bugfix: Fixed an issue where functions could lose inputs after adopting them from an interface.

• Bugfix: Fixed an issue that would cause split-pins on latent "Gameplay Task" nodes to lose connection.

• Bugfix: Fixed an issue that could hang the editor indefinitely during Blueprint Compilation.

• Bugfix: Fixed an issue that prevented the option to split a struct pin from appearing on a "Get Variable" node.

• Bugfix: Fixed an issue that prevented you from ctrl-dragging pin links from macro nodes.

• Bugfix: Fixed an issue that would cause subsequent latent nodes to fail to execute once one was running.

• Bugfix: Fixed an issue that would prevent saving a Blueprint after compiling a component that it used.

• Bugfix: Fixed an issue where Blueprints were not properly inheriting their associated config file.

• Bugfix: Fixed an issue with rotation struct input pins where splitting them would cause each of the values to shift to the wrong axis.

• Bugfix: Fixed an issue in which data loss could occur for inherited component default value overrides within a child Blueprint class after recompiling a Blueprinted component class.

• Bugfix: Fixed an issue that could lead to data loss at runtime when choosing to enable the optimized Blueprint component instancing path for a cooked build.

• Bugfix: Fixed an issue that could lead to per-instance data loss in Blueprint-constructed components after renaming component variables in the components tree view.

• Bugfix: Fixed an issue that would lead to Blueprint class compile errors caused by missing client-only component class reference properties in an uncooked server-only context (e.g. UE4Editor.exe -server)

• Bugfix: Fixed an issue where "Custom Event" was no longer the top option when searching the Blueprint menu for "custom."

• Bugfix: Fixed the directions of parameters in functions like "Get Overlap Infos."

• Bugfix: Fixed an error when output references parameters of Blueprint Native Event are not in a specific order.

• Bugfix: Fixed failed "ensures" when pasting linked Anim Blueprint nodes.

• Bugfix: Fixed issues that could lead to per-instance component data loss after reconstruction of a Blueprint class containing one or more "Add Component" nodes in the Construction Script.

• Bugfix: Fixed issues with Object Library. It now stores "Blueprint Generated Graph" object instead of "Blueprint" object.

• Bugfix: Fixed an out-of-order registration issue with native and/or non-scene components and Blueprint-constructed components.

• Bugfix: Fixed an issue with "Time Seconds To String" format so it matches the comment.

• Bugfix: Fixed a validation of incompatible pines issues. It will now generate an error.

• Graphs in a Blueprint can properly be deleted even if they were once part of an interface on the Blueprint.

• Inherited components in a child Blueprint class will no longer trigger a warning message when the original component has been removed from its parent class.

• Moving a child component in a child Blueprint doesn't force a parent to become dirty anymore.

• Nested Default Sub-objects no longer trigger an assertion failure in "Static Allocate Object" when used by a Blueprint type.

• Reduced PIE startup time significantly when auto-recompiling a Blueprint class with multiple dependencies.

• Removed warning that would complain about "Make Struct" nodes that didn't have any properties exposed, enabling Blueprint users to return default struct data.

• "Show World Context Object" markup is now fully inherited. Previously only inherited for one level of a hierarchy.

• Stale breakpoints saved in Blueprint assets no longer trigger a warning on load. Message moved to 'Display' channel.

• Struct Ref Pins in "Set Fields In Struct" node can no longer be split when optional pins as this created ambiguous behavior.

• Blueprint function "Get Direction Vector" has been renamed "Get Direction Unit Vector" to reflect details of its result.

• Can no longer drag child actor from World Outliner to a Level Blueprint and create an invalid actor reference.

• Default event nodes in child Blueprints now wire up parent call inputs so you can use them as is without breaking functionality.

• Duplicating levels that have Blueprints with "Knot" nodes attached to events will no longer fail with a "Graph is linked to external private object" error.

• EaseIn/EaseOut descriptions corrected to match actual behavior.

Core

• New: Added a config based system for specifying which classes should be stripped on dedicated server and client builds.

  • Class names can be specified in the project cooking settings in the editor

  • All engine classes that relied on "Needs Load For Server" or "Needs Load For Client" have been moved over to the config based system.

  • "Needs Load For Server" and "Needs Load For Client" still function as they previously did.

• New: Added a new file into the ini hierarchy to begin fixing the Engine/Base > Project/Default > Engine/Platform > Project/Platform confusion.

  • We now have Engine/Base -> Engine/BasePlatform -> Project/Default -> Engine/Platform -> Project/Platform. However, Engine/Platform will soon be deprecated as we move things over to Engine/BasePlatform, that are safe to move.

• New: Added ability for arrays of structs to specify a property to be the key.

  • So, with LODGroups, the Name key inside the struct can be the unique key, so when you have multiple .ini files in the hierarchy overriding the same LODGroup by name, it will replace the first with the second, instead of adding two entries with the same name. Set by @ArrayName=KeyPropertyName. Per Object Config sections need a little different handling, which uses * (see Base

• New: Added new Module Types: "ClientOnly" and "ServerOnly"enabling better control of when modules are compiled and loaded.

  • Can be used to slim down server / client builds.

• New: Added some extra information to an assert when "Cpp Structs Ops" has not been initialized.

• New: Added the ability for plugins to reside outside of the Engine/Plugins and Game/Plugins directory.

  • This is useful for plugins that are shared across game teams, but don't want to be placed in Engine/Plugins.

• New: Accepting comma in milliseconds separator when parsing Timespan.

• New: Minor changes to pak file security delegate. Now all files that don't exist in the pak file will be passed through the security delegate, regardless of whether they exist on disc or not.

• New: Only accept "log=" and "abslog=" command line values if the filename has a ".log" or ".txt" extension.

• New: Refactored handling of some UI and rendering code when running headless (i.e. with -nullrhi switch).

• New: Upgrading an existing UProperty from FVector to FVector4 is now seamless and preserves data properly.

• Bugfix: Fixed a rare crash when async loading objects caused by linker being detached too early, before other package's import has been fully processed.

• Bugfix: Fixed a crash on cooker exit due to unpredictable destruction order of static tickable objects and their collection.

• Bugfix: Fixed a crash with potential memory corruption when loading Data Tables. It sometimes would allocate less memory than was required.

• Bugfix: Fixed a crash in PhysX cleanup if an exception occurred during shutdown.

• Bugfix: Fixed a thread safety issue in the load module code that could crash if multiple threads were trying to load the same module at the same time.

• Bugfix: Fixed an issue where "Get All Assets" would not return data about live objects when passing bIncludeOnlyOnDiskAssets=false.

• Bugfix: Fixed an issue with task graph memory leaks.

• Bugfix: Fixed an issue with TMap deserialization in struct serializer and updated unit tests.

• Bugfix: Fixed an issue to display a meaningful error and shutdown cleanly if Core modules fail to load on engine startup.

• Bugfix: Fixed an issue so that dynamic delegates can no longer get double bound when copying an Actor.

• Bugfix: Fixed a potential race condition and minor memory leak in FMonitoredProcess. This could result in the editor hanging on startup.

• Bugfix: Fixed an issue where "Force Garbage Collection" might not force a GC immediately if run on a server with no clients connected.

• Bugfix: Fixed a memory corruption when instancing subobjects of a TArray property.

  • Fixed a memory overrun when reading an SSL certificate.

  • Fixed an invalid memory access when shutting down FInputBindingEditorModule.

• Bugfix: Fixed an issue where duplicate log lines appear when commandlet "Log To Console" is set.

• Bugfix: Fixed an issue with FAssetPtr remapping issues for duplicated packages, which was a case with operations like Level Save As and Level Duplicate.

• Bugfix: Fixed an issue with Malloc Binned "Get Allocation Size" for aligned allocations, which caused crashes with the poison proxy.

• Bugfix: Fixed an issue with Parse "Value" when there is whitespace between the command and the argument.

• Bugfix: Fixed an issue with "Is A" race condition during async loading.

• Bugfix: Fixed an issue where Unreal Build Tool would fail when trying to delete a module's manifest file in a non-existent directory.

• Bugfix: Fixed an issue where newline escape sequence wasn't written to the pipe.

• FScopedCreateImportCounter will now always store the current linker and restore the previous one when it exits.

  • This should fix some of the linker warning messages reporting wrong package name.

• Invalidate string asset reference tags after finishing up loading of an async package.

  • Fixes some problems with asset refs not updating correctly after a package was loaded asynchronously

• Lines of output text from FMonitoredProcess are no longer truncated at the default pipe buffer size, and are no longer returned with trailing CR characters on Windows.

• Made sure Skeleton assets are loaded before "PostLoad" is called on them to avoid crashes when async loading animations.

• Silently skip creating exports from a package where the outer is also an export and has been filtered at runtime during loading.

• Thread safety fixes for the async log writer + made the async log writer flush its archive more often.

• Thread safety fixes when using the async loading thread.

• We now abort a directory watch if we lose access to the directory in question to prevent an infinite loop.

Editor and Tools

• New: Added a warning message to indicate that HLOD clusters do not have a valid proxy mesh, similar to the "lighting unbuilt" message.

• New: Added a commandlet to enable command line importing of any asset type that the engine supports.

• New: Added an ability to vsync the editor. This is disabled by default. Set "r.VSyncEditor" to 1 to enable it.

• New: Added an option in the FBX importer to automatically convert the unit in the FBX file to Unreal Units.

• New: Added asset cooking path length in their tooltips so that you can detect cooking path issue before you are cooking.

• New Added checkbox for "Show All Advanced Details" config variable so that it will auto-expand all advanced property categories.

• New added command line option to enable movie capture burnin.Use the commandline -UseBurnIn=yes.

• New Added mesh simplification plugin picker to the Project Setting under Editor > Mesh Simplification. The menu to pick simplification plugins also contains a link to find other plugins in the Epic Games Launcher Marketplace.

• New: Added metadata to remove "reset to default" button for certain properties.

• New: added new shortcut "Ctrl + Shift + B" to build current level geometry.

• New Added the ability to import grayscale Targa (.tga) files in the editor.

• New Added the ability to search through all Editor Preferences and Project Settings at once. Use the selection in these windows at the top for "All Settings."

• New: Added the possibility to preview a wave sound in the Content Browser from the thumbnail.

• New: Added Undo/Redo functionality to the Editor Preferences and Project Settings windows.

• New: Changed and unified saved shortcuts across all editors.

  • Save As is now Ctrl + Alt + S.

  • Save All is now Ctrl + Shift + S.

  • Save Current is now Ctrl + S.

• New: Added shortcut Ctrl+Shift+Space to quickly rotate through different viewports (left, up, front, back ,etc).

• New: Changed the FBX batch import workflow to let the user fix all missing source files before starting the FBX batch import process.

• New: The Content Browser now supports hiding/toggling specific asset detail columns.

• New: Added the ability for Ctrl + Middle Mouse drag will give options to switch to different viewports.

  • Drag to Left, Right, Up, and Down will match the viewport intuitively.

  • Drag to Up-Left is Front, Up-Right is Back, Bottom-Left and Bottom-Right are both for the Perspective viewports.

  • Dragging exceeding a certain distance will jump to that viewport directly whereas dragging a little will bring up a popup menu showing which viewport it's going to switch to.

• New: Added a new view option for "Show C++ Classes" in the Content Browser to enable you to hide the C++ classes you may not want to see.

• New: The Engine version including branch name will now be displayed in the Title bar by default.

• New: Extended "Select all input nodes" function to general Blueprint editor.

• New: FBX Exporter now exports all LODs.

• New: The Date Time fields in the editor are now displayed and entered in the local user's timezone.

  • The time entered is saved into assets using the value converted in the UTC timezone.

  • The timezone that is used is configurable in the Editor Settings under Region & Language for Internationalization settings.

• New: There's now support for generating a "Content-Only" plugin from the new Plugin Wizard.

• New: Added Show Flags for Widget Components.

• New: Reference viewer now provides options to show/hide soft and hard references and dependencies with different line color.

• New: Added Asset Picker support to the Script Interface properties.

• New: Added unique asset icons for Sound Concurrency assets.

• New: The Widget Reflector now has a configurable delay between clicking to take a snapshot and taking the snapshot, which is helpful for reflecting widgets in a state that involves the cursor or other timing factors.

• New: Added the ability for users to specify a Base material to create Material Instances instead of just creating materials when importing an FBX.

• New: Added project file to source control when creating a new project.

• Bugfix: Fixed a crash when moving Instanced Static Mesh Component in editor when it had no mesh set, but had instances.

• Bugfix: Fixed a crash on undoing a deletion of a mesh in mesh painting mode in the VR Editor.

• Bugfix: Fixed an occasional crash on editor shutdown due to a race condition in FTcpMessageTransportConnection.

• Bugfix: Fixed several crashes in the Session Frontend when viewing profiles.

• Bugfix: Fixed a crash issue where making changes to components in the Blueprint editor when there is an active component in the component visualizer.

• Bugfix: Fixed an issue where batching optimization for dragging components onto Blueprints. Adding thousands of static mesh components now takes seconds instead of up to an hour.

• Bugfix: Fixed an issue so that comments will now be preserved on "Parameter" nodes when converting them to "Constant" nodes within the Material Editor.

• Bugfix: Fixed an issue that prevented a material from being saved when copying a comment node from a Material Function to a Material.

• Bugfix: Fixed an issue so that the Crash Report Client can now correctly restart Editor sessions that were run from the Launcher.

• Bugfix: Fixed an issue where the cursor would remain hidden after left-clicking in the Orthographic view.

• Bugfix: Fixed an issue that would cause Custom keyboard shortcuts to no longer switch between the Command and Control keys on Mac when the editor was restarted.

• Bugfix: Fixed an issue so that debug lines will now render correctly in orthographic views if their thickness has been specified.

• Bugfix: Fixed an issue where FBX and OBJ files containing a UV channel with no name were not imported correctly into the editor.

• Bugfix: Fixed an issue so that the FBX importer will correctly re-import a mesh when the combined mesh checkbox was set to true.

• Bugfix: Fixed an issue with "On Mouse Button Up" not resetting SButton's Brush state from "Pressed" to "Hovered."

• Bugfix: Fixed some issues with the LODGroup workflow:

  • During FBX Import, LODs are now recomputed with the correct settings.

  • In the Static Mesh editor, Extra LODs are removed when changing the LODGroup.

• Bugfix: Fixed various crashes when manipulating BSP geometry in the editor.

• Bugfix: Fixed a crash while importing FBX scenes if objects contain procedural textures, which is not supported.

• Bugfix: Fixed a crash when setting a closed loop on a Spline component which has no spline points defined.

• Bugfix: Fixed an issue where the dialogue "Actors are referenced, are you sure you want to delete?" from appearing when you are copying a lot of actors to another level.

• Bugfix: Fixed a warning that would spam the log when opening the Editor's Blueprint menu.

• Bugfix: Fixed an issue where an actor deletion while in Mesh Paint mode would not be undoable.

• Bugfix: Fixed an issue where all collision would be disabled if you don't auto-generate a simple hull when importing an FBX.

• Bugfix: Fixed an issue where importing a Texture asset while an editor window was open for that asset would cause the Details Panel to disappear.

• Bugfix: Fixed an issue where occasionally changing tabs in the Editor would cause the UI to freeze briefly and undock the selected tab.

• Bugfix: Fixed an issue where painting override vertex colors on a SpeedTree mesh would cause its wind animation to cease or look incorrect.

• Bugfix: Fixed an issue where structs containing enum values with whitespace characters would not correctly serialize when copied from the Details Panel.

• Bugfix: Fixed an issue where Unreal Frontend and other standalone tools would not display tooltips on dropdown menu items.

• Bugfix: Fixed an issue with assigning of materials on components would not work if you multi-select multiple components of a Blueprint and assign the Material.

• Bugfix: Fixed an issue when choosing "Yes to All" was not functioning properly when asked to delete many actors.

• Bugfix: Fixed an issue with in-game console command parameter display to include all parameters.

• Bugfix: Fixed an issue with loctext related warnings when opening the Blueprints submenus on the Level Editor toolbar.

• Bugfix: Fixed an issue with missing widgets when using Mobile Preview mode with a Mobile HDR disabled project.

• Bugfix: Fixed an issue with single player PIE so that the window position is correctly fetched and saved when running a dedicated server. This is held separately to stored positions for multiple client PIE.

• Bugfix: Fixed an issue in the output log filter not updating when text was committed.

• Bugfix: Fixed an issue where Mobile Packaging Wizard will not find any project maps if UE4 and the Project are installed on different drives.

• Device button text in "Device Output Log" window should be more readable now.

• Bugfix: Fixed an issue so that .exe icon is correctly set for packaged Windows games.

• Bugfix: Fixed an issue so that String Asset Reference properties will now only open an Asset picker (not an actor picker) as the goal is to reference an asset.

• Bugfix: Fixed an issue where "find culprit" dialog did not honor the user's choice.

• Bugfix: Fixed an issue with Unreal Game Sync where database events were being returned out of order could cause builds to show as never completing.

• Bugfix: Fixed an issue with Unreal Game Sync showing a build failure/warning dialog immediately if you submit while the build is yellow/red. This now ignores builds before your last submitted CL.

• Bugfix: "Play in Standalone Game" does not assume -window as a launch parameter therefore you can now specify -window or -fullscreen.

• "Select all input nodes" now have a corresponding "Select all output nodes" for nodes that are output nodes.

• Deleting many assets at once will now batch them as a single source control command instead of one for each asset.

• Directional Light icon in the viewport changed (the two arrows within the icon were removed), as the asset itself provide another arrow indicating the light direction.

• "HighResShot" console command now supports the same functionality as the Editor UI version and improved the help with usage examples.

• Improved editor hitching while using launch on by delaying package save until all data is cached.

• Minor update to the layout of the User Defined Struct editor.

• Improvements have been made to the Unreal Frontend Project Launcher Progress page:

  • The custom profile name is now visible above the progress bar when launching a profile.

  • The Task and Status views can now be resized.

  • Columns for "Errors" and "Warnings" have been added to the Task view to show which tasks have problems.

  • Previously completed tasks are no longer cleared when the launch is cancelled.

  • The message log will now only scroll to the newest message when the log is scrolled to the very bottom.

• Removed the Experimental "Live Editor" feature from UE4

  • Live Editor was an early attempt at automation of editor features using external hardware, such as MIDI.

  • This feature was never fully completed and we have no plans to continue work on it.

  • If you'd like to use MIDI devices in your editor plugins or games, please check out the new "MIDI Device" plugin available in this release!

• Unreal Game Sync: Improvements to "Clean Workspace" dialog.

  • Empty folders are now set to be deleted by default.

  • Added a context menu to select all/none/empty/default for a subtree, as well as to open Windows Explorer at that location.

• We now export the collision mesh when exporting to FBX. Disabled by default.

  • Added an Editor Preference option to enable or disable the export of collisions. Editor Preferences > General > FBX Export Collision Mesh.

• Focusing an Actor that has 0 size bounds now works.

• Play in editor will no longer auto resume a game on focus received if it was previously paused.

• Rebuild lightmaps commandlet now doesn't apply world transforms twice.

• Removed duplicate platforms from deploy list in Unreal Frontend.

• Scalability settings will no longer auto-apply if the low performance warning message is ignored.

• Source file paths are now normalized when caching their state.

• The Auto Distance Error value for Static Mesh LODs can now be set to a value smaller than 1.

• The Hue value displayed in tooltips for colors within the Theme bar will now match the hue value displayed for that color in the Color Picker.

• The orbit camera should no longer reverse zoom direction when zoomed with the mouse wheel.

• The performance when selecting thousands of actors has increased and should no longer render the editor unusable when lots of actors are selected.

• The pin-type filter now filters on both the localized and source type descriptions.

• The placement mode now filters on both the localized and source item descriptions.

• Undo/redo of mobility changes will also undo/redo the mobility changes on ancestors/descendants that were changed along with it.

• Visual logger icon updated.

• When importing a FBX file containing multiple animations, user can re-import any animation without overriding it with the first animation in the FBX file.

• Updated Map and Set Properties so they can now be edited from within the Details Panel. Sets ensure that all of its elements are unique, and Maps ensure that all of its keys are unique.

Content Browser

• New: Deleting folders in the Content Browser now removes the folder from disk.

• Bugfix: Fixed a crash renaming a collection with multiple collections selected.

• Bugfix: Fixed a crash when force deleting a blueprint with a child actor component from the Content Browser.

• Bugfix: Fixed an issue with dynamic collections not returning anything.

• Added ~ to the list of invalid characters for object/package names.

Landscape

• New: Added 180° rotation support to the Landscape Mirror tool.

• New: The Landscape LOD visualization mode now renders material tessellation while in the Viewport is in Wireframe mode.

• Bugfix: Fixed a crash entering Landscape mode when there is a Landscape in a sublevel that is loaded but hidden.

• Bugfix: Fixed a crash editing Landscapes with the "r.LightPropagationVolume" console variable enabled.

• Bugfix: Fixed a crash when applying a material with tessellation enabled to a landscape or when painting a material with tessellation on a newly added component.

• Bugfix: Fixed a crash when duplicating a level containing a Landscape through the Content Browser.

• Bugfix: Fixed a crash when loading duplicated Landscape levels.

• Bugfix: Fixed a crash when merging levels containing a Landscape.

• Bugfix: Fixed a crash with Landscapes caused by using undo after using the Move-To-Level tool and then selecting a Landscape Proxy in a sub-level.

• Bugfix: Fixed a crash if a Landscape Layer Info object is force deleted while it is in use.

• Bugfix: Fixed an inability to import Landscape Layer weight maps when creating a Landscape.

• Bugfix: Fixed an issue that would cause Landscape Components to be invisible when using tessellation on a Landscape.

• Bugfix: Fixed an issue with Landscape rendering errors after using the "Change Component Size" tool.

  • Also affects initial import of a Landscape with weight maps.

• Bugfix: Fixed a regression with performance when importing Landscape heightmaps.

• Bugfix: Fixed some small typos in the Landscape tutorial.

• Bugfix: Reduced material update log spam when creating and editing Landscapes. Some will remain since Landscape fundamentally manipulates a lot of material instances.

• Removed "Cmd: UpdateLandscapeSetup" log file spam during while editing World Settings on maps with landscape.

Material Editor

• New: Added the ability to clear the preview mesh on a material instance.

• New: Added the ability to highlight all nodes connected to an input.

• New: Added tooltips to the inputs of the Material Final Result node.

• Bugfix: Fixed a crash when loading cooked Materials in the editor.

• Bugfix: Fixed an issue where "Select all linked nodes" function would not show up in Material Editor for output nodes.

Matinee

• Bugfix: Fixed an issue with incorrect subtitle timing and rendering when scrubbing.

Persona

• New: Added better bulk import reporting so current progress through a bulk animation import can be seen, rather than only showing progress through the current animation.

• Bugfix: Fixed a crash when changing scene settings and hitting undo in Persona with complex cloth active.

• Bugfix: Fixed bounds calculations in Persona that include bones to respect LOD (and other required bones).

World Outliner

• New: Added the ability to collapse and expand folders in the World Outliner.

Static Mesh Editor

• New: Added Console Command "FORCELODGROUP" that will apply a Static Mesh LODGroup to selected groupless meshes in the editor. This can batch mesh-reduce (ie, Simplygon) all meshes in a level.

Source Control

• Bugfix: Fixed an issue where history and merging do not work if the user has "format.pretty" setting in their gitconfig.

• Silenced some redundant P4 errors that could be generated when running a "stat update" on a file. Some of the options produced errors when working with newly added files. These errors are now downgraded to infos like they are for the main stat command.

World Browser

• Bugfix: Fixed a crash on Changing sub-level visibility under certain conditions.

• Disabled use of World Composition with multiplayer PIE using separate process option, as it not properly supported now.

Foliage

• New: Added console variables to discard grass and/or scalable foliage data on load.

  • If set in the scalability settings, it reduces the memory requirements of the "off" setting at the expense of having to reload the level when changing the setting from "off" to a higher level.

• New: Implemented filter to enable painting foliage on other foliage (e.g. vines on trees).

• Bugfix: Fixed an issue where painting foliage on blocking "query" actors was not working. Actors which are not themselves moving only need to be set to "Query" to be blocking, but the foliage tool was checking for both "Query & Physics."

• Bugfix: Fixed an issue where disabling 'Use Landscape Lightmap' option was skewing Procedural Foliage Instances.

• Prevent landscape grass generated in the editor viewport from being duplicated for Play In Editor (PIE) sessions.

Cooker

• New: Added -mallocbinned commandline option to use it while cooking. Binned allocator is faster to cook in some cases.

• New: Added experimental Partial Garbage Collection feature for cooker. Added "-partialgc" commandline option for cooker. Instead of cleaning all packages when GC, this cleans up packages which will not be required for cooking later.

• New: Fixed an issue with deterministic cooking for bake distributions.

• New: Improved peak memory usage by the cooker by only resolving string asset references for the current package being saved.

• New: Now cooker processes async shader compilation while blocked doing other work. This gives a minor improvement in cook time.

• Bugfix: Fixed an issue for partial LOD level deterministic cooking issue. Spawn Module now has its postload called before being used.

• Cooker forces a shader compilation flush when it detects that it has passed the max memory budget. This helps to avoid out of memory problems when cooking large projects.

• "Directories To Always Stage As UFS" now filters .uasset and .umap files. Cooked assets will no longer be replaced by their uncooked version during staging UFS.

• Launch on in the editor will save required packages before cooking so that changes are correctly reflected.

Sequencer

• New: Added an option to map the transform motion of a Skeletal mesh to the root bone on FBX export. This option is in the General Settings in the Miscellaneous section.

• New: Added "Get Cine Camera Component" function from Cine Camera Actor.

• New: Added option to convert a spawnable track to a possessable track.

• New: Added option to create sub sequences for each master sequence shot.

• New: Added the ability to keyframe Geometry Cache Actor properties in order to use it in sequencer.

• New: Enable "Actor to Track" on the Cine Camera Actor as a keyable property.

• New: Enabled subtitles for audio tracks.

• New: Force the roll and yaw of the camera crane mount to be 0 so that the camera stays level to the ground. The yaw is controlled by the crane yaw control.

• New: Sequencer can now playback Anim Montages.

• New: Set Skeletal meshes to always tick pose and refresh bones when there's an Animation track in Sequencer.

• New: Tweaked default Sequencer colors.

  • Audio track is brighter.

  • Transform, bool, event tracks are less saturated.

  • Recording subsection is more saturated.

  • Fade track now shows a gradient.

• New: Added icons for Cine Camera, Camera Rig Rail, and Camera Rig Crane Actors.

• Bugfix: Fixed a crash when using sequence recorder with -game. Added GEditor check.

• Bugfix: Fixed an issue where it was impossible to animate a single component of a structure property while still enabling the original value for non-animated components to be set externally.

• Bugfix: Fixed an issue where the values in the key editors in Sequencer would become out of sync with the property values.

• Bugfix: Fixed an issue with the Fade track so that is only affects the current player and not all worlds.

• Bugfix: Fixed an issue with Game Mode Override option in movie capture so that it works when capturing the Editor.

• Bugfix: Fixed issues where properties were not getting bound when converting from Matinee to Level Sequence tracks.

• Bugfix: Fixed an issue with Anim Notifies not working when playing an Animation on Blueprint-driven Skeletal meshes.

• Bugfix: Fixed an issue with Anim Trails not playing in full with a Sequencer-driven animation.

• Bugfix: Fixed an issue with byte and integer properties not being able to be exposed to Cinematics on Blueprints.

• Bugfix: Fixed an issue where the cursor would jump around inconsistently when ending a drag.

• Changed curve editor visibility so that it's no longer a toggleable saved config.

  • It's now just a toggleable state because it was unexpected to have Sequencer restart with the curve editor visible.

• Changed FMovieScene3DTransformTrackInstance "Update" to properly update "Component Velocity."

• Disabled auto-possess player for recorded pawns.

  • This fixes a bug where if you record a Third Person Template character when you open the Sequence the recorded character will possess the viewport.

• Restore state when stopping the level sequence player so that objects controlled by Sequencer return to their positions.

• Spawnables now use deferred spawning.

VR Editor

• New: You can now instantly reset the world's scale to its default by tapping the touchpad button while gripping the world. This makes it easy to get back to your "Player's Size" while editing.

• New: You can now disable VR Editor Tutorial in Editor Preferences > Experimental > VR.

• Bugfix: Fixed an issue with blurry toolbar icon when "Use Small Toolbar Icons" was enabled in the Editor Preferences.

• Bugfix: Fixed various issues and regressions with Mesh Paint in VR:

  • Brush preview not being rendered for lasers/mouse when not actively painting.

  • "Full press" over actors that was preventing the UI from being clickable.

  • Brush cursor displayed when hovering over UI (including selection bar/close button).

  • VR transform gizmo getting in the way of everything while painting, it is now hidden while in Mesh Paint mode.

  • Not being able to fully interact with UIs after messing around with Mesh Paint

Gameplay Framework

• New: Added a cvar "t.FPSChart.OpenFolderOnDump" to control whether or not FPS charts automatically open the profiling folder when stopfpschart is executed.

  • This can be useful to avoid a bunch of open windows while doing automated testing.

• New: Added "Suppress Stacking Cues" flag to Gameplay Effect options to avoid sending a Gameplay Cue RPC for each instance of a stacking Gameplay Effect.

• New: Added "GameModeBase" and "GameStateBase" classes as parents of existing classes "GameMode" and "GameState." The core functionality needed by all games is in the Base classes, legacy and match-specific features are in the child classes.

  • Blueprint access has been added to Game State Base for "Has Begun Play", "Has Match Started", "Get Player Start Time", "Get Player Respawn Delay", "Game Mode Class", and "Spectator Class."

  • Game Mode Base "Must Spectate" and "On Change Name" are now called properly.

  • Added "Restart Player At Player Start" and "Restart PLayer At Transform" to manually control of where player pawns are spawned.

  • Updated the GameMode documentation to reflect these changes and add extra context.

• New: Added access to both the game's "Unpaused Time Seconds" and "Time Seconds" from Blueprints.

• New: Added the ability to set the mouse position from Blueprints via the Player Controller.

• New: Components can now specify whether they replicate from the Blueprint Property editor.

• New: Components that are referenced by an "Edit Anywhere" property but are not created as part of object construction can now be edited via the in-world component editing panel.

• New: Cull Distance Volumes no longer globally update on every Actor property change. This should reduce hitches after changing properties entirely unrelated to cull distance in levels with large Actor counts.

• New: More Cheat Manager functions have been made available to call and to override from Blueprints.

• New: Added "Use Client Side Level Streaming" property added to World Settings.

  • When enabled, the server doesn't evaluate streaming volumes. Instead, each client independently decides what volumes to stream in/out, depending on its players' cameras.

• New: Particle System and Audio Components now route "Activate" and "Deactivate" events to Blueprints.

• The "Delta Seconds" passed to Tick functions when using a "Tick Interval" will now represent the amount of world time that has passed since the last tick of the function.

• The levels of a world are now categorized into different collections: dynamic, static, or duplicated. Levels default to dynamic, and this preserves existing behavior.

  • Streaming levels can be marked as static in the Levels Details panel. This distinction has no effect on how the levels are rendered, but it will cause the levels to be placed into the corresponding collection.

  • Games may opt-in to duplicating the dynamic levels when the world is loaded, and they will be maintained separately from the original levels. The game may use these duplicated levels at runtime, if desired.

• New: The logic for selecting which Game Mode to spawn for a URL can now be overridden in "Game Instance", implemented in "Preload Content For URL", "Create Game Mode For URL", and "Override Game Mode" Class.

  • The rules for selecting GameMode based on map prefix or alias is now modifiable in the Project Settings > Maps and Modes under the advanced options.

• Bugfix: Fixed a crash undoing "replace actor with" when replaced object constructs child actors.

• Bugfix: Fixed an issue where after duplicating a level you would have two instances of a Child Actor.

• Bugfix: Fixed an issue where Child Actors would sometimes be created at the wrong location.

• Bugfix: Client-side only components attached to a replicated component will no longer be removed from the "Attach Children" array when a change to attachment is made on the server.

• Bugfix: Fixed a check in Character Movement's "Step Up" to properly account for distance the component is above the floor.

• Bugfix: Fixed an out of date with Radial Force Component's "Collision Object Query Params" by adding a "Begin Play" event callback.

• Bugfix: Fixed an issue with Gameplay Statistic's "Spawn Emitter Attached" using wrong scale when "Snap To Target (Keep World Scale)" option is used. It was being used as a relative scale. Also, improved the comments for "Spawn Emitter Attached."

• Bugfix: Fixed an issue with bounds calculations for local camera animations.

  • Correctly calculated bounds as local to the initial transform in the track.

• Bugfix: Fixed issues with "Can Jump" inconsistencies with previous versions.

• Bugfix: Fixed a crash during garbage collection after deleting Audio Volume.

• Bugfix: Fixed a crash in GetPredictionData_Server() when a player is destroyed and the server Player Controller checks to see if it needs to force a network update. This, also, fixes similar crashes when calling a Character's "Set Replicate Movement" when not on the server.

• Bugfix: Fixed an error icon indicating lighting issues not going away after resolving the issue on a light that was created by copy/pasting a light that had a lighting issue.

• Bugfix: Fixed some typos in "Only Trace While Ascending" and "Deproject Screen To World."

• Bugfix: Fixed UK2Node_GetInputAxisValue using default flag for "Override Parent" value on the created binding, causing previous bindings to be squashed.

• Bugfix: Fixed an issue with network replication for actors in "Always Loaded" sub-levels not working after seamless travel.

• Bugfix: Fixed an issue with FPreviewScene-based worlds so that they now render correctly in-game.

  • Added new "Editor Preview" and "Game Preview" world types and deprecated old "Preview" world type.

• Bugfix: Fixed an issue to prevent Camera Anims without a "Field of View" track from making any modifications to the camera's FOV.

• Bugfix: Fixed "Set Game Paused" now correctly returns whether the paused state was changed when setting it to false.

• Component "Activate" functions now fire for "auto-activate" components if the component belongs to an actor placed in a level.

• Component's are now correctly removed from their World's needs end of frame update list. This fixes a rare crash when a component is moved between worlds as part of seamless travel.

• Consolidated rotation settings (Rotation Rate, Use Controller Desired Rotation flag, Orient Rotation To Movement flag) in a new "Rotation Settings" category. The Character Movement Component's flag for "Use Controller Desired Rotation is no longer an advanced property. This makes it more easily discoverable.

• Direct access to Static Mesh in "Static Mesh Component" has been deprecated. Please use "Get Static Mesh" and "Set Static Mesh" accessors.

• Disabled some NaN checks in shipping builds.

• Improved logic for when the transform of a static scene component can be modified.

• Load game from slot will no longer sometimes fail if using a Blueprint defined class.

• Mouse smoothing is now based on the application frame time rather than the dilated world time.

• Native classes will now properly run construction script on PostEditMove.

• Native Components created by "Create Default Subobject" that have been removed will no longer still exist in existing instances of that class.

• Scene Component Attach Children will no longer periodically get duplicate entries on the client for some replicated components.

• The FOV is now reset on the Player Camera Manager's Camera Actor when it's initialized.

  • This fixes cases of stale FOV values after playing Camera Anims that don't end with the FOV at its base value.

  • Base FOV can now be edited in the Camera Anim properties. This enables you to specify what the FOV keys are relative to. Previously it was always using a base FOV of 90 degrees.

• The position of the (null) bounding volume of an empty Text Render component is now correct.

• Wind source components now correctly "Activate" and "Deactivate."

Localization

• New: Added a way to mark text in text properties as culture invariant.

  • This enables you to flag properties containing text that doesn't need to be gathered.

• New: Added "As Time", "As Date Time", and "As Date" overrides to Blueprints to let you format a UTC time in a given timezone. This defaults to your local timezone. Previously you could only format times using the "invariant" timezone, which assumed that the time was already specified in the correct timezone for display.

• New: FText properties/pins will now preserve their existing identity (namespace + key) where possible when changing the source text.

• New: Translations are now exported/imported per-identity rather than collapsing identical strings within the same namespace.

  • This enables translators to translate each instance of a piece of text based upon its context, rather than requiring a content producer to go back and give the entry a unique namespace.

  • It also enables us to optionally compile out-of-date translations, as they are now mapped to their source identity (namespace + key) rather than their source text.

  • This change also adds FLocTextHelper as a high-level API for dealing with uncompiled localized text. This should be preferred for all new code rather than dealing with manifests/archives directly.

• Bugfix: Fixed a crash when dealing with code-points outside the basic multilingual plane on platforms with UTF-32 FStrings.

• Bugfix: Fixed a crash that could occur in the source code gatherer where it would sometimes underflow an array.

• Bugfix: Fixed an issue where localized assets were not working with "Launch On" in the editor.

• Bugfix: Fixed an issue where the PO exporter writing out invalid escape sequences.

• FText can now format pre-Gregorian dates correctly.

• Removed validity check on source cultures when remapping, as platforms may use invalid cultures that need to be remapped.

• The internationalization system now correctly detects whether the local machine is in a timezone with daylight savings active

• We now favor Traditional Chinese for Hong Kong and Macau.

Networking

• New: World Origin rebasing has been added as an experimental feature!

  • This means that the World Origin can be different on both the client and the server.

  • This feature will continue to be improved over the next releases.

• Bugfix: Fixed a crash that could occur with FCurlHttpRequest's "Debug Callback".

• Bugfix: Fixed an assert that could occur when playing back a replay that was recorded on a client that uses torn-off actors.

• Bugfix: Fixed an assert in channel cleanup code that could occur if the connection was cleaned up and there were "Keep Processing Actor Channel Bunches Map" in-flight still.

• Bugfix: Fixed an issue where gameplay tags will work better with backwards compatibility in replays.

• Bugfix: Fixed various issues with remapping objects that lose/gain relevancy.

• Bugfix: Fixed an issue with replays that could cause scrubbing to a specific time to go to the wrong time.

• Bugfix: Fixed an issue that could cause memory-constrained platforms (such as consoles) to run out of memory when scrubbing in replays in rapid succession.

• Bugfix: Fixed an issue where replicated references that would remain null indefinitely due to becoming non relevant, and then becoming relevant again

• Disable hot reloading when using single process MP PIE. This fixes some conflicts that can otherwise occur.

• Don't strip map/package name from commandline on shipping config on dedicated server in the Game Instance's "Start Game Instance". Don't ever parse "-replay" on dedicated servers. This enables specifying map name on servers via commandline.

• We no longer record dormant actors in replays for better performance

Physics

• New: Added "Simple Wheeled Vehicle Movement" Component which allows for n wheels with no motor simulation.

  • Exposed "Wheeled Vehicle Movement Component 4W" so that it can be added to any Blueprint.

• New: Added "Get Bone Mass" and "Get Skeletal Center Of Mass" functions for Skeletal meshes.

• New: Added more vehicle stats for the profiler.

• New: BSP now supports returning texture coordinates from line traces.

• New: Exposed "Grab Rotation" for physics handle component. Also introduce hard vs soft physics handle.

• New: Exposed the ability to separate reverse and brake on vehicles.

• New: Improved cook times for "Procedural Mesh" Component collision. Fixed issue where "Update Mesh Section" on Procedural Mesh may update wrong collision verts due to mesh being cleaned in cooking.

• New: Improved warning when trying to create a constraint between different scenes.

• New: Improvements to data caching for Destructible meshes on save. This gives an 8x-10x improvement in load times for more complex meshes.

• Bugfix: Fixed a crash when a physical animation component's mesh is changed out from under it.

• Bugfix: Fixed an issue in PhAT so that multiple constraints can be selected and edited properly at the same time.

• Bugfix: Fixed an issue where constraint component not using root body when no bone name is provided.

• Bugfix: Fixed an issue where the constraint index was not being assigned correctly. Also, exposed "Find Constraint Bone Name" to Blueprints.

• Bugfix: Fixed an issue with FConstraintingBaseParam's "Contact Distance" clamping.

• Bugfix: Fixed an issue with PhAT "Snap Constraint To Bone."

• Bugfix: Fixed an issue with physics handle component not accounting for bone rotation/offset.

• Bugfix: Fixed an issue with "Set Root Body Index" so that it uses world space transform instead of reference skeleton.

  • Fixes a few issues when using ragdolls on Skeletal mesh assets that were imported with offset/rotation.

  • Also, fixes a crash when opening up old physics asset and changing its mesh.

• Bugfix: Fixed an issue with vehicle suspension force offset to work from the spring location (in the z-axis) instead of the vehicle COM.

• Bugfix: Fixed a crash caused by changing the collision response parameters of a Destructible mesh after it had been fractured.

• Bugfix: Fixed a crash spawning complex Destructible meshes in multiplayer games.

• Bugfix: Fixed a crash when creating a Destructible mesh from a static mesh that uses SpeedTree materials.

  • Added a warning message when attempting to do so now.

• Bugfix: Fixed an issue with APEX Cloth disappearing if an actor containing a component with clothing had its custom time dilation set to 0.0.

• Bugfix: Fixed an issue with box collision shapes not scaling correctly after using Merge Actor tool.

• Bugfix: Fixed an issue with Destructible asset importing failing if one of the submeshes in the asset file had no geometry.

• Bugfix: Fixed incorrect tooltips for collision channels.

• Bugfix: Fixed an issue with line traces against a component not returning face index, where appropriate.

• Bugfix: Fixed an issue with line traces against a specific component not returning closest hit in triangle mesh case.

• Bugfix: Fixed an issue where mesh corruption in clothing assets would happen when importing a new mesh that requires a uint32 index buffer over a clothing asset that previously required uint16 indices.

• Bugfix: Fixed an issue where scales like (1,0,1) not being clamped to something valid in physics code.

• Bugfix: Fixed an issue where "Support UV From Hit Results" not informing user an editor restart is required.

• Altered Skeletal mesh bounds calculations to ignore clothing actors if they aren't simulating on the currently active LOD.

• Changed some exposed properties on Destructible meshes to be hidden as they are only supported for non-Destructible Skeletal meshes. This addresses an issue where Physics Shadow Assets were properties were visible.

• Enforced block size of 16K for PhysX scratch memory when simulating.

• Ensure that physics handle automatically wakes up any object it's grabbing on release.

• Improved comments for Hit callbacks.

Platforms

• New: Add HarfBuzz support for proper text shaping in languages the require it such as Arabic.

• New: Add support to Windows and Linux for swapping allocators with -ansimalloc, -binnedmalloc, and -binnedmalloc2 to enable easy comparison at runtime.

• New: Added "Is Gamepad Attached" to Android so users can determine when a gamepad is attached to the device.

• New: Added support for Android local notifications using the existing local notification Blueprint mechanisms. Using these Blueprint nodes will work on both Android and iOS now.

• New: Added support for making the game window borderless (no system border or title bar) on desktop platforms. Disabled by default.

  • Enabling requires adding "UseBorderlessWindow=True" to [/Script/EngineSettings.GeneralProjectSettings] in DefaultGame.ini.

  • The game using this is responsible for adding a "Window Title Bar Area" widget to its UI, as well as window minimize/maximize/close buttons.

• New: Adding interstitial ad support for Android using AdMob, including Blueprint functions.

  • Four functions have been added: "Load Interstitial Ad", "Is Interstitial Ad Available", "Is Interstitial Ad Requested", and "Show Interstitial Ad."

• New: AndroidManifest.xml will now include the texture format used in packaging. The appropriate "supports-gl-texture" tags will be added for the texture format chosen at packaging.

• New: Engine will select the first shader platform in [/Script/WindowsTargetPlatform.WindowsTargetSettings] as the current RHI.

• New: Support Metal shader compiling when cross compiling on Windows.

  • This must be enabled in the IOS Build Settings page since it can significantly increase build time.

• New: Enable the ability to change ports for a firewall to pass them through rsync. This addresses UE-24679.

• New: Upgrade emsdk toolchain to 1.36.11 - emscripten.

• New: When launching the app on iOS within the editor, the device console logs are piped into the Editor's Console Log window.

• Bugfix: Fixed an issue with cooking for compressed content where the bit window used for compression was consumed by the wrong parameter.

• Bugfix: Fixed a couple of problems with Mac app bundles modifying their content that made them incompatible with the Mac App Store.

• Bugfix: Fixed an issue that was causing Sound Mixes to not properly finish at the end of certain sound effects when played on a device. Now, their behavior now matches PIE.

• Bugfix: Fixed an issue that was causing the module Android_ASTCTargetPlatform to fail to load on Mac.

• Bugfix: Fixed an issue where setting a new Touch Interface to none would cause any input present on the Virtual Joysticks to continue on indefinitely. Input now clears before setting a new Touch Interface.

• Bugfix: Fixed an issue where shader compression used the cooking host platform instead of the target platform when selecting shader compression settings.

• Bugfix: Fixed a race condition in threading code that affected pthread-based platforms, such as Linux, Mac, Android, iOS, etc. Threads are now properly joined instead of busy waiting.

• Bugfix: Fixed an issue where iOS Movie Player can't handle videos at resolutions that aren't multiple of 16. Now an assert is thrown when attempting to play a non-power of 16 resolution.

• Bugfix: Fixed an issue where occasionally a movie isn't played on iOS.

• Give a more friendly error message when UHT fails with an invalid error code. This will help when trying to build without the prerequisites installed.

• Make the "Running on " Toast stay active when launching a game to an Android device until the game has finished running on the device. Previously the toast was closing prematurely.

• Pass down any extras used to launch SplashActivity to GameActivity. This enables code that relies on intent data (such as GCM) to function as expected. The GameActivity will receive the info and not just SplashActivity.

• The cooking process now respects the per-platform chunking manifest configuration in the game ini. If you specify -manifests it forces all platforms to generate a manifest.

• Improved the error message that displays as Unknown Error when failing to supply a Remove Build server for iOS on Windows.

• Changed the "OOM Backup Memory Pool" to enable each platform to set how much memory to allocate. See the "Get Back Memory Pool Size" function in "Platform Memory." Defaults to 0, which was the previous behavior with the now removed "Support Backup Memory Pool" function in "Platform Memory," which was only true in Windows and PS4.

Android

• New: Updated libpng to 1.5.27 for Android to fix Google security notifications

• New: Updated to CodeWorks for Android 1R5.

• New: Enabled Windows types in vulkan.h from later SDKs.

• New: ES 3.1 detection now handles 3.2 in the version string from newer devices.

• Bugfix: Fixed a crash that would occur on Kindle Fire when trying to load a project that had enabled the Oculus plugins.

• Bugfix: Fixed a crash on devices, such as Huawei Honor G750, which do not support the EXT_debug_lable and EXT_debug_marker extensions.

• Bugfix: Fixed a crash that could occur when a Vulkan based project is resumed after losing focus.

• Bugfix: Fixed an issue where some Android apps would crash if the device orientation changed when the launch splash screen was active.

• Bugfix: Fixed an issue where OpenGL ES 3.1 detection was failing on devices which support OpenGL ES 3.2.

• Bugfix: Fixed an issue with out of spec GLSL operations.

• Bugfix: Fixed the Vulkan include path in the NDK check.

• Disabled Google Play Games for ARM64 because native library causes crash on launch.

• Hiding the virtual keyboard on Android properly closes input dialog.

• Only use alternative event flow for Daydream packaged applications.

• Pass through the intent action from Splash Activity to Game Activity.

• We now properly handle seeking in Android Media Player, which did not work past 999ms before.

• Read Android environment variables from .bashrc on Linux.

• Restore texture filtering mode properly when movie played on Android.

• Update cached length when file is written to on Android.

• Use .sh extension for Android install scripts on Linux.

iOS

• Bugfix: Fixed a crash with reflection capturing in Metal.

• Bugfix: Fixed an issue with Metal Dynamic RHI's "RHIReadSurfaceData" for shared textures on iOS.

• No longer allow ES2 shaders to be compiled for tvOS.

• Worked around some bad Xcode headers to enable compiling with Xcode8 / iOS10.

Linux

• New: Updated installation scripts to run on Ubuntu 16.10.

• New: Added "offscreen" video driver to SDL so the engine can now create GL context on headless machines not running any display servers (EGL is enough).

• New: Added support for creating Linux installed builds.

• New: Bundled libc++ with the engine to guard against STL incompatibility problems.

  • Third party code that uses STL needs to to compiled against the bundled library to benefit from this.

• New: Bundled SDL updated to trunk as of late September 2016.

• New: Choose OpenGL version based on the first targeted RHI, which enables setting the version through the .ini.

• New: Crash error message will print more details about erroneous memory access on Linux.

• New: Last page of the signal handler alt stack is made read-only to guard against accidental smashing of it.

• New: Added precompiled WebRTC (xmpp) libs.

• New: Packaged non-code projects now include a 'bootstrap' shell script for convenience.

• New: The engine will profile and choose the fastest available clock source, which also, fixes running on Windows 10 Linux subsystem.

• New: Updated cross-toolchain to target CentOS7 and multiple architectures.

• New: Enabled use of xgConsole in Unreal Automation Tool.

• Bugfix: Fixed a crash when editing Widget Blueprints.

• Bugfix: Fixed an issue with client and server hanging when decoding voice chat.

• Bugfix: Fixed an issue with compilation of ARM (32-bit) server builds.

• Bugfix: Fixed an issue with copy/paste failing on Linux when the clipboard was empty.

• Bugfix: Fixed an issue with the heartbeat thread not being stopped during handling of a crash.

• Bugfix: Fixed an issue with QtCreator and Makefile generators, which missed some include paths and had others duplicated.

• Bugfix: Fixed an issue with SDL EGL API binding.

• Bugfix: Fixed an issue with UBT hanging after Ctrl + C when mono thread creation fails.

• Bugfix: Fixed an unnecessary execution of some binding steps even when nothing has changed.

• Bugfix: Treat abort() / SIGABRT as a crash.

  • This fixes some abnormal exits not being reported.

• Disabled rebuilding hlslcc during installation given that it is now built against the bundled C++ library and will always match the engine.

• Equals character is now enabled as part of commandline parameter value.

• Minor robustness improvement in Linux crash handler.

• More robust check of installed packages on Ubuntu in installation scripts.

• Reduce amount of logging when launching externals procs.

• ShaderCompileWorker will be told to dump core on crash in Debug editor builds to aid debugging.

• Startup time of modular builds (e.g. editor) are 10x faster due to exclusion of unnecessary symbols.

Mac

• New: OpenGL support is now deprecated and Metal SM4 was replaced by SM5 in 4.13.

  • We no longer compile OpenGL and Metal SM4 shaders by default to save cook time and decrease cooked data size.

  • Running under OpenGL will now display a dialog warning that Mac OpenGL is no longer supported and may not run correctly.

• New: Added a commandline switch for Mac "-RedirectNSLog" that will capture the output of NSLog using an NSPipe and write it into our log instead when not running under the debugger.

  • This will capture the output from underlying libraries that would otherwise be lost when outside a debugger.

• New: Added a cvar named "r.Mac.OpenGLDisabled" to disable OpenGL support on Mac.

  • If a Mac that does not support Metal launches while this cvar is set to 1 then they will get a dialog box describing that they do not support Metal and the process will close.

• New: Added more statistics for Metal to track how many textures are allocated a frame and how much buffer memory is allocated per frame.

• New: Added support for compiling Vulkan shaders for Android on Mac.

• New: Added optional cache inside Metal RHI for disposed texture objects so we may reuse them. This is controlled by the console variable "rhi.Metal.TextureCacheMode".

  • 0 = off.

  • 1 (default) = will attempt to reuse private memory texture objects within the frame they are released otherwise they are disposed of as before.

  • 2 = extends the caching to all textures - though Managed/Shared textures cannot be reused until after the frame in which they were released has been processed on the GPU. In this mode id objects are never returned to the OS so in order to conserve VRAM calls to setPurgeableState are made to enable the driver to reclaim unused memory if required.

  • This setting can't be changed at runtime.

• New: On MacOS, tvOS and iOS, the RHI and shader platform initialised on startup will now be decided by the options specified in the project's target settings rather than assumed in code.

  • When the initial selection in the target settings is not available on the current device the code will gracefully fallback, if possible or alert the user if not.

  • On Mac: Order of initialisation is the order listed in TargetedRHIs specification.

  • On iOS/tvOS: Order is explicit: Metal MRT > Metal ES 3.1 > OpenGL ES 2.

• Bugfix: Fixed a crash under the validation layer and Nvidia's El Capitan (10.11) drivers when Distance Field Particle Collisions are used without any scene Distance Fields available. We now bind the black volume texture when that is the case to avoid bad access on the GPU.

• Bugfix: Fixed a crash caused by trying to restore Help menu item on Mac if MenuBlock didn't contain it.

• Bugfix: Fixed a crash caused by Metal context releasing its contents in some cases on MacOS 10.12.1.

• Bugfix: Fixed a crash in CoreAudio on unpause.

• Bugfix: Fixed a crash in the editor on displaying a new window on MacOS 10.12+.

• Bugfix: Fixed an issue to always bind buffers to all particle shader inputs to avoid a validation error in Metal.

• Bugfix: Fixed an issue with AV Foundation video playback causing validation errors in Apple's debug tools, as the textures that it returns to us can't be used as render-targets and are stored in CPU-accessible memory.

• Bugfix: Fixed an issue with AVFMedia plugin failing when a movie has captions.

• Bugfix: Fixed an issue in MetalRHI that caused the first render query result to return the wrong result, which manifested as paused particle animations.

• Bugfix: Fixed a focus problem in the asset picker that forced users to click on the search text field to be able to type.

• Bugfix: Fixed an issue with game window not rendering its contents in some cases on macOS 10.12.1.

• Bugfix: Fixed an issue with HLSL->Metal conversion for calls to asuint/asfloat where the input type matches the output type.

• Bugfix: Fixed an issue MetalRHI's handling of calling "Set Render Targets Info" without any render targets.

• Bugfix: Fixed an issue with TBasePassVertexShaderPolicyParamType not setting values for all shader parameters that would then cause an error in Metal's validation layer.

• Bugfix: Fixed an issue for Metal shader translation retain more precision for float constants -1.0f >< 1.0f by emitting them in scientific notation.

  • This prevents Hammersley constant amongst others from being flushed to 0.

• Bugfix: Fixed an issue with FMac Metal not natively supporting PF_G8 + sRGB as Apple claims that not all Mac GPUs have single-channel sRGB formats.

• Changed the ShaderCache not to cache resource bindings in the draw states for shader platforms that don't use them.

• Disabled the lazy-encoder construction in Metal for AMD. There is a situation that causes the lazy construction to perform a clear that isn't wanted.

• Enabled more concurrent ShaderCompileWorker instances on Mac now that they don't consume such excessive amounts of memory.

• Ensure that command-buffer failure in Metal is always fatal as there is no way to recover and make the default number of command-buffers sufficiently large to handle texture streaming in Mac games.

• Rework Metal's handling of RHI Set Stream Source calls that override the stride of vertex declarations to be much more efficient.

• Update the GPU identification code in Metal to handle changes made in macOS Sierra.

• Use a read/write mutex to protect access to Metal's internal shader pipeline caches so that parallel threads can progress in the common case where new shaders are not being compiled.

• Use Metal's internal setBytes API to upload buffer data that is less than a single CPU page as this is much faster and avoids fragmenting Metal's internal heaps. On Nvidia GPUs this is always used but for iOS versions without the feature or Macs running El Capitan on Intel GPUs an extra ring-buffer is used instead.

• Use private memory for the Metal stencil SRV workaround needed on OS X El Capitan for a small performance improvement.

PlayStation 4

• New: Added a PS4 Device Profile when connected to a 4K TV.

• New: "Get Num Of Tracking Sensors" and "Get Tracking Sensor Properties" are now supported by PSVR. This will return the properties for the PS4 tracking camera.

• New: When a game supporting PlayStation Pro is connected to a 4K TV, the game may choose to automatically create 4K backbuffers or to continue with 1080p backbuffers.

  • This choice should be made on a per-game basis taking memory cost and performance into account.

  • Use "r.PS4Allow4kOutput" to enable. Disabled by default.

• Bugfix: Fixed a crash that could occur with audio threading when the Kernel took over core 7 and starved the audio thread.

• Bugfix: Fixed a possible GPU hang on PS4 when using DrawIndirect or DispatchIndirect. This hang could be seen in projects using DistanceField AO or DistanceField Shadowing.

• Bugfix: Fixed an issue with render target alignment bugs on PS4 Pro.

• Bugfix: Fixed some audio drops on PS4 media playback.

• PS4 Time's "SystemTime" now returns local machine time instead of UTC.

• Stopped PS4 from always staging all ICU data files.

• Upgradeable apps will now have the app_type field in Sony Project Files (.gp4) generated with the spelling 'upgradable' which is consistent with what Sony expects.

• Removed the mapping for the Play controller's "Select" button, as it is reserved by the system.

Xbox One

• New: The default Xbox One XDK is now August 2016 QFE 2.

• New: Added support for multiple binaries in Xbox One deployments. Removed the need for binary renaming during deploy.

• New: Added support for using the virtual keyboard on Xbox One.

• New: D3D12 Movie player updated to a fast SIMD implementation. This will be replaced in a future SDK when the hardware decoder is supported.

• New: Improved Xbox One deployment performance and iteration times.

  • Fixed an issue where staging could be performed twice per build from Visual Studio.

  • Ensured files that have not changed are not recopied for staging or deployment.

  • Modified manifest generation to avoid writing a new manifest if the contents are unchanged.

• New: Refactored Xbox One controller handling to reduce Cross-OS calls to improve performance and to reduce memory usage.

• New: Support for the media foundation player added for Xbox One.

• New: Added better compression buffer sizing during pak creation, which will result in more files being compressed for use with hardware decompression.

• New: Added support for staging era.xvd from the XDK, which is required by newer XDKs for application launch.

• Bugfix: Fixed an assert when saving/loading games.

• Bugfix: Fixed an ESRAM memory leak caused by Volume Textures.

• Bugfix: Fixed an issue that would cause the leading character in complex AppxManifest settings to be ignored.

• Bugfix: Fixed an issue where the shift key on a physical keyboard connected to an Xbox One kit could be ignored.

• Bugfix: Fixed an issue with corrupted screenshots.

• Bugfix: Fixed an issue where DirectX 12 support was not being marked as experimental for the Xbox One.

• Bugfix: Fixed an issue with hardware compression and decompression to always fall back to the software implementation if the hardware implementation fails.

  • This could happen if data built before hardware compression support was added is decompressed through the hardware decompression path or if compression or decompression occurred before the RHI was initialized.

• Disabled engine analytics on Xbox One shipping games.

HTML5

• New: upgrade emsdk toolchain to 1.36.11

  • OSX binaries: clang.

  • Rebuilt ThirdPartySoftware libs for HTML5.

  • Windows binaries: clang.

Windows

• New: Add support for multitouch in Windows 7-10!

• New: When loading a UE4 module DLL, the engine now manually scans through project and plugin binaries and pre-loads dependent DLLs. This removes limitations caused by a maximum length of the PATH environment variable.

• Bugfix: Fixed an issue where maximized borderless game windows would render their contents offset by 8 pixels from the top and left sides.

All Mobile

• New: Provided access to project directory in UPL (Unreal Plugin Language) using $S(ProjectDir).

Programming

• New: Generated project files now include intellisense definitions and include paths for all UE4 modules, rather than just those in the standard UE4 editor target.

• New: Unreal Build Tool now supports the Intel C++ compiler on Windows.

• New: Added a -nolink command line option for Unreal Build Tool, which enables compiling a target without linking it. This is useful for automated build tests, such as non-unity compiles.

• Bugfix: Makefile is now invalidated if any generated headers are deleted that fixes an issue where files are moved from one module to another, and the original module no longer contains any generated headers; its include path needs to be removed from the compile environment.

• The Unreal Build Tool now deletes any DLLs in output folders which share names with build products. The Windows loader reads DLLs from the first location it finds a file with a matching name, so we need to ensure that it doesn't load stale DLLs when output directories are changed (moving a module into a plugin, for example).

• Updated the Unreal Build Tool so that programs can now be built as part of editor/client/server solution configurations.

• Updated UnrealVS so that open documents are now saved before running a single file compile.

• The GUBP build tools have been removed. Scripts to create binary UE4 distributions are now implemented in Build Graph.

Rendering

• New: Added a new "Cinematic" Scalability level to the scalability system.

  • This level is intended for offline rendering of cinematics only.

• New: The PS4 defrag pool size is now controlled by a new variable "r.PS4DefragPoolSize", and is not bound anymore to "r.Streaming.PoolSize." It will need to be configured to fit the project needs, in term of graphic resources.

• New: Added 1000 nit HDR output option.

• New: Added a cvar "r.DumpSCWQueuedJobs" to help tracking ShaderCompileWorker crashes.

• New: Added -emitdrawevents command line parameter to enable draw events from startup. This can be useful when capturing with third party graphics debuggers.

• New: Added material nodes "Atmospheric Fog Sun Direction" and "Atmospheric Fog Sun Color" so that materials can very easily get access to the direction and color of a directional light that has been marked as the atmospheric fog light. This can reduce the need to use MIDs or MPCs.

• New: Added per-material UV density data for Static Meshes and Skeletal Meshes to improve texture streaming metrics.

• New: Added Pre-Tonemapper HDR color to buffer visualization and frame capture.

• New: Added Project Setting to enable Skincache Shader Permutations

• New: Added shader resource compression. This will compress shader resources in memory. It is on by default for all platforms except for Xbox One.

• New: DirectX 12 RHI implementations for PC and Xbox One are now mostly merged.

  • Some platform specific implementations remain, but optimizations and fixes will now affect both platforms at the same time.

• New: Hierarchical LOD transition distances can now be adjusted based on Scalability settings. Use "r.HLOD.DistanceScale."

  • Defaults to 1, but higher values will make the transition happen farther away.

• New: Make shadow radius culling take field of view into account.

  • Note that this may affect shadow depth rendering performance positively or negatively, depending on the camera's FOV.

• New: New scalability setting "r.Streaming.LimitPoolSizeToVRAM" to limit the texture streaming pool to how much video memory is available.

  • Improved the behavior when using adaptative mip bias ("r.Streaming.UsePerTextureBias") so that the scalability bias is only used to generate over-budget warnings.

• New: New texture streaming build status available through "r.Streaming.CheckBuildStatus." This is used to warn the user when a texture streaming build is required.

• New: Particle cutout optimization no longer requires SubUV animation.

  • It is now on the "Required" module and there is now a Project Setting under Rendering > Optimization > Particle Cutouts by Default that will automatically set up the cutout optimization when materials change on an emitter.

• New: Console variable "r.SSR.MaxRoughness" can now be used in a Shipping build rather than as a development-only feature.

• New: Added support for "highresshot" on Vulkan.

• New: Texture streaming MipBias, from Scalability Settings, does not affect the wanted mips computation anymore, to prevent low texture quality on characters.

• New: The command "ListTextures" now outputs stats in terms of "in memory" and "on disk" to improve readability. Now, results are also more consistent between cooked builds and non cooked builds.

• New: Vulkan shaders are now using glslang from SDK 1.0.24.0.

• New: When running with the D3D11 RHI on Windows under RenderDoc, draw events are now enabled by default.

• New: When running with the OpenGL RHI on Windows under RenderDoc, draw events are now enabled by default.

• New: Added a fix for Vulkan drivers returning infinite number of swapchains.

• Bugfix: Fixed a crash exiting VR Preview when using OpenGL 4 on Windows.

• Bugfix: Fixed a crash when using High Quality Particle lights.

• Bugfix: Fixed a potential crash when painting in the Landscape editor.

• Bugfix: Fixed a crash when updating hierarchical instanced static meshes on the fly.

• Bugfix: Fixed a crash in Procedural Mesh slicing when no verts are generated.

• Bugfix: Fixed a crash when using tessellated materials with Blueprint "Draw Material To Render Target" nodes.

• Bugfix: Fixed a crash with Post Process Volume when using Planar Reflections with Instanced Stereo.

• Bugfix: Fixed an issue to always bind a value for "Is Stereo Parameter" in the Planar Reflection shader parameters to avoid an invalid GPU access on Metal in shaders that perform an if-test on this variable.

• Bugfix: Engine no longer attempts to release Static Mesh resources if the mesh was never rendered, and therefore never initialized the resources. This also fixes some incorrect stats related to static mesh memory usage.

• Bugfix: Fixed an issue for large spotlight culling issues.

• Bugfix: Fixed an issue for "Auto Compute LOD Distances" option in static mesh LOD settings. Previously the calculation was incorrect and would give somewhat arbitrary distances.

• Bugfix: Fixed an issue where Skylight Occlusion Tint would not properly apply the material's diffuse color.

• Bugfix: Fixed a fencing bug with the async compute translucency lighting volume clear. This could cause a flickering or a rare GPU hang on PS4.

• Bugfix: Fixed an issue with divide-by-zero in certain cases in the Motion Blur Post Process. This resulted in artifacts in certain cases.

• Bugfix: Fixed an issue with Foliage where lighting would always needs to be rebuilt.

• Bugfix: Fixed an issue where changing Detail Mode not propagating to components.

• Bugfix: Fixed an edge-case when replacing texture references in a material that caused sampler type updates to fail.

• Bugfix: Fixed an issue where gamma was being incorrectly applied to vertex colors of Procedural Meshes. Fixed Bounds Scale not being applied to Procedural Mesh Component.

• Bugfix: Fixed an issue with "Get Capsule Mesh" not working correctly when oriented.

• Bugfix: Fixed an issue with normals on cap section when slicing Procedural Mesh Components.

• Bugfix: Fixed an issue with possible low resolution textures when they were used within UMG.

• Bugfix: Fixed the Primitive filter in the Statistics window of the editor.

• Bugfix: Scaled instanced static meshes will now correctly compute world normals.

• Bugfix: For FRCPassPostProcessVelocityScatter use the Empty vertex declaration not the Filter vertex declaration as the vertex attributes aren't read in the shader, which fixed a Metal validation error.

• Removed the console variable "r.Vulkan.UseGLSL", now we use SPIR-V everywhere.

• Don't create material resources if we are in a build that can never render - Saves a few MB of memory

• Made shadow radius culling take field of view into account. Note that this may affect shadow depth rendering performance positively or negatively, depending on the camera's FOV.

• When using the GPU skin cache experimental feature, less shader permutations are now needed.

• On XboxOne, the Vertex and Index buffers are now allocated with the right nextwriteoffset to prevent stomping old data on future writes.

FX

• Bugfix: Fixed a rare crash in Particle Trail Emitter instances.

Lighting

• New: Added "Capsule Indirect Shadow Min Visibility" to Skeletal Meshes, so that artists have control over indirect Capsule Shadow darkness without changing cvars.

• New: Added flag for "Visible In Reflection Captures" to Primitive Component, which is useful for hiding objects too close to the capture point

• New: Added "Distance Field Bias" to Static Mesh Build Settings for mesh Distance Fields, which is useful for reducing self shadowing on meshes that have ambient animation.

• New: Changed the default Planar Reflection "Distance From Plane Fadeout End" from 600 to 100, which reduces artifacts and is a more intuitive initial setting.

• New: Clamp Indirect Lighting Quality to 1 in preview builds to keep previews useful even with Indirect Lighting Quality jacked up to 10.

• New: Distance Field Ambient Occlusion and Ray Traced Distance Field shadows are now enabled in High and Epic scalability settings by default.

• New: Planar Reflection Actor show flags can now be edited.

• New: Static light source shapes will no longer draw black in Reflection Captures. They will now fade out instead.

• New: Static lights with Min Roughness = 1.0 don't get their source shapes drawn into reflection captures, since they are being used as virtual area lights.

• Bugfix: Fixed an issue where lightmaps would not be applied because of how component transforms were computed.

• Bugfix: Fixed an issue with double lighting of clear coat, cloth, and eye shading models.

• Bugfix: Fixed an issue where the Global Distance Field was not dirtying previous object position on Update Transform. This left behind a phantom shadow on teleports.

• Bugfix: Fixed an issue with Instanced Static Meshes being unbuilt after a lighting build if you ever cancelled a previous lighting build.

• Bugfix: Fixed an issue with pre-shadow artifacts with multiple scenes, like the character receiving Stationary Light shadows from static environment.

• Bugfix: Fixed an issue with Ray Traced Distance Field Shadows on PS4.

• Bugfix: Fixed the "r.AllowStaticLighting" flag in the pixel inspector.

• Bugfix: Fixed an issue Screen Space Reflections disappearing when the camera direction is near perpendicular to the pixel's normal.

• Bugfix: Resolved HLOD self-shadowing interactions in Lightmass.

• Bugfix: Scene captures and Planar Reflections force a scene color alpha channel to be used when they are capturing. This fixes Planar Reflections with "r.SceneColorFormat=3", which happens due to scalability.

• Lighting channels can now be edited on components with static mobility, since dynamic lights can still affect them.

• Lightmass area shadows only mark texels as mapped inside the light's influence, which fixes multiple Stationary Lights with the flag "Use Area Shadows For Stationary Light" interfering.

• Now clamping light Min Roughness to .04 to avoid NaNs from Vis_SmithJointApprox on materials with Roughness 0

• Shortened lightmass export filenames to prevent path length issues.

Materials

• New: Added "pre-skinned local position" material graph node. Available in the vertex shader only but can be passed through Custom UV interpolators.

• New: Added new material functions to engine\content:

  • Interior Cubemaps: Maps specified cubemaps to a virtual box. Useful for displaying insides of buildings without using polygons.

  • Ray March Heightmap: Performs a ray march through a heightmap as if it were a volume. Enables more volumetric lighting for heightmaps and flipbooks.

  • High Pass Function: Performs a high pass operation on a specified Function. Requires multiple offset samples of the function to be hooked up.

  • High Pass Texture: Performs a high pass operation on a texture object.

  • Unsharp Mask Function: Performs an unsharp mask operation on a specified function. Requires multiple offset samples of the function to be hooked up.

  • Unsharp Mask Texture: Performs an unsharp mask operation on a texture object.

  • Box Intersection: Returns the ray entry and exit positions and distance traveled inside a box.Box is axis aligned. To support arbitrary rotations, transform the view ray into the local space of the new coordinates.

  • Cylinder Intersection: Returns the ray entry and exit positions and distance traveled inside a cylinder.

  • Quadratic Formula: A simple helper function providing pins to solve the quadratic formula, providing T0 and T1.

  • Smooth Ceil: Like regular ceil but with a variable soft ramp before each integer cutoff.

  • Axis Aligned Fresnel: Performs fresnel restricted to a single axis. This is useful to restrict a rim light to only the edges of an object, even at glancing angles.

• New: All noise material functions except "Fast Gradient Noise" now work on mobile.

• New: Noise material functions have been made a little faster (up to 1.7x) by changing the GPU random number generators used.

• New: Stereo planar reflection support.

• Bugfix: Fixed a case where material functions would incorrectly flag as a re-entrant expression.

• Bugfix: Fixed a case where material nodes containing a dot product or length calculation could optimize and ignore the actual vector sizes.

• Bugfix: Fixed a number of issues with subsurface profile shading model.

  • Emissive lighting was being applied twice when rendering checkerboard skin.

  • Emissive lighting was modulated by basecolor in the recombine when rendering checkerboard skin.

  • Metallic materials were contributing specular lighting to the diffuse channel when rendering checkerboard skin.

  • Optimization: Fall back to default lit lighting for pixels where the opacity is 0.

• Bugfix: Fixed an infinite loop crash when chaining multiple material attribute functions together.

• Bugfix: Fixed texture streaming for instanced components like foliage.

• Bugfix: Fixed world position in downsampled separate translucency.

• Bugfix: Fixed cases where chained calls to the same function will overwrite input connections on previous calls in the chain by linking function inputs into the caller graph before re-entering after compiling an input.

• Updated the Actor Position node to now be set to the position of the actor you are attached to instead of your owning actor.

Postprocessing

• New: Added Alpha output support for postprocess materials (optional as a property of the material).

• Anti Aliasing method has been removed from Post Process volume settings, and can now only be set from Project Settings under the Rendering section.

Optimizations

• New: Added shadow stencil clear optimization - avoids clearing stencil for each projected shadow by zeroing the stencil buffer during testing.

  • This can give significant performance gains in cases with large numbers of per-object shadows (e.g. many characters with a single stationary light).

  • Note: Writing to stencil during testing negates the use of high stencil on many GPUs, but this change is still a clear win an all the cases we tested.

• Updated material resources to not be created if we are in a build that can never render - This saves a few MB of memory.

Mobile Rendering

• New: Improved Mobile Scalability options. Each mobile material quality level can now specify a CSM shadow filtering quality, and the Fog calculation can now be enabled and disabled for both HDR and non-HDR mobile games.

• New: Added on screen warning for invalid reflection captures. It can be seen only in a game running with mobile renderer.

• New: Added option to mobile quality level settings to control the quality of filtering applied when rendering with CSM shaders.

• New: Android device profiles can now elect to disable support for Vulkan and fallback to OpenGLES.

  • Use the console command r.Android.DisableVulkanSupport to disable support for Vulkan.

• New: Mobile vertex fog is now a project option.

  • It can now be enabled or disabled regardless of Mobile HDR project setting.

• New: Added basic mobile support for global clip plane project setting.

  • This fixes rendering issues with planar reflections on mobile.

• New: Added more stringent checks for Android ES3.1 compatibility.

  • Android ES3.1 devices must also support floating point render targets and shader IO blocks.

  • Improved logging when ES3.1 support has failed.

• Bugfix: Fixed a crash on startup when using Vulkan on Android devices with Mali-based GPUs.

• Bugfix: Fixed Average Brightness property being applied to reflections in gamma space in the mobile base pass. This would cause ES2 reflections to be overbright.

• Bugfix: Fixed case where Sky Light could be rendered in green color on some Android devices.

• Bugfix: Fixed an issue where the editor ES2 Feature Level Preview and Mobile Preview PIE modes were not correctly limiting materials to only the 8 textures available on ES2.

• Bugfix: Fixed issues with modulated shadows and decals on some PowerVR54x based android devices (such as Galaxy S4).

• Bugfix: Fixed issues with transparent depth reading materials reading invalid depths on some android devices.

• Bugfix: Fixed planar reflections when running Vulkan on Android devices with Adreno-based GPUs.

• Bugfix: Fixed possible rendering issues with gpu skinning on OpenGL ES 3.1 platforms.

• Bugfix: Fixed Android to use single channel texture for Shadow Maps instead of 4 channel.

• Bugfix: Fixed Black HDR compressed textures on devices with Mali GPUs.

• Bugfix: Fixed Black rendering artifacts on Nvidia Shield Tablet device when project is built with Deferred OpenGL ES rendering support.

• Bugfix: Fixed ES3+ devices to properly detect support for HALF_FLOAT and UNSIGNED_INT_2_10_10_10_REV vertex formats.

• Bugfix: Fixed the Help text for SortBasePass console variable to now properly describe each option.

• Bugfix: Fixed iPad Mini 4 devices to now correctly render refraction effect.

• Bugfix: Fixed Particle Cutout crashes on certain devices (Samsung Galaxy Note 2).

• Bugfix: Fixed Shader compile errors on NVIDIA Shield devices when project uses dynamic Point Lights.

• Updated planar reflections on mobile to no longer cause GPU particles to be updated twice per frame.

• Updated scene captures to now correctly decode scene color on devices that do not support floating point targets (such as the pre-updated Galaxy S6).

• Previously, Mobile HDR setting implied vertex fog. If your project does not use Mobile HDR, you may wish to disable Vertex Fog in the Project Settings.

UI

• New: Added delegate to the Game Viewport Client that notifies when the Game's platform specific window is being closed, and can be used to prevent the game from being exited (and the window from being closed).

• New: Textures, Materials, and Paper2D Sprites can now be added to Widget Blueprints directly from the Content Browser.

• New: Updated the Text Render Component to support multiple font pages.

• Updated Circular Throbber widgets to no longer support Period values less than zero and they will no longer throw an error when set to zero.

• Updated the viewport to no longer lose mouse focus if a visible cursor clicks inside of it when the cursor should be visible.

• Updated drag operations to only be completed or canceled by the finger that started the operation, when using touch input.

Slate

• New: Added support for underlined text rendering.

  • The Text Block Style can now specify a brush to use to draw an underline for text (a suitable default would be "DefaultTextUnderline" from the Core Style class).

  • When a brush is specified here, we inject highlights into the text layout to draw the underline under the relevant pieces of text, using the correct color, position, and thickness.

• New: Added the Window Title Bar Area widget (and UMG wrapper for it), which can be used to specify which regions of the UI should enable the user to drag the window on desktop platforms.

• New: You can now use the Content/SlateDebug folder to store any Slate resources that shouldn't be used in a shipping build.

  • LastResort.ttf has been moved to this folder.

• Bugfix: Fixed jittering that could occur when using a fixed wrapping width with an editable text.

• Bugfix: Fixed an issue preventing Editable Text and Multi Line Editable Text from setting the correct foreground color when painting.

• Bugfix: Fixed volatility and invalidation issues for text widgets.

• Bugfix: Fixed Editor freezes and memory leaks when slate remote is enabled.

• Bugfix: Fixed Scroll Box right mouse/touch grab scrolling functionality.

• Bugfix: Fixed engine compilation with defined LOG_SLATE_EVENTS.

• Updated material blend states to match what is expected of Slate rendering, which differs a lot from the scene renderer with the way it treats alpha.

  • This fixes translucent rendering with the retainer widget, users will need to set their materials to Alpha Composite though for it to behave as expected.

• Updated Menu Anchor and Scroll Box to now work with invalidation panels.

UMG

• New: Added controller support to Combo Box widget.

• New: Added support for outline fonts.

• New: Updated the Copy, Cut & Paste animation tracks to be fully supported in UMG now, though not fully supported for Sequencer in general (outside of UMG).

• New: Updated the safe zone widget in both Slate and UMG to have the ability to control which sides are accounted for.

  • This can enable the nesting of these widgets to solve situations where you want parts of your layouts to extend to the edge of the viewport.

• New: Updated the selection of animation tracks in UMG to automatically update the selected widgets now.

• New: Added an option to exclude all UMG widgets and slots from dedicated server builds.

  • Set bLoadWidgetsOnDedicatedServer=false for this behavior.

• New: Exposed a trace channel for the Widget Interaction Component.

  • Defaults to Visibility.

• New: Took the Widget Component and Widget Interaction Components out of experimental.

  • Removed old importing support for upgrading ancient versions of widget components.

  • Removed parabola distortion, as users can now do whatever they want in their custom MID they can override the widget with.

• New: Updated the designer so that you can disable and enable the dashed lines around containers by using 'G' to toggle game mode. The option in the settings is now used as the default when you startup a designer.

• New: Updated the UMG "Replace with" function to now support "Replace with Selected Widget".

• New: Updated UMG Project settings to now show/hide different widget classes and categories in Palette view.

  • Set this option under Project Settings->Editor->UMG Editor.

• Bugfix: Fixed an issue where renaming a widget would cause the slot content animation track to be invalid.

• Bugfix: Fixed an issue where buttons inside a scroll list with a click method set to Precise Click would activate if the mouse was released when they are out of view.

• Bugfix: Fixed an issue where removing a Widget from Panel Widget did not invalidate layout, which could leave it still visible accidentally.

• Bugfix: Added missing base includes and forward declarations for Progress Bar and Text Block.

• Bugfix: Fixed 3D widgets getting culled when using materials that disable depth testing.

• Updated Combo Box (String) widgets to now correctly clear the currently selected option if that option is removed from a Selection Changed callback.

• Prevented widget animation from being named the same as one of the override functions in a User Widget.

• Updated the Experimental Class warning to now have a more detailed description.

• Updated minimized windows to no longer behave like they are visible when determining what widgets are located under the mouse cursor.

• Updated the grid panel to now properly set padding on slots as it is intended to.

• Updated the wrap box so that the second row now properly receives "inner" vertical padding.

• Documented the meta parameters allowed on widgets, like we do for regular UObjects.

  • For binding widgets from blueprints you can now do BindWidget (unchanged), and to simplify binding widgets optionally, you can now just use BindWidgetOptional, rather than the combination of BindWidget and setting OptionalWidget to true.

• Improved setting focus for users on widgets.

  • If we are unable to set the focus immediately, possibly because the user is setting focus in the Construct callback before the widget is in the tree, we now update the Slate Operations FReply on Local Player to set focus in the next frame when it is more likely the widget will become focus-able.

• Updated retainer widgets to now contain the Virtual Window directly in the hierarchy. This should now make it possible to reliably focus elements inside the retainer widget.

• Updated Button and Widget to no longer multiply color and opacity twice.

VR

• New: Added support for getting the HMD Device name (e.g. "OculusRift," "SteamVR," "PSVR," etc) through Blueprints and C++.

• New: Added the "Start in VR" project setting, which enables projects to specify that they would like to automatically attempt to run in VR mode, regardless of whether or not -vr is passed on the commandline.

• New: Added the ability to re-enter VR preview in the Editor after exiting from it using the quit option inside the SteamVR overlay. Previously one had to quit and restart the Editor to re-enable VR.

  • It is now possible to reliably exit a game from the Steam VR overlay exit button, even when previewing in the Editor.

• New: Added the ability to select which HMD module to use on startup by passing "hmd=" on the command line.

  • This is useful if you have more than one type of device attached to your machine. If no device matches the name passed in, a warning will be printed to the log and VR will be disabled.

• New: Added support to the Oculus Rift for the "r.ScreenPercentage" console variable if it is set manually.

  • The obsolete console command "HMD SCREENPERCENTAGE" will still work, but assigning to "r.ScreenPercentage" is now the preferred way.

• New: Updated the PSVR 2DVR texture to now be a UTexture, so it can be a RenderTarget, etc. Also improved error reporting for this and some other PSVR features.

• New: Added three options to the PSVR HMD Setup Dialog Cancel reactions.

  • Disallow Cancel - Put the HMD Setup Dialog up again. Appropriate for titles that only support VR output.

  • Switch To 2D - Switch to 2D output mode and send the HMD Connect Canceled Delegate. Appropriate for apps where 2D play is supported.

  • Delegate Defined - Fire the HMD Connect Canceled Delegate. The project needs to handle this delegate and take appropriate action while being mindful of TRC requirements.

  • Be sure to consider the case where the HMD is disconnected as the program starts up.

• New: Added delegates for when the PSVR headset is taken off the head or put on the head.

• New: Updated GoogleVR SDK to v1.01, which adds proper support for splash screens.

• New: Updated OSVR plugin.

  • Fixes multiple crashes, and improves tracking.

• New: Added VR splash screen for level transitions.

• New: Updated UI elements that composite after reprojection to preserve quality.

• Bugfix: Applied fix for Adreno GearVR devices rendering black on startup.

• Bugfix: Fixed Add Controller Yaw Input with PSVR. The yaw was being reset every frame.

• Bugfix: Fixed an issue where the main editor window was not restored after exiting VR preview in some cases.

• Bugfix: Fixed crash when exiting PIE while a panoramic screenshot was in the process of being taken.

• Bugfix: Fixed motion controller attachment movement when the game is paused.

• Bugfix: Fixed PSVR reprojection prediction time. HMD motion now runs off the edge of the rendered area less easily.

• Bugfix: Fixed saving the Oculus Rift INI setting "bPixelDensityAdaptive". It was previously saved as a floating point value instead of a boolean.

• Bugfix: Fixed some static analysis warnings in Oculus Rift plugin code.

• Bugfix: Fixed the "Get bounds node" for SteamVR to return the correct bounds if they have changed since initialization. This could happen if the HMD was outside of tracking area during start up.

• Worked around a bug in SteamVR that caused VR to fail to initialize if SteamVR isn't running when launching the application.

• Added positional tracking information on PSVR even when the device isn't optically tracked. This enables proper IPD to be taken into account for rendering.

• Added support for the left menu button on the Oculus Touch controllers.

• Adjusted Hidden/Visible area masks to eliminate black crescents at the top and the bottom edges of the PSVR HMD.

• Updated changing world to meters scale while running in VR Preview mode in the Editor on Oculus Rift so that it now correctly applies the changes to the Oculus Touch controllers.

• Updated VR play-in-editor to always use "Game has mouse focus" option, to ensure that motion controllers are routing input correctly to the game.

• Added a PSVR Morpheus project setting to set the reprojection wrap mode to Mirror or Clamp To Border. This determines how left and right reprojection artifact pixels are filled.

  • Mirror, the default, fills them with some nearby pixels.

  • ClampToBorder fills them with the border color (usually black).

  • Most content works best with mirror.

• Updated PSVR to now ignore partial HMD tracking data before the HMD has been tracked in a game session because orientation based re-projection does not function until that happens. There is a project setting to disable this, should the PS4 behavior change in the future.

Other

• New: Added the ability to change Device Profiles at runtime.

  • Use "dp.override ". If you do it again to another one, it will reset the settings to what they were originally, before applying the second new Device Profile. This is because the second Device Profile may not set all settings the first one did, but we want to undo the first settings that the second doesn't contain.

  • Changed "Set Quality Levels" function, in Scalability.cpp, to no longer change the "SetBy" priority when setting console variables. This now keeps the "SetBy" the same as it was, which helps with conflicts between game settings and Device Profiles. See the "Set With Current Priority" function.

• New: Added an option to toggle full screen with F11 key in addition to Alt+Enter in games.

• New: Added Parse function to JsonObject.cs to be able to parse a string instead of only files.

• New: Env Query Instance Blueprint Wrapper is now Blueprintable.

  • This enables you to make Blueprints that enable more complex 'wrapper' behavior when using the Blueprint node "Run EQS Query" (on the EnvQueryManager).

  • Made "EEnvQueryStatus" a Blueprint type, which makes it much easier to work with in Blueprints.

• New: For Media Assets, added "Can Play Source" and "Can Play Url" methods to Media Player.

• New: For Media Assets, added more verbose logging output, e.g. for dropped video frames.

• New: For Media Assets, added "Open File" method to Media Player.

• New: For Media Assets, implemented Platform Media Source.

• New: For Media Assets, Implemented per-platform media player overrides in Media Asset derived classes.

• New: For Media Player Editor, added "Original Size" viewport mode.

• New: For Media Player Editor, added Stats tab to show decoder performance statistics during playback.

• New: For Media Player Editor, added support for dragging and dropping media files into media player editor.

• New: For Media Player Editor, implemented platform player overrides details customization for media assets.

• New: For Media Player Editor, trimming leading and trailing whitespace in URL textbox.

• New: Project-specific versions of identically named engine plugins are now supported.

  • Multiple plugins with the same name are prohibited at other times.

• New: For PS4 Media, improved memory allocator to avoid "out-of-memory" issues when playing multiple videos.

• New: For Wmf Media, added QuickTime to known video subtypes.

• New: For Wmf Media, refactored playback topology handling to support multiple tracks and track switching.

• New: For Avf Media, added missing supported media file extensions for macOS/iOS media player.

• Bugfix: Fixed a crash when loading Unreal Stats in the Session Frontend.

• Bugfix: Fixed a crash where sometimes the Crash Reporter Client would crash if it didn't receive a ping responses from the Epic crash server.

• Bugfix: Fixed a crash when after playing media that requires a different conversion shader.

• Bugfix: Fixed an issue with window centering when moving from fullscreen to windowed mode.

• Bugfix: Fixed an issue with Media assets where existing native player not being reused when opening new media source.

• Bugfix: For Media assets, improved the appearance of file media source paths.

• Bugfix: For the Media Player Editor, fixed the media player selection is ignored if media specifies player overrides.

• Bugfix: For the Media Player Editor, fixed where the URL box would sometimes incorrectly show media load error even though it loaded correctly.

• Bugfix: For PS4 Media, fixed a crash with the CPU/GPU due to a race condition in destructor.

• Bugfix: For Wmf Media, fixed an issue where FourCC types printing in reverse order.

• Bugfix: For Wmf Media, fixed an issue with GuidToString printing the incorrect byte sequence.

• Bugfix: For Wmf Media, fixed a memory leak while playing videos.

• Bugfix: For Wmf Media, fixed an issue where WMV2 encoded videos were too bright.

• Bugfix: Removed still image tracks and sinks.

• Removed use of Windows Error Report API from engine crash handling. Fixes cases where WER settings in Windows could block UE4 crash report system.

Programming Release Notes

AI

Navigation

• Added sanity checks to NavDataSet elements access in UNavigationSystem.

• CrowdAgentMoveDirection will be set while traversing a link, unless the agent is falling.

• Made NavigationSystem call TickAsyncBuild on all navigation data instances while there is an ongoing navigation build in progress, regardless of whether auto navmesh update is enabled.

Animation

• New: Made RawAnimationData (and associated structures) private and added accessors and new functionality to enable modification in a safer way than direct access.

Blueprints

• New: Added GetConvenientWindowedResolutions to KismetSystemLibrary.

• New: Added ability to use "AdvancedDisplay" metadata in MakeStruct nodes.

• Bugfix: Fixed an issue in Blueprint compilation that could cause crashes with certain memory allocators.

• Bugfix: Fixed an issue where components of inherited grandchild blueprints would sometimes use invalid components as their outer in cooked builds.

Core

• New: Added UWorld::SetTimeUntilNextGarbageCollection to change the GC timer for use when doing automated performance capture measurements.

  • Note: Things that force a GC will still force a GC after using this method (and they will also reset the timer).

• New: Added a method to extract swing and twist quaternions from FQuat.

• New: Added a new Invoke function which enables member function pointers and data member pointers to be used as simple projections in algorithms.

• New: Added a Super typedef to USTRUCTs which specify another USTRUCT as their base.

• New: Added a TNot metafunction which inverts the Value of another boolean metafunction.

• New: Added Algo::Sort which sorts a range like TArray::Sort but doesn't auto-dereference pointers.

• New: Added Algo::SortBy which sorts a range via a projection of the elements.

• New: Added an OOM delegate so other systems can get a callback after OOM occurs (after deleting the backup memory pool if it exists).

• New: Added an optional size to MallocLeak Stop and made the default filter size 128 KB for both MallocLeak Dump and MallocLeak Stop if no size was specified.

• New: Added array-new support to TUniquePtr and MakeUnique.

• New: Added AsyncThread function to enable stack size and priority to be specified

• New: Added ENGINE_API to FStripDataFlags so that it can be used outside of the Engine module.

• New: Added extra context to FTableRowBase::OnPostDataImport.

  • It now takes the owning data table and the row name as parameters. This enables it to do more useful fix-up that depends on the context of where it is used.

• New: Added Find and Contains functions to TBitArray.

• New: Added FUNCTION_NO_NULL_RETURN_BEGIN and _END to statically annotate a function that never returns a null pointer.

• New: Added GetData(), GetNum() generic functions, and TElementType, TIsContiguousContainer traits.

  • The generic GetData() is only valid for contiguous containers, which include C arrays, initializer lists, TArray and TArrayView.

• New: Added Invoke support for TFunction, which enables a member function pointer or data member pointer to be bound to a TFunction.

• New: Added Invoke() support to CopyIf

• New: Added MakeShared to enable the construction of an object and its reference controller in a single allocation.

• New: Added new Algo::Count and CountIf, for counting elements in a container which match a given value / predicate.

• New: Added some extra checks to catch uninitialized pointers passed to the garbage collector.

• New: Added support for custom versions in FArchiveProxy.

• New: Added TLess<> and TGreater<> specializations which can take any argument type.

• New: Disabled logging to memory in shipping builds by default. From now on FOutputDeviceMemory will be an opt-in for games.

• New: Improved bitwise swapping for Swap so that it produces more optimal code in general.

• New: New Objects can now be created as duplicate transient or PIE duplicate transient consistent with the flags of properties that reference them.

• New: When the Event Driven Loader is enabled in cooked games, the engine will use the async loading path when loading all assets (even when using LoadObject function).

• New: Added display of the name of the corrupt pak file in various pak file error messages.

• New: Added FArchive::operator<< for enum classes, which serializes the underlying type.

  • Changed generated code to never use TEnumAsByte for generated code for enum classes.

• New: Added TIsEnumClass metafunction, for determining if a type is an enum class.

• New: Added TUseBitwiseSwap type trait for user-defined types to specialize (as 'false') if it enables better code generation.

• Bugfix: Fixed bad format string in FLinkerLoad::VerifyImport.

• Bugfix: Fixed a compile error when declaring a TFunction returning a reference type.

• Bugfix: Fixed all static analysis warnings in editor builds.

• Bugfix: Fixed an Unreal Header Tool code generation error when defining a UFUNCTION with a TArray>.

• Bugfix: Fixed bulk data using source data pointer as an archive instead of raw data when saving.

• Bugfix: Fixed constness of ILandscapeEditorModule::GetHeightmapFormatByExtension() and ILandscapeEditorModule::GetWeightmapFormatByExtension().

• Bugfix: Fixed destructor calls not being called on the destination container during a TSparseArray, TMap and TSet move assignment.

• Bugfix: Fixed FWeakObjectPtr/TWeakObjectPtr debugger visualization which depended upon C++ initialization order.

• Bugfix: Fixed TCString::Strspn.

• Bugfix: Fixed TSparseArray debugger visualizer.

• Changed FMallocStomp::GetAllocationSize() to return the requested allocation size instead of the physical allocation size to make FMallocStomp work properly with FMallocPoisonProxy.

• Changed checkSlow() to check() when verifying type compatibility in GetDefaultObject<> because this is potentially an unsafe static cast.

• FindObjectWithOuter once again enables ClassToLookFor to be null as comment indicates is allowed.

• Increased the initial memory allocation size for FLargeMemoryWriter to reduce the number of allocations when saving or cooking.

• Lowered verbosity of several error messages that happen when deleting native properties or components.

• Lowered verbosity of several warning messages that happen when deleting properties or components from parent classes. These issues used to require resaving the child blueprint or level.

• Made FString::Mid assert when passed a negative count.

• Made Unreal Header Tool able to parse final classes.

• Moved RemoveNamesFromMasterList from UEnum destructor to BeginDestroy to avoid potential issues when its package has already been destroyed.

• Removed blueprint stack warning messages from shipping builds, the stack was missing so the warnings were pointless.

• Updated stack captures to now always go down the fast path. This avoids a game going unresponsive on Windows when printing or capturing large numbers of callstacks such as with the 'mallocleak' command.

• Updated the JSON writer to now write floats with a suitable level of precision, where before it was always writing many redundant zeroes.

Editor and Tools

• New: Added allocation tagging to MemoryProfiler2

  • See FMallocProfiler::AddTag and FMallocProfiler::RemoveTag. Tags should be in the format "Category:Tag", and the "Tag" part may include "/" to create levels in the tag hierarchy (as shown in the tool).

  • Added object, package, and class tags by default (this uses FScopeCycleCounterUObject, so the stats system is now enabled when malloc profiling).

• New: Optimization and usability improvements of the MemoryProfiler2 tool

  • Optimized the processing of the Callgraph, Histogram, and Short lived allocations views.

  • Added a user-configurable list of allocator functions to trim (which now includes FMemory and operator new by default, and produces much cleaner callstacks).

• Bugfix: Fixed FDetailCategoryImpl::ShouldBeExpanded not honoring bShouldBeInitiallyCollapsed when bRestoreExpansionState was true.

• PostEditComponentMove will now be called correctly when stopping a drag operation of a scene component of an actor in a level.

• UWorldComposition::GetTilesList function can now be used in game code (previously only in Editor).

• Fixed all static analysis warnings in Editor builds.

Content Browser

• Bugfix: Fixed an issue where re-scanning a package file may leave old assets in the asset registry.

  • It used to not clear out anything associated with the old package before scanning the file, which could result in old assets being left if they'd since been removed from the package.

  • This also exposes a PackageDeleted function to enable manually clearing anything associated with a package (if doing some custom asset work).

World Browser

• UWorldComposition::GetTilesList function can now be used in game code (previously only in Editor)

Sequencer

• New: Added interface to extend the matinee to level sequence converter.

Gameplay Framework

• New: Actors can now specify via bRunConstructionScriptOnDrag whether PostEditMove should fire the construction script on every move or only when the move is considered finished.

• New: Added a bWasCancelled parameter to GameplayAbility::EndAbility. This enables us to determine if an ability was ended prematurely. Added an OnAbilitySucceeded delegate for determining when an ability was successfully ended.

• New: Added an FName constructor to FCollisionProfileName.

• New: FLocalPlayerContext functions no longer check by default.

• New: UPrimitiveComponent now has an optional list of components it will ignore collision with when performing movement sweeps.

• New: UWorld now has a member that accumulates the dilated/clamped game time even when paused called UnpausedTimeSeconds.

• Bugfix: Fixed an issue where FGameplayTagContainer::HasTag(Tag, IncludeParent, IncludeParent) would miss some matches. Added tests to find other issues.

• Bugfix: Fixed an issue where FindTeleportSpot used when spawning actors would sometimes fail to find a valid nearby spot depending on the previous collision results.

• Bugfix: Fixed CharacterMovement hanging on to a bad/penetrating floor check result and not continuing to check for a valid floor. This only occurred if bAlwaysCheckFloor was false.

  • This could in rare situations cause the character to continue to attempt to depenetrate an object far away from it until another floor check occurred.

• Bugfix: Fixed tooltip text for p.NetEnableListenServerSmoothing command (it was a copy/paste from another command).

• Updated bRemoteOwned to no longer be settable in FSpawnActorParameters as only spawning a replicated Actor from the replication code should ever have been setting this to true.

• Updated Components to no longer need to specify whether they want begin play or not.

• Updated GetNextViewablePlayer to now check and return correct PlayerState.

Localization

• New: Added basic support for localizing plugins.

• Wrapped UMaterialExpression::MenuCategories in WITH_EDITORONLY_DATA to avoid gathering it for game-only localization.

Networking

• Updated UDPPing to enable a stack size to be set for the individual threads that the ping will be performed on to compensate for third party injected code that exceeds stack space available in default 32k limit.

Online

• New: Added AddGenericToInQueueOnlineThread(), useful running a delegate on Online thread instead of game thread.

• New: Added a UChatroom class that does some basic chat room join/create/leave functionality using the online chat interface.

• New: Added an ExpirationDate field to FOnlineStoreOffer. This value is initialized as FDateTime::MaxValue().

• New: Added GetSessionIdStr to FOnlineSessionSearchResult and FOnlineSession as convenience functions.

• New: Added OSS.VoiceLoopback <0/1> to debug chat by including local talkers into remote talkers audio queue. Additionally added "ONLINE VOICE DUMP" exec command to print out known state of voice interface for troubleshooting.

• Removed spurious log message during voice initialization as it is covered by other logging.

• Added proper GetResolvedConnectString functions for PS4/Live.

• UPartyGameState::ResetLocalPlayerState() iterates over local players rather than game state player array for the very rare cases where AGameState is null.

Physics

• New: Kinematic actors now excluded from active transforms generation. This saves time in fetchResults.

• New: PhysicsConstraintComponent now exported and can be subclassed outside Engine.

• New: Sweeps can now take a rotation parameter that will enable the shapes used for the sweep to have their orientation changed.

• Bugfix: PhysX no longer returns NaN from some penetration tests.

• Bugfix: Fixed crash from user doing unsafe things during fetchResults by moving OnConstraintBreak delegate so that it fires outside of fetchResults.

• Implemented copy and assignment operator for convexElem struct and aggregate geometry to avoid shallow copy of raw pointers.

• Moved skeletal mesh component physics updating into EndPhysics so that other components can use it safely in PostPhysics.

Platforms

• New: Added support for delay load DLLs for Xbox One.

• New: libcurl 7_48_0 - headers and lib updates

• New: libwebsockets 1.7.4 - headers and lib updates

• New: openssl 1_0_2h - headers and lib updates

• New: webRTC rev.12643 - headers and lib updates

• New: zlib 1.2.8 - headers and lib updates

• Bugfix: Fixed a parameter order issue that could cause incorrect compression settings to be used.

• Bugfix: Fixed a threading issue with the virtual keyboard implementation that could cause the use of protected Slate functions from a non-game thread.

• Bugfix: Fixed an issue where stats were using unsupported 64 bit atomics on Windows XP.

• Bugfix: Fixed an issue where the wrong xdk.h header could be included by ShaderCompileWorker if a Tools SDK with a different version than the target XDK was installed.

• Bugfix: Fixed an issue where Windows XP would not build if the Windows 10 SDK was installed.

• Bugfix: Fixed an issue where Xbox One was warning about PDB files missing that are not meant to be present.

• Bugfix: Fixed incompatible VR code being built for Windows XP.

• Converted the PS4MallocCrash class into a generic one.

• Split PLATFORM_HAS_BSD_SOCKET_FEATURE_GETADDRINFO off from PLATFORM_HAS_BSD_SOCKET_FEATURE_GETHOSTNAME.

iOS

• New: Added PRAGMA_DISABLE_OPTIMIZATION_ACTUAL and PRAGMA_ENABLE_OPTIMIZATION_ACTUAL defines.

Mac

• New: Changed the code responsible for generating RPATH entries to enable third party dylibs on Mac to be loaded from plugin subfolders.

• New: Implemented IsGamepadAttached() function.

• Bugfix: Fixed indexing of iOS and tvOS-specific files in Xcode project.

• Changed FString(const NSString* In) constructor to use CFStringGetBytes instead of [NSString cStringUsingEncoding]. It's faster and solves the problem with the previous implementation's incorrect assumption that UTF32 string returned from cStringUsingEncoding would be zero-terminated.

Playstation 4

• New: Added support for displaying one and two button message dialogs on Playstation 4.

• New: Refactored symbol uploading in Unreal Automation Tool (UAT). The new system supports both Windows and Playstation, and handles the submission of build symbols to a symbol server as part of a UAT build script.

• New: The "Play Together" feature is now implemented on PS4! You can override OnPlayTogetherEventReceived on UGameInstance to handle the event. Check out ShooterGame for an example implementation.

• New: Upgraded to PlayStation 4 SDK version 4.008.061.

• Bugfix: Fixed a bug introduced by trying to get the taskgraph broadcast to work on PC.

• Changed the Playstation 4 exit behavior to avoid calling abort() when shutting down cleanly.

• Updated GetBackMemoryPoolSize to now correctly return an integer.

• Moved the Playstation 4 crash dump user callback registration to a much earlier point in engine initialization, to catch early crashes in engine preinit.

Xbox One

• New: Added support for staging and loading DLLs on Xbox One.

• Bugfix: Fixed a crash bug when using "recompileshaders changed" on Xbox One, with a cook-on-the-fly server.

• Bugfix: Fixed an issue that could cause a memory overwrite when using compute fences.

• Bugfix: Fixed a compile warning when the current XDK is built using the RTM version of Visual Studio 2015.

  • Note: Only Visual Studio Update 3 is officially supported in this release.

• Bugfix: Fixed the incorrect DirectX header being included for the Xbox One target platform.

HTML5

• Bugfix: Fixed a crash in WebSocketNetDriver. A chunk of code was missing that calls PacketHandler's "packet modifiers."

• Updated HTML5 plugin OnRawReceive overflow to check for minimum expected size upon data received from network.

Windows

• Bugfix: Fixed a crash bug during adapter selection, in the D3D11 RHI.

Programming

• New: Upgraded the Perforce C++ API libraries to version 2015.2.

  • This version adds official support for Visual Studio 2015 from Perforce.

  • This also fixes an issue where the debug version of the Perforce C++ API libraries was not built with the correct debug settings.

• New: Added list of Dependant modules to warning about code that fails our EULA check.

• Bugfix: Fixed a typo in a define that could cause Visual Studio 2015 to crash.

• Bugfix: Fixed Clean process during a Hot Reload.

• Bugfix: Fixed issue where project-specific modules could be considered out of date, when building multiple targets through Visual Studio at once. Unique build id strings in .modules files are now shared until an existing file is modified.

• Bugfix: Implemented various fixes for building with -nosharedPCH.

• Bugfix: Implemented various fixes to enable the Editor to be compiled in Monolithic mode.

Rendering

• New: Added delegates called after resolving scene color (e.g. to do custom post-processing).

• New: Added direct support for the creation and binding of Pipeline State Objects at the RHI level. This is the first step on the road to moving PSO handling to the high level rendering code to have a unified solution for DX12, Vulkan, and Metal.

• New: Updated DrawDebug functions to now compile out in Shipping and Test builds.

  • If you wish to generate compile errors for trying to call them at all, you can define SHIPPING_DRAW_DEBUG_ERROR=1

• New: Exposed GPU revision ID as GRHIDeviceRevision and added it to the FPS chart analytics (gathered on D3D11 and D3D12 only).

• New: Added the first implementation of the new RHI functions for Pipeline State Objects on DX12.

• New: Refactored the GL shader compiler to enable GLSL variant platforms to modify behavior without a lot of #if checks everywhere in the GL code.

  • Added ability in the cross compiler to convert the global uniform arrays into named uniform buffer objects.

  • Added ability for GL shader compiler to return the original resources names ("VertColor" instead of "u_v[3]" or whatever) to the shader compiler shader parameter metadata. This does NOT change the generated GLSL code.

• Bugfix: Fixed async compute parameter problems on PS4 by adding SetShaderValue() specialization for bools on AsyncCompute commandlists.

• Bugfix: Fixed a D3D error with mismatched vertex/pixel shader registers for SV_POSITION input.

• Bugfix: Fixed an ensure fail when initializing point light shadow maps and simplified the logic for cubemap render target resolution parameters.

• Bugfix: Fixed a race condition where debug drawing code was trying to read data off the SceneProxy from the Gamethread.

• Exposed full USceneCaptureComponent classes to plugins instead of select methods.

Materials

• New: Refactored material properties during graph translation.

  • Fixed material properties are being phased out in favor of better encapsulated and more extensible attribute lists.

  • This is the first in a series of changes moving towards per-project attribute controls and improved high-level usability.

UI

Slate

• Bugfix: Fixed SWrapBox InnerSlotPadding.Y not applying between the first and second lines.

VR

• New: GetNumOfTrackingSensors and GetTrackingSensorProperties are now supported by SteamVR as well as Oculus Rift.

• Bugfix: Fixed saving of a few VR related config flags. They were being saved under the wrong name, preventing them from being read in again.

• Bugfix: Fixed the tracking camera orientation returned from GetTrackingSensorProperties on the Oculus Rift to now point in the correct direction. Previously it was pointing towards the back of the camera instead of its facing direction.

Other

• New: Added ability for custom implementations of UGameplayModMagnitudeCalculation to specify they have dependencies external from the ability system that may invalidate their calculated magnitudes. Dependencies are specified by multicast delegate that is expected to fire when the magnitude needs to be updated.

  • Also added advanced variant of the implementation enabling clients to also trigger the dependency invalidation and update themselves appropriately. Designed to only be used for extreme cases (such as games relying heavily on network dormancy) and only on attributes that are not gameplay-impactful (and therefore safe for the client to locally compute).

• New: Added new API function for DrawDebugSolidBox, which takes an FBox instead of a Center and Extent. It also enables specifying a transform as well (but defaults to using the identity transform for convenience).

• New: Added option to disable uploads to Crash Report Receivers while they continue to answer pings from clients.

• New: Crash Report Process now has option to output crash files to Amazon S3.

• New: Crash Report Process now has optional, dedicated PS4 crashes queue.

• New: Crash Report Process performance improvements.

  • Added -ForceUsePDBCache option to MinidumpDiagnostics to early abort runs that have no valid PDB cache entry. Early out for slowest reports.

  • Changed MinidumpDiagnostics logging locations to avoid speed cost of logging to a folder with thousands of files.

  • Improved CRP shutdown speed when updating.

• New: Crash Reporter backend performance improvements.

  • Crash Report Process can discard crashes when crash queues become too long.

  • Crash Report Process can run multiple instances of MinidumpDiagnostics to speed up callstack generation.

  • MinidumpDiagnostics can place a system-wide lock on resources (Perforce workspace and the PDB cache) to enable multiple instances without multiplying storage requirements.

• New: CrashReportProcess logging and Slack reporting improvements to monitor disk space.

• New: CrashReportProcess passes new BuildVersion string to MinidumpDiagnostics for symbol lookup.

• New: Introduced the concept of "evaluation channels" to non-instant gameplay effects within the ability system! Evaluation channels enable game-specific control over the order in which modifiers are evaluated in attribute calculations.

  • A game may specify how many channels it would like to use, as well as what they are named, and then modifiers can specify which channel they work on. The channels are evaluated in order, with the numerical output of the first channel serving as the input to the second channel, and so on.

  • Example: Imagine a sample attribute with a base value of 100. Now apply a multiplicative mod with magnitude 1.1 in channel 0 and a multiplicative mod with magnitude 1.1 in channel 1. The result will evaluate as ((100 1.1) 1.1) instead of (100 * 1.2).

  • To use channels in a game, two settings within the INI section for AbilitySystemGlobals must be configured. First, bAllowGameplayModEvaluationChannels must be set to true, and second, the channels that should be used (and their names) must be specified in GameplayModEvaluationChannelAliases. Additionally, a game can optionally specify a default channel to use via DefaultGameplayModEvaluationChannel.

  • In addition, added various new channel-related functionality to the ability classes' API, such as the ability to base the magnitude of a modifier off of an attribute only evaluated up to a certain channel.

• New: Large Crash Report Process update.

  • Removed legacy queues for deprecated Crash Report Receivers.

  • Removed duplication tracking needed when using Crash Report Receivers as this was slow and didn't scale.

• Bugfix: Fixed a header issue that was including 64k of test data into shipping builds, it is now stripped out appropriately.

• Bugfix: Fixed issue wherein gameplay effects with non-snapshotted, attribute-based modifiers could potentially not replicate to clients correctly, resulting in incorrect values on clients.

• Bugfix: Fixed problem where MinidumpDiagnostics used on CR backend would strip unnecessary lines from callstacks.

Upgrade Notes

C++ API Changes

• New: Made the "RemoveAt" and "RemoveAtSwap" functions in TArray trigger a compile error when a boolean argument is passed as the count.

• New: Renamed the Strfind function in TCString to Strifind, as it is case-insensitive.

  • Added the Strfind function to TCString, which is actually case-sensitive.

• New: The default allocator for cooked Windows games is now BinnedMalloc2 to match other platforms. The argument "-binnedmalloc" will switch back to the older allocator.

• New: Component Activate and Deactivate events now supply the component being affected as an argument. Any C++ functions bound to Component Activate and Deactivate events will need to add a component argument to the signature.

• New: libwebsockets 1.7.4 - headers and lib updates. The libwebsockets API has changed.

• New: Skip cooking editor content now defaults to true in project settings.

  • If your project uses content in "Engine\Editor*" you may need to disable the "Skip cooking editor content" project setting.

• New: Refactored the View Matrices struct.

  • The members of the View Matrices struct have become private, there are now appropriate Getters for the values. Heavy cost functions have been renamed to Compute and functions that mutate the struct have been renamed to Hack

• New: Split "RHIClear" into "RHIClearDepthStencilTexture," and "RHIClearColorTexture."

  • Anyone using the Clear function in "RHICmdList" will now need to use the appropriate version, passing in the current render target(s).

• New: Moved the "Export/Import Text Item" functions from "Struct Property" to "Export/Import Text" functions in "Script Struct", and added a parameter to say whether to call native callbacks. This enables calling the standard "Import Text" from a native "Import Text Item" followed by post processing.

• New: Refactored the "Add Item Data" function in "Env Query Instance" to get rid of the second template parameter and make it more type-safe.

• New: Added "Ge ResourceSizeEx" and "GetResourceSizeBytes," and deprecated "GetResourceSize."

  • "Get ResourceSizeEx" populates a struct which reports not only how much memory is allocated, but also which arenas the memory was allocated from.

  • "Get ResourceSizeBytes" just wraps a call to "GetResourceSizeEx" and returns the total size from all arenas (this has the same behavior as the now deprecated "GetResourceSize").

  • Classes that used to override "GetResourceSize" should instead override "GetResourceSizeEx" and report their allocations as appropriate.

• New: Deprecated the "Get Bone Tree" function in the Skeleton class and removed references in engine.

• The "Clear Pause" function in the "GameMode" class now returns a boolean. Any virtual overrides will need to have their signature changed and return the appropriate result.

• Made it a compile error to copy the "AIMessageObserver" class, as it was not designed to be copied. You should change the logic of your code to avoid copies of this type.

• Removed Publish Dir property from Installed Engine Build script as it is no longer used.

• Removed obsolete array slack tracking code.

• Removed unused "ToBuildInfoString" function declaration.

• Added the "final" specifier to the UWorld class. UWorld is now non-inheritable.

• Removed some obsolete code and state from the "ScriptStruct" class.

  • The "InheritedCppStructOps" function has been removed. Any calls to it should be replaced with "false."

• Since the HMD module names used when sorting by priority are now also used by the hmd=<name> command line option, the "GetModulePriorityKeyName" function in the "HeadMountedDisplayModule" class has now been renamed to "Get Module Key Name".

• Removed the "UnregisterDebugDrawDelegate," "RegisterDebugDrawDelegate" and "DrawDebugLabels" functions from the "DebugRenderSceneProxy" class and moved them into a new struct called "Debug Draw Delegate Helper."

• Direct access to the Static Mesh property in the Static Mesh Component class has been deprecated. Please use "Get Static Mesh" and "Set Static Mesh" accessors.

• The version of the Create Component function in the Audio Device class that took a long list of arguments has been deprecated. Use the version that takes a parameter struct instead.

• In order to support asymmetric POVs, such as the Vive , the number of "Get Tracking Sensor Properties" has been expanded to return four instead of two POV values. The now deprecated "Get Positional Tracking Camera Properties" is still available, but only returns horizontal and vertical POVs and only supports a single tracking device.

  • If you were previously using the data returned from "Get Tracking Sensor Properties" (or the now deprecated "Get Positional Tracking Camera Properties") on Oculus Rift, you may have to unflip any corrections you were doing on the orientation. This will also make your code compatible with other HMD plugins that support returning information about tracking devices.

• Localization API changes for per-identity exporting:

  • Moved "TextLocalizationResourceGenerator" from Core to Internationalization.

  • Removed "IJsonInternationalizationManifestSerializer" and "IJsonInternationalizationArchiveSerializer."

  • JsonInternationalizationManifestSerializer and FJsonInternationalizationArchiveSerializer now use static functions (due to no longer inheriting or requiring polymorphism).

  • Removed the "Load From Manifest And Archives" function from "Text Localization Manager" (this is now handled by the "Generate And Update Live Entries From Config" function in "Text Localization Resource Generator").

  • Removed the RepairLocalizationData commandlet (it was for fixing data pre-dating the 4.0 release).

  • Removed the "FindEntryBySource" function from "InternationalizationArchive" as it is no-longer safe to use (use the "FindEntryByKey" function instead).

• Refactored single node animation player APIs.

  • Animation player APIs are not safe to be used during construction script because they're not being serialized, so marked not safe for construction script.

  • Exposed override function that can be used in editor.

• Replaced some hacky post-reflection-capture functions with "RHISubmitCommandsAndFlushGPU".

• Made "FindShaderResourceById" and "Find Shader By Id" return a raw pointer instead of a TRefCountPtr to prevent creating temporary TRefCountPtrs. It is no longer necessary to use TRefCountPtrs as shader serialization has changed and shaders are no longer registered on the async loading thread.

• Updated to Playstation 4 4.008.061

Core

• Any projects that make use of -log or -abslog to specify log file names must make sure they are only using .txt or .log extensions.

• FString's "Mid" no longer accepts negative counts as the resulting behavior was surprising. Please replace any usage with the desired behavior.

• TArray "RemoveAt" and "RemoveAtSwap" no longer accept a boolean argument as a count, as it is likely this is intended to be the flag for "Allow Shrinking".

  • The argument should be cast to a non-boolean type if this was intentional or the code should be fixed if it is not.

• TCString's "Strfind" is now case-sensitive. "Strifind" should be used instead to get case-insensitive behavior.

• TEnumAsByte is no longer used for generated code involving enum classes.

  • If you get errors involving TEnumAsByte with your UENUM enum class, please provide a uint8 base to your type and remove the TEnumAsByte usage.

Gameplay Framework

• Check the Game Mode Base notes and documentation to see if you should switch your existing GameMode to inherit from the new minimal Game Mode Base class.

  • Game Mode Base's "Start New Player" has been deprecated, and split into "Initialize HUD For Player" and "Handle Starting New Player" which can be overridden in Blueprints.

  • Several Login functions on Game Mode Base that take TSharedPtr are now deprecated correctly, they stopped working in 4.13, but were not deprecated

  • GameState's "Should Show Gore" and related matinee functions have been deprecated.

• DumpFPSChartAnalytics has been removed.

  • Games that used it should switch to creating their own instance of FPerformanceTrackingChart and call DumpChartToAnalyticsParams on it directly.

• HTML output for stopfpschart is now generated to a single file rather than two duplicate files, which now use both map name and capture time as part of the file name.

• In general, games should have no reason to programmatically call GEngine->StartFPSChart anymore, instead creating their own instance (this prevents conflicts when using the engine console commands).

• Previously the delta time value of a Tick Interval tick function was the same as if the function had no tick interval.

  • This means tick functions that were relying on getting just the frame time need to get the delta time from the world rather than using the value passed into the Tick function.

• Refactored FPS chart creation to make it modular so many performance data consumers can be active at once, enabling greater flexibility and decoupling game analytics from FPS chart exec commands

  • DumpFPSChartAnalytics has been removed, games that used it should switch to creating their own instance of FPerformanceTrackingChart and call DumpChartToAnalyticsParams on it directly.

  • In general games should have no reason to programmatically call GEngine->StartFPSChart anymore, instead creating their own instance (this prevents conflicts when using the engine console commands).

  • HTML output for stopfpschart is now generated to a single file rather than two duplicate files (using both map name and capture time as part of the file name).

  • Removed PauseFPSChart, IsFPSChartActive, and GetFPSChartBoundByFrameCounts to reflect that the GEngine instances aren't meant for external use (Start/Stop are left public for automated testing that wants to use them to do logging, but may also be moved private in the future).

• Removed PauseFPSChart, IsFPSChartActive, and GetFPSChartBoundByFrameCounts to reflect that the GEngine instances aren't meant for external use (Start/Stop are left public for automated testing that wants to use them to do logging, but may also be moved private in the future).

• Several Login functions on Game Mode Base that take TSharedPtr are now deprecated correctly, they stopped working in 4.13 but were not deprecated

• The config data for picking GameMode has moved to Game Maps Settings, with the old locations deprecated. Check BaseEngine.ini for an example.

• Please replace all uses of EWorldType::Preview with either EWorldType's "EditorPreview" or "GamePreview."

• If you desire the checking behavior of FLocalPlayerContext, you will need to change your code to opt in to it.

• Actor Component's flag for "Wants Begin Play" is now deprecated and unused and all components will have "BeginPlay" called on them. Simply remove any code that sets "bWantsBeginPlay."

Platforms

Playstation 4

• PS4 Time's "System Time" now properly returns the local machine time instead of UTC.

  • Existing projects using "System Time" should investigate if this change affects their game logic.

  • To continue using UTC time call "Utc Time" instead.

• For projects targeting PlayStation 4, the engine now requires PlayStation 4 SDK version 4.008.061.

  • Please ensure to update your installed SDK to the correct version, for the engine to compile correctly. This can be done with Sony's SDK manager utility.

Windows

• We are sunsetting support for Windows XP, 4.14 will be the last version to officially support running on Windows XP.

Rendering

• The PS4 defrag pool size is now controlled by a new variable "r.PS4DefragPoolSize", and is not bound anymore to "r.Streaming.PoolSize".

  • It will need to be configured to fit the project needs, in term of graphic resources.

• Try and avoid mutating the FViewMatrices and FSceneView on your own. It is currently practiced within the engine, but we would like to get rid of that.

• The component should own a FDebugDrawDelegateHelper (or derived object) that copies off all needed state for drawing during Draw Debug Labels (which is called from the Game Thread) during Create Scene Proxy.

  • The function to copy off the state is usually called Init Delegate Helper. Then the Helper is used to draw the debug information instead of the Scene Proxy (which is solely owned by the RenderThread at this point).

Lighting

• Due to a bug introduced 2 years ago, all clear coat and cloth was adding lighting twice for all direct lights. This has now been corrected so relevant materials will appear half as bright when in direct light. Indirect lighting such as lightmaps and reflections is unaffected. This makes it tricky to automate material fix up. We suggest reviewing all materials and deciding on a case by case basis whether modifications are required.

• Fixed Reflection Captures having incorrect brightness when a Stationary Skylight is present.

• Note that Lightmap data has been moved to a separate package, named *_BuiltData. Be sure to save these and check them into source control after doing a lighting build!

Materials

• There may be lighting differences in certain cases with materials using Subsurface Profile due to the fixes described above. For the most part, the changes should improve the rendering quality, but it may be necessary to make some minor adjustments to affected materials.

Other

• Epic's live Crash Report Receivers no longer accept crash reports. Newer Crash Report Clients (from 4.11 onwards) upload to our Data Router endpoint.