Get SpatialOS



Get started: 2 - Build your workers

As you will be launching a cloud deployment, you need to build out the code executables which will be run by SpatialOS servers - these are called workers.

1. First, make sure burst compilation is disabled; from your Unity Editor menu, select Jobs and in the drop-down menu, make sure Enable Burst Compilation is unchecked. (If it is checked, select it to remove the check mark and disable it.)

2. Now build your workers from the Unity Editor’s SpatialOS menu by selecting SpatialOS > Build for cloud > All workers. (Shown below.)

SpatialOS menu in Unity
The SpatialOS menu in the Unity Editor

Building workers for the first time may take a while (about 10 minutes). Why not make yourself a cup of tea or check out our Youtube channel while you wait?

3. Your workers have finished building when: You see the following message in your Unity Editor’s Console window: Completed build for Cloud target.

After the build has successfully finished:
Your gdk-for-unity-fps-starter-project/build/assembly/worker folder should contain:


You may get a number of warnings displayed in your Unity Editor Console window. You can ignore the warnings at this stage.

If your build succeeded, you can now upload and launch your game. If you got build errors in Unity Editor Console window, check the Common build errors section below.

TIP: Speed up development iteration with worker quick-run
When you are developing with the GDK, you don’t need to build out workers all the time, you can use quick-run to run multiple workers in your Unity Editor using Ctrl+L (Windows) or Cmd+L (Mac).

This tutorial takes you through the steps to set up a cloud deployment. When you are developing with the GDK, you use a local deployment rather than a cloud deployment. In a local deployment, you can either build your workers to run locally or use quick-run. With quick-run you can run multiple workers in your Unity Editor, so you don’t have to keep building out workers during development iteration.

To use quick-run with the FPS Starter Project:

1. With your project open in your Unity Editor, on your computer’s keyboard, input Ctrl+L (Windows) or Cmd+L (Mac).
2. Wait until you see a message in the Editor’s Console window that SpatialOS is ready. The message is: SpatialOS ready. Access the inspector at http://localhost:21000/inspector.
3. In your Unity Editor, play the FPS-Development Scene.

Next: Upload and launch your game

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums