There are two toolbars you can use in the Unreal Editor: the main Unreal toolbar, and the SpatialOS GDK toolbar. Once enabled, the GDK toolbar sits alongside the main Unreal toolbar:
<ProjectRoot> - The root folder of your Unreal project.
<GameRoot> - The folder containing your project’s
.uproject and source folder (for example,
Alongside the standard functionality, we’ve added some extra capabilities to the Unreal toolbar under the Play drop-down menu to help with debugging your game:
- The Unreal<->SpatialOS networking switch
- The “Number of Servers” multiplayer option
- The “SpatialOS Settings” menu item which opens the SpatialOS settings
Switching between native Unreal networking and SpatialOS networking
To switch from using Unreal networking to using SpatialOS networking, open the Play drop-down menu and check two checkboxes:
- Run Dedicated Server
- Spatial Networking
These settings are valid for Editor and command-line builds. They’re stored in your project’s Unreal config file,
You can switch back by unchecking the boxes.
Warning: As the GDK is in alpha, switching back to Unreal default networking mode can be a useful way to debug and so speed up your development iteration. However, you lose access to the multiserver features of the GDK in Unreal default networking mode which may lead to erratic behavior.
Auto-generated launch config for PIE server-worker types
You can launch multiple servers at the same time from within the Unreal Editor in PIE (Unreal documentation) configuration. To configure the number of servers launched, open the Play drop-down menu and use the slider
Number of Servers within the
Multiplayer Options section.
If you want to connect multiple server-worker instances to SpatialOS, you need to tell SpatialOS how many instances to connect. You do this in the load balancing section of the launch configuration file (
This uses the
rectangle_grid strategy with 1 column and 1 row. To connect 2 servers, change this to 1 column and 2 rows (or vice-versa). Read more about the different kinds of load balancing strategies here.
SpatialOS GDK for Unreal toolbar
The GDK toolbar provides several functions required for building and launching your client and server-workers from inside the Unreal Editor.
Add the GDK toolbar to your Unreal project
Note: If you based your project off the Starter Template, the toolbar is already enabled.
To enable the GDK toolbar, navigate to Edit > Plugins inside the Unreal Editor and scroll down to the bottom. Select the SpatialOS section and enable the toolbar:
The GDK toolbar has five features mapped to individual buttons and is displayed in the main editor toolbar to the right of the
You can also access these from the Window menu:
|Snapshot||Generates a SpatialOS snapshot.|
|Schema||Creates schema for your Unreal project.|
|Inspector||Opens the Inspector in a browser.|
The toolbar settings are in Edit > Project Settings > SpatialOS GDK for Unreal > Settings.
|SpatialOS directory||If you’re using a non-standard structure, you’ll need to set this yourself. This is empty by default. If you leave it empty, it defaults to
Play In Editor Settings
|Delete dynamically spawned entities||If checked, the GDK deletes any dynamically spawned entities from your local SpatialOS deployment when you end the PIE session.|
|Command line flags for local launch||Command line flags passed in to
|Launch configuration||The launch configuration file to use when running
|Stop on exit||If checked, shuts down running deployments when you close the Unreal Editor.|
|Generate default launch config||If checked, the GDK creates a launch configuration file by default when you launch a local deployment through the toolbar.|
|Launch configuration description||Auto-generated launch configuration description. The settings expose the configurations in the launch config documentation.|
|Snapshot path||Use this to specify the filepath of your snapshot. If you leave this empty, it defaults to
|Snapshot file name||Name of your snapshot file.|
|Generate placeholder entities in snapshot||If checked, the GDK adds placeholder entities to the snapshot when it is generated|
|Output path for the generated schemas||Use this to specify the path of the generated schema files. If you leave this empty, it defaults to
2019-06-27 Page updated with limited editorial review