The Example Project
4: Play the game
To get playing, you use SpatialOS Launcher to set up clients for users. You then share the clients with users via a dedicated URL.
Reminder: What is the SpatialOS Launcher?
The Launcher is a distribution tool which downloads and launches game clients for your deployment. You installed the Launcher when you installed SpatialOS on your machine. You access the Launcher from the Console; use it to create a URL to give end-users access to a game client for your game. Find out more in the glossary.
Step 1: Set up a game client using the Launcher
- Open the SpatialOS Console at console.improbable.io to see a list of your SpatialOS cloud projects.
The list looks something like this:
Image: The Console home screen project list
- Select your SpatialOS cloud project name to see a list of deployments associated with that cloud project. (In this example, the cloud project name is
gdc2019_demo.) The list looks something like this:
Image: The Console project screen deployment list
Select your deployment name to see its overview screen. The deployment overview screen looks something like this (but won’t have a Restart button):
Image: The Console deployment overview screen
Now start a deployment run. To do this:
- Locate the screen’s Start button near the top (the example above has a Restart button - this is where you find the Start button). Select it to open the Start deployment dialogue box.
- In the Start deployment dialog box, select Start - this starts a deployment run.
Now the deployment is running, you see three buttons near the top of the deployment overview screen:
Image: The Console deployment overview screen showing the blue Launch button to access the Launcher.
Use the Launcher to get a game client. To do this:
- In the deployment overview screen, select the blue Launch button to open the Launcher dialog box.
It looks like this:
Image: The Console’s Launcher dialog box
- Select Launch in the Launcher dialog box to download a game client.
- In the deployment overview screen, select the blue Launch button to open the Launcher dialog box. It looks like this:
Step 2: Share your game
To share your cloud deployment:
- In the Console, go to the deployment overview screen.
The screen has this near the top:
Image: The Console deployment overview screen showing the white Share button
- Select Share to open the Share Application screen.
- In the Share Application screen, check the box to accept the terms and conditions and select Get Share URL.
Image: The Console Share Application terms of service screen
- You can now see a URL, which is a token to download a game client. You can share this with game testers so they can try out your game.
Image: The Console Share Application screen
You’ve successfully set up and launched the Starter Template and the GDK! You are now ready to start developing a game with SpatialOS.
If you have an existing Unreal multiplayer project, follow our detailed porting guide to get it onto the GDK.
2019-08-14 Page updated with editorial review: new Console screens 2019-07-16 Page updated with editorial review.