UnrealGDK Versions Save

Unreal GDK version 0.8.0-preview is go!

Note: this is a preview release. Preview releases are only tested against Improbable partner projects and have incomplete documentation. We do not recommend upgrading to this version unless you have production support from Improbable. We are preparing a public release including all these changes in the near future. For more details see the Versioning Scheme page.

• The corresponding Engine versions are: 4.23-SpatialOSUnrealGDK-0.8.0-preview & 4.22-SpatialOSUnrealGDK-0.8.0-preview.
• The corresponding ExampleProject version is: 0.8.0-preview

This is the last GDK version to support Unreal Engine 4.22. You will need to upgrade your project to use Unreal Engine 4.23 (4.23-SpatialOSUnrealGDK-0.8.0-preview) in order to continue receiving GDK releases and support. Guidance for performing this upgrade can be found here.

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

You can read the full release notes here.

Happy developing!
GDK team

Unreal GDK version 0.6.4 is go!

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.6.4 The corresponding ExampleProject version is: 0.6.4

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

Bug fixes:

• The Inspector button in the SpatialOS GDK for Unreal toolbar now opens the correct URL.

Unreal GDK version 0.7.1-preview is go!

Note: this is a preview release. Preview releases are only tested against Improbable partner projects and have incomplete documentation. We do not recommend upgrading to this version unless you have production support from Improbable. We are preparing a public release including all these changes in the near future. For more details see the Versioning Scheme page.

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.7.1-preview The corresponding ExampleProject version is: 0.7.1-preview

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

Bug fixes:

• The C Worker SDK now communicates on port 443 instead of 444. This change is intended to protect your cloud deployments from DDoS attacks.

Internal:

Features listed in the internal section are not ready to use but, in the spirit of open development, we detail every change we make to the GDK.

• The GDK is now compatible with the CN launch region. When Improbable's online services are fully working in China, they will work with this version of the GDK. You will be able to create SpatialOS Deployments in China by specifying the CN region in the Deployment Launcher.
• Setup.bat and Setup.sh both accept the --china flag, which will be required in order to run SpatialOS CLI commands in the CN region.
• SpatialOS GDK for Unreal > Editor Settings now contains a Region Settings section. You will be required to set Region where services are located to CN in order to create SpatialOS Deployments in China.

Unreal GDK version 0.6.3 is go!

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.6.3 The corresponding ExampleProject version is: 0.6.3

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

Bug fixes:

• The C Worker SDK now communicates on port 443 instead of 444. This change is intended to protect your cloud deployments from DDoS attacks.

Internal:

Features listed in the internal section are not ready to use but, in the spirit of open development, we detail every change we make to the GDK.

• The GDK is now compatible with the CN launch region. When Improbable's online services are fully working in China, they will work with this version of the GDK. You will be able to create SpatialOS Deployments in China by specifying the CN region in the Deployment Launcher.
• Setup.bat and Setup.sh both accept the --china flag, which will be required in order to run SpatialOS CLI commands in the CN region.
• SpatialOS GDK for Unreal > Editor Settings now contains a Region Settings section. You will be required to set Region where services are located to CN in order to create SpatialOS Deployments in China.

Unreal GDK version 0.7.0-preview is go!

Note: this is a preview release. Preview releases are only tested against Improbable partner projects and have incomplete documentation. We do not recommend upgrading to this version unless you have production support from Improbable. We are preparing a public release including all these changes in the near future. For more details see the Versioning Scheme page.

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.7.0-preview The corresponding ExampleProject version is: 0.7.0-preview

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

New Known Issues:

• MSVC v14.23 removes typeinfo.h and replaces it with typeinfo. This change causes errors when building the Unreal Engine. This issue only affects Visual Studio 2019 users. You can work around the issue by:

1. Open Visual Studio Installer.
2. Select "Modify" on your Visual Studio 2019 installation.
3. In the Installation details section uncheck all workloads and components until only Visual Studio code editor remains.
4. Select the following items in the Workloads tab:

• Universal Windows Platform development
• .NET desktop development
• You must also select the .NET Framework 4.6.2 development tools component in the Installation details section.
• Desktop development with C++
• You must then deselect MSVC v142 - VS 2019 C++ x64/x86 build tools (v14.23), which was added as part of the Desktop development with C++ Workload. You will be notified that: "If you continue, we'll remove the componenet and any items liseted above that depend on it." Select remove to confirm your decision.
• Lastly, add MSVC v142 - VS 2019 C++ x64/x86 build tools (v14.22) from the Individual components tab.

5. Select "Modify" to confirm your changes.

Breaking Changes:

• If your project uses replicated subobjects that do not inherit from ActorComponent or GameplayAbility, you now need to enable generating schema for them using SpatialType UCLASS specifier, or by checking the Spatial Type checkbox on blueprints.
• Chunk based interest is no longer supported. All interest is resolved using query-based interest (QBI). You should remove streaming query and chunk based interest options from worker and launch config files to avoid unnecessary streaming queries being generated.
• If you already have a project that you are upgrading to this version of the GDK, it is encouraged to follow the upgrade process to SpatialOS 14.1.0:

1. Open the spatialos.json file in the spatial/ directory of your project.
2. Replace the sdk_version value and the version value of all dependencies with 14.1.0.
3. Replace all other instances of the version number in the file.

Features:

• The GDK now uses SpatialOS 14.1.0.
• Visual Studio 2019 is now supported.
• You can now delete your schema database using options in the GDK toolbar and the commandlet.
• The GDK now checks that schema and a snapshot are present before attempting to start a local deployment. If either are missing then an error message is displayed.
• Added optional net relevancy check in replication prioritization. If enabled, an actor will only be replicated if IsNetRelevantFor is true for one of the connected client's views.
• You can now specify which actors should not persist as entities in your Snapshot. You do this by adding the flag SPATIALCLASS_NotPersistent to a class or by entering NotPersistent in the Class Defaults > Spatial Description field on blueprints.
• Deleted startup actors are now tracked
• Added a user bindable delegate to SpatialMetrics which triggers when worker metrics have been received.
• Local deployments now create a new log file known as launch.log which will contain logs relating to starting and running a deployment. Additionally it will contain worker logs which are forwarded to the SpatialOS runtime.
• Added a new setting to SpatialOS Runtime Settings Worker Log Level which allows configuration of which verbosity of worker logs gets forwarded to the SpatialOS runtime.
• Added a new developer tool called 'Spatial Output Log' which will show local deployment logs from the launch.log file.
• Added logging for queued RPCs.
• Added several new STAT annotations into the ServerReplicateActors call chain.
• The GDK no longer generates schema for all UObject subclasses. Schema generation for Actor, ActorComponent and GameplayAbility subclasses is enabled by default, other classes can be enabled using SpatialType UCLASS specifier, or by checking the Spatial Type checkbox on blueprints.
• Added new experimental CookAndGenerateSchemaCommandlet that generates required schema during a regular cook.
• Added the OverrideSpatialOffloading command line flag. This allows you to toggle offloading at launch time.

Bug fixes:

• Fixed a bug where the spatial daemon started even with spatial networking disabled.
• Fixed an issue that could cause multiple Channels to be created for an Actor.
• PlayerControllers on non-auth servers now have BeginPlay called with correct authority.
• Attempting to replicate unsupported types (such as TMap) results in an error rather than crashing the game.
• Generating schema when the schema database is locked by another process will no longer crash the editor.
• When the schema compiler fails, schema generation now displays an error.
• Fixed crash during initialization when running GenerateSchemaCommandlet.
• Generating schema after deleting the schema database now correctly triggers an initial schema generation.
• Streaming levels with query-based interest (QBI) enabled no longer produces errors if the player connection owns unreplicated actors.
• Fixed an issue that prevented player movement in a zoned deployment.
• Fixed an issue that caused queued incoming RPCs with unresolved references to never be processed.
• Muticast RPCs that are sent shortly after an actor is created are now correctly processed by all clients.
• When replicating an actor, the owner's Spatial position will no longer be used if it isn't replicated.
• Fixed a crash upon checking out an actor with a deleted static subobject.

The release notes are published in both English and Chinese. To view the Chinese version, scroll down a bit for details. Thanks!

Release notes 将同时提供中英文。要浏览中文版本，向下滚动页面查看详情。感谢！

---

English version

Unreal GDK version 0.6.2 is go!

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.6.2 The corresponding ExampleProject version is: 0.6.2

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

• The GDK no longer relies on an ordering of entity and interest queries that is not guaranteed by the SpatialOS runtime.
• The multiserver offloading tutorial has been simplified and re-factored.

---

中文版本

Unreal GDK 0.6.2 版本已发布！

相应的引擎版本为 4.22-SpatialOSUnrealGDK-0.6.2 相应的 Example Project 版本为 0.6.2

确保按照 以下步骤 将 GDK、Engine 分支、Example Project 升级到最新版本。

祝编程愉快!

GDK 团队

Release notes 0.6.2

• Unreal GDK 不再根据 SpatialOS 运行时返回的顺序处理实体和兴趣查询响应，而是以其特定的顺序处理。
• 简化并调整 跨服负载拆分 (multiserver offloading) 教程。

The release notes are published in both English and Chinese. To view the Chinese version, scroll down a bit for details. Thanks!

Release notes 将同时提供中英文。要浏览中文版本，向下滚动页面查看详情。感谢！

---

English version

Unreal GDK version 0.6.1 is go!

The corresponding Engine version is: 4.22-SpatialOSUnrealGDK-0.6.1 The corresponding ExampleProject version is: 0.6.1

Follow these steps to upgrade your GDK, Engine fork and Example Project to the latest release.

Happy developing!
GDK team

Release notes

Features:

• The Multiserver zoning shooter tutorial has been updated to use the Example Project.

Bug fixes:

• Simulated player launch configurations are no longer invalid when the GDK is installed as an Engine Plugin.
• RPCs that have been queued for execution for more than 1 second (the default value in SpatialGDKSettings QueuedIncomingRPCWaitTime) are now executed even if there are unresolved parameters. This stops unresolved parameters from blocking the execution queue.
• Offloading is no longer enabled by default in the Example Project. You can toggle offloading on using these steps.
• Guns no longer intermittently detach from simulated players in the Example Project.
• Default cloud deployment settings are now correctly set. This means you don't need to manually reset them before doing a cloud deployment.

---

中文版本

Unreal GDK 0.6.1 版本已发布！

相应的引擎版本为 4.22-SpatialOSUnrealGDK-0.6.1 相应的 Example Project 版本为 0.6.1

确保按照 以下步骤 将 GDK、Engine 分支、Example Project 升级到最新版本。

祝编程愉快!

GDK 团队

Release notes 0.6.1

特性介绍:

• 更新了 跨服 (multiserver zoning) 射击教程 ，您可以使用 Example Project。

问题修复

• 当 GDK 作为引擎插件安装时，模拟玩家启动配置参数不再失效。
• 即使存在未解决的引用参数，队列中超过 1 秒 (SpatialGDKSettings QueuedIncomingRPCWaitTime 的默认值) 的 RPC 现会被执行。 这样，未解决的引用参数不会阻碍执行队列。
• Example Project 中的负载拆分 (offloading) 功能不再默认启动。您可以根据 以下步骤 开启该功能。
• Example Project 中的枪支不再会间歇性地与模拟玩家分离。
• 默认的云部署设置现已配置正确。这意味您在云部署前不需要手动重设。

Starting from Unreal GDK version 0.4.2, the release notes is published in both English and Chinese. To view the Chinese version, scroll down a bit for details. Thanks!

自从 Unreal GDK 0.4.2 版本开始，Release notes 将同时提供中英文。要浏览中文版本，向下滚动页面查看详情。感谢！

---

English version

Unreal GDK version 0.6.0 is go! The corresponding Engine versions are:

• Unreal Engine 4.22: 4.22-SpatialOSUnrealGDK-0.6.0
• Unreal Engine 4.20: 4.20-SpatialOSUnrealGDK-0.6.0

Make sure to upgrade your GDK and Engine fork to the latest release by following these steps.

Happy developing!
GDK team

Release notes 0.6.0

Breaking Changes:

• You must re-build your Example Project if you're upgrading it to 0.6.0.
• This is the last GDK version to support Unreal Engine 4.20. You will need to upgrade your project to use Unreal Engine 4.22 (4.22-SpatialOSUnrealGDK-release) in order to continue recieving GDK releases and support. See our Unreal Engine version support section for more details.

New Known Issues:

• Workers will sometimes not gain authority when quickly reconnecting to an existing deployment, resulting in a failure to spawn or simulate. When using the editor if you Play - Stop - Play in quick succession you can sometimes fail to launch correctly.

Features:

• The GDK now uses SpatialOS 13.8.1.
• Dynamic components are now supported. You can now dynamically attach and remove replicated subobjects to Actors.
• Local deployment startup time has been significantly reduced.
• Local deployments now start automatically when you select Play. This means you no longer need to select Start in the GDK toolbar before you select Play in the Unreal toolbar.
• If your schema has changed during a local deployment, the next time you select Play the deployment will automatically restart.
• Local deployments no longer run in a seperate Command Prompt. Logs from these deployments are now found in the Unreal Editor's Output Log.
• SpatialOS Runtime logs can now be found at <GameRoot>\spatial\logs\localdeployment\<timestamp>\runtime.log.
• An option to Show spatial service button has been added to the SpatialOS Settings menu. This button can be useful when debugging.
• Every time you open a GDK project in the Unreal Editor, 'spatial service' will be restarted. This ensures the service is always running in the correct SpatialOS project. You can disable this auto start feature via the new SpatialOS setting Auto-start local deployment.
• Added external schema code-generation tool for non-Unreal server-worker types. If you create non-Unreal server-worker types using the SpatialOS Worker SDK outside of the GDK and your Unreal Engine, you manually create schema. Use the new helper-script to generate Unreal code from manually-created schema; it enables your Unreal game code to interoperate with non-Unreal server-worker types.
• Added simulated player tools, which will allow you to create logic to simulate the behavior of real players. Simulated players can be used to scale test your game to hundreds of players. Simulated players can be launched locally as part of your development flow for quick iteration, as well as part of a separate "simulated player deployment" to connect a configurable amount of simulated players to your running game deployment.
• Factored out writing of Linux worker start scripts into a library, and added a standalone WriteLinuxScript.exe to just write the launch script (for use in custom build pipelines).
• Added temporary MaxNetCullDistanceSquared to SpatialGDKSettings to prevent excessive net cull distances impacting runtime performance. Set to 0 to disable.
• Added OnWorkerFlagsUpdated, a delegate that can be directly bound to in C++. To bind via blueprints you can use the blueprint callable functions BindToOnWorkerFlagsUpdated and UnbindToOnWorkerFlagsUpdated. You can use OnWorkerFlagsUpdated to register when worker flag updates are received, which allows you to tweak values at deployment runtime.
• RPC frequency and payload size can now be tracked using console commands: SpatialStartRPCMetrics to start recording RPCs and SpatialStopRPCMetrics to stop recording and log the collected information. Using these commands will also start/stop RPC tracking on the server.
• The GDK now respects bAlwaysRelevant and clients will always checkout Actors that have bAlwaysRelevant set to true.

Bug fixes:

• The improbable namespace has been renamed to SpatialGDK. This prevents namespace conflicts with the C++ SDK.
• Disconnected players no longer remain on the server until they time out if the client was shut down manually.
• Fixed support for relative paths as the engine association in your games .uproject file.
• RPCs on NotSpatial types are no longer queued forever and are now dropped instead.
• Fixed issue where an Actor's Spatial position was not updated if it had an owner that was not replicated.
• BeginPlay is now only called with authority on startup actors once per deployment.
• Fixed null pointer dereference crash when trying to initiate a Spatial connection without an existing one.
• URL options are now properly sent through to the server when doing a ClientTravel.
• The correct error message is now printed when the SchemaDatabase is missing.
• StartEditor.bat is now generated correctly when you build a server worker outside of editor.
• Fixed an issue with logging errored blueprints after garbage collection which caused an invalid pointer crash.
• Removed the ability to configure snapshot save folder. Snapshots should always be saved to <ProjectRoot>/spatial/snapshots. This prevents an issue with absolute paths being checked in which can break snapshot generation.
• Introduced a new module, SpatialGDKServices, on which SpatialGDK and SpatilGDKEditorToolbar now depend. This resolves a previously cyclic dependency.
• RPCs called before entity creation are now queued in case they cannot yet be executed. Previously they were simply dropped. These RPCs are also included in RPC metrics.
• RPCs are now guaranteed to arrive in the same order for a given actor and all of its subobjects on single-server deployments. This matches native Unreal behavior.

---

中文版本

Unreal GDK 0.6.0 版本已发布！

相应的引擎版本为:

• Unreal Engine 4.22: 4.22-SpatialOSUnrealGDK-0.6.0
• Unreal Engine 4.20: 4.20-SpatialOSUnrealGDK-0.6.0

确保按照 以下步骤 将 GDK 和 Engine 分支升级到最新版本。

祝编程愉快!

GDK 团队

Release notes 0.6.0

重大变化

• 如果您要将 GDK 升级至 0.6.0 版本，您必须 再次构建 您的 Example Project。
• 本次 GDK 版本是支持 Unreal Engine 4.20 的最后一个版本。请升级您的项目来使用 Unreal Engine 4.22(4.22-SpatialOSUnrealGDK-release)，这样您今后可以继续获取 GDK 新版本的发布内容与支持。更多细节，查看我们的 Unreal Engine 版本支持 。

新的已知问题

• 当 workers 快速重连到已有的部署中，workers 有时会无法获取修改权 (authority)，这会导致创建或模拟失败。当使用 Unreal 编辑器，如果您连续点击 Play - Stop - Play， 您有时可能无法正常启动游戏。

特性介绍

• GDK 现已使用 SpatialOS 13.8.1。
• 现已支持动态组件。您可以动态添加或是移除同步的 Actors 的子对象。
• 本地部署的启动时间大幅度缩减。
• 当你点击 Play，本地部署现可以自动启动。这意味着您在 Unreal 工具栏点击 Play 前，不需要在 GDK 工具栏点击 Start。
• 如果您的模式语言在本地部署中改变，下次您点击 Play，部署会自动重启。
• 本地部署不再在单独的命令窗口运行。您可以在 Unreal 编辑器的输出日志 (Output Log) 中找到本地部署的日志。
• 您可以在 <GameRoot>\spatial\logs\localdeployment\<timestamp>\runtime.log 中找到 SpatialOS 运行时日志。
• Show spatial service button （显示 spatial 服务按钮）的选项现已添加到 SpatialOS Settings 菜单。您可以在调试时使用该按钮。
• 每次您在 Unreal 编辑器中打开 GDK 项目，spatial service (spatial 服務) 都会重启。这确保该服务一直在正确的 SpatialOS 项目中运行。要停止该功能，您可以在 SpatialOS Settings 的 Auto-start local deployment 中禁用该功能。
• 添加了用于 非 Unreal 服务端 worker 的外部模式语言代码生成工具。如果您要使用 SpatialOS Worker SDK 来创建 Unreal 之外的 服务端 worker ，您需要手动创建 模式语言。使用新的 帮助脚本 从手动创建的模式语言中生成 Unreal 代码。这样，您的 Unreal 游戏代码可以与 非Unreal 类型的服务端 worker 互通。
• 添加了模拟玩家工具，您可以用来创建逻辑来模拟真实玩家的行为。模拟玩家可用于大规模测试您的游戏。您可以本地启动模拟玩家作为您开发流程中的一环，便于快速迭代。同时，您可以修改模拟玩家的人数，并应用到正在运行的游戏部署中。
• Linux worker 启动脚本以往是在整个构建流程中通过运行 BuildWorker.bat 生成，现在可以通过 WriteLinuxScript.exe 独立生成。WriteLinuxScript.exe 仅 用于编写启动脚本（用于自定义的构建流程）。
• 添加临时的 MaxNetCullDistanceSquared 到 SpatialGDKSettings 来防止过多的网络剔除距离 (net cull distances) 影响到运行时性能。设置 0 禁用该功能。
• 添加了 OnWorkerFlagsUpdated，可以直接绑定在 C++ 中。要通过 Blueprints 绑定，使用 Blueprints 函数BindToOnWorkerFlagsUpdated 和 UnbindToOnWorkerFlagsUpdated。您可以使用 OnWorkerFlagsUpdated 标记 worker flag 的更新，这样您可以在部署运行时微调值。
• 您可以通过控制台命令追踪 RPC 频率和消息包大小：SpatialStartRPCMetrics 用来开始记录 RPC，SpatialStopRPCMetrics 用来停止记录并将收集的信息记录到日志。使用这些命令同样可以开启/停止服务器上的 RPC 追踪。
• GDK 现已识别 bAlwaysRelevant 标记，客户端会自动获取 bAlwaysRelevant 设为 true 的 Actors。

问题修复

• 为了避免 improbable 命名空间与 C++ SDK 冲突，现已将命名空间变更为 SpatialGDK。
• 客户端手动关闭后，断开连接的玩家从服务器移除。
• 现已支持在项目的 uproject 文件中用相对路径关联到 Unreal 引擎的目录。
• NotSpatial 类型的 RPC 不再一直在队列上，而是被丢弃。
• 修复了当 Actor 的一个所有者没有被同步时，该 Actor 的 Spatial 位置不会被更新的问题。
• 在多服务器的部署中，每个服务器都会在 startup Actors 上调用 BeginPlay 方法，但只有一个服务器上的 Actor 的 Role 属性为 ROLE_Authority。
• 修复了当尝试在没有已有连接的情况下初始化 Spatial 连接时，空指针引用故障崩溃的问题。
• 当进行 ClientTravel，URL 方法现可以准确发送到服务器。
• 当 SchemaDatabase 不存在的时候，报错消息会正确显示。
• 当您在编辑器外构建服务器 worker，StartEditor.bat 可以正确生成。
• 修复了当出现 Blueprint 错误，模式语言生成时会导致无效的指针崩溃。
• 移除配置快照保存目录的功能。快照现只保存在 <ProjectRoot>/spatial/snapshots 目录。这避免了使用绝对路径会导致快照生成失败。
• 引入了新的模块 SpatialGDKServices，SpatialGDK 和 SpatilGDKEditorToolbar 依赖该模块。这解决了之前循环依赖问题。
• 在实体创建前调用的 RPC 现都会进入队列，以防他们无法被执行。之前，这些 RPC 只是被丢弃。这些 RPC 同样包含在 RPC 指标（metrics）中。
• 对于单个服务器部署上的同一个 Actor 以及其所有子对象，RPC 的抵达顺序一致。

Starting from Unreal GDK version 0.4.2, the release note is published in both English and Chinese. To view the Chinese version, scroll down a bit for details. Thanks! 自从 Unreal GDK 0.4.2 版本开始，Release note 将同时提供中英文。要浏览中文版本，向下滚动页面查看详情。感谢！
--------------------------------------------------------------------------------------------

English version

Unreal GDK version 0.4.2 is go! The corresponding Engine version is: 4.20-SpatialOSUnrealGDK-0.4.2 Note: there are no changes in the corresponding engine version between 0.4.0 and 0.4.2.

Make sure to upgrade your GDK and Engine fork to the latest release by following these steps.

After upgrading, be sure to delete<GameRoot>\Content\Spatial\SchemaDatabase.uasset. This is necessary because some GDK upgrades change how we handle schema, and this sometimes invalidates previously generated schema.

Happy developing!
GDK team

Release Notes 0.4.2

New Known Issues:

• BeginPlay() is not called on all WorldSettings actors #937
• Replicated properties within DEBUG or WITH_EDITORONLY_DATA macros are not supported #939
• Client connections will be closed by the ServerWorker when using Blueprint or C++ breakpoints during play-in-editor sessions #940
• Clients that connect after a Startup Actor (with bNetLoadOnClient = true) will not delete the Actor #941
• Generating schema while asset manager is asynchronously loading causes editor to crash #944

Bug fixes:

• Adjusted dispatcher tickrate to reduce latency
• GenerateSchemaAndSnapshots commandlet no longer runs a full schema generation for each map.
• Launching SpatialOS would fail if there was a space in the full directory path.
• Fixed an issue with schema name collisions.
• Fixed an issue where schema generation was not respecting "Directories to never cook".
• Fixed an issue causing the editor to crash during schema generation if the database is read only.

--------------------------------------------------------------------------------------------

中文版本

Unreal GDK 0.4.2 版本已发布！ 相应的引擎版本为: 4.20-SpatialOSUnrealGDK-0.4.2 注意：相应的引擎版本在 0.4.0 和 0.4.2 之间没有变化。

确保按照 以下步骤 将 GDK 和 Engine 分支升级到最新版本。

升级后，请务必删除 <GameRoot>\Content\Spatial\SchemaDatabase.uasset，这是因为部分 GDK 的更新会改变我们处理模式语言的方式，这有时会使先前生成的模式语言无效。

祝编程愉快!
GDK 团队

Release Notes 0.4.2

新的已知问题:

• BeginPlay() 无法在WorldSettings Actor 中被调用 #937
• 不支持在 DEBUG 或 WITH_EDITORONLY_DATA 宏中的属性复制 #939
• 在 play-in-editor 会话期间使用 Blueprint 或 C++ 断点时，ServerWorker 将关闭客户端连接 #940
• 在 Startup Actor (其中 bNetLoadOnClient = true) 之后连接的客户端将不会删除该 Startup Actor #941
• 在资产管理器异步加载时生成模式语言会导致编辑器崩溃 #944

修复的问题:

• 调整调度器的更新频率以减少延迟
• GenerateSchemaAndSnapshots 命令行工具不再为每个地图生成完整的模式语言
• 如果完整目录路径中有空格，那么启动 SpatialOS 将失败
• 修复了模式名称冲突的问题
• 修复了模式语言生成无视 "Directories to never cook" 的问题
• 修复了当数据库只读的情况下，导致编辑器在模式语言生成期间崩溃的问题

Unreal GDK version 0.4.1 is go! The corresponding Engine version is: 4.20-SpatialOSUnrealGDK-0.4.1 Note: there are no changes in the corresponding engine version between 0.4.0 and 0.4.1.

Make sure to upgrade your GDK and Engine fork to the latest release. Either use the 0.4.1 tagged commits or switch your projects to the release branches and git pull.

Make sure to run Setup.bat and regenerate your project files after upgrading!

Happy developing!
GDK team

Release Notes 0.4.1

Bug fixes:

• Fixed an issue where schema components were sometimes generated with incorrect component IDs.