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:
Once the client has launched, enter a name for your player character and select Start to start playing.
Image: The Example project lobby screen
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
Congratulations! You’ve sucessfully set up and launched the Example Project using the Deployment Manager. You are now ready to start developing your own games with SpatialOS. Next steps:
Do more with the Example Project: follow the tutorial on setting up multiple deployments for session-based games using the Example Project.
If you have an existing Unreal multiplayer project, you can follow the detailed porting guide to get it onto the GDK.
If you want to start a project from scratch, follow the set up guide for the Starter Template to set up a blank project using the GDK.
2019-08-14 Page updated with editorial review: new Console screens 2019-05-23 Page added with editorial review