Get SpatialOS



The Example Project

2: Launch a local deployment

When you want to try out your game, you need to run a deployment.

There are two types of deployment: local and cloud.

  • A local deployment launches your game with its own instance of SpatialOS, running on your development machine.
  • Cloud deployments run in the cloud on nodes. A node refers to a single machine used by a cloud deployment. When you have deployed your game, you can share it with other people and run your game at a scale not possible on a single machine. Once a cloud deployment is running, you can connect clients to it using the Launcher.

Use local deployments for small-scale tests, to quickly test and iterate on changes to your project. For large-scale tests with several players, use a cloud deployment.

For now, we’ll launch a local deployment with two clients to test the example project.

Before you launch a local deployment, you have to:

  • generate schema (which creates SpatialOS entities)
  • generate a snapshot

To launch a local deployment:

  1. In the Editor, on the GDK Toolbar, open the Schema drop-down menu and select Schema (Full Scan).
    Image: On the GDK toolbar in the Editor, select Schema (Full Scan)
  2. Select Snapshot to generate a snapshot.
    Image: On the GDK toolbar in the Editor select Snapshot
  3. Select Start. This opens a terminal window and starts a local SpatialOS deployment. Your game is ready to play when you see the output SpatialOS ready. Access the inspector at http://localhost:21000/inspector in your terminal window.
    Image: On the GDK toolbar in the Editor select Start
  4. On the Editor toolbar, open the Play drop-down menu.
  5. Under Multiplayer Options, set the number of players to 2 and ensure that the checkbox next to Run Dedicated Server is checked. (If it is unchecked, select the checkbox to enable it.)
    Multiplayer Options
    Image: The Unreal Engine Play drop-down menu, with Multiplayer Options and New Editor Window (PIE) highlighted
  6. Under Modes, select New Editor Window (PIE) to run the game. This starts one SpatialOS server-worker instance and two SpatialOS client-worker instances locally, in your Unreal Editor. The server-worker instance is acting as an Unreal server and the two client-worker instances are acting as two Unreal game clients (as would be used by two game players). You can switch between the two Editor windows to see and interact with each game client.
  7. If the game does not run automatically after selecting New Editor Window (PIE), on the Editor toolbar, select Play to run the game.
  8. When you’re done, select Stop in the GDK toolbar to stop your local SpatialOS deployment.
    Image: On the GDK toolbar in the Editor select Stop

    > Next: 3: Launch a cloud deployment

2019-05-21 Page added with editorial review

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums