SpatialOS concepts: workers and zoning
Worker instances and worker types
In the same way that Unreal uses a single server and multiple clients, SpatialOS has server-worker instances and client-worker instances:
- SpatialOS uses one or more server-worker instances to compute your game world.
- Each player uses a client-worker instance to connect to and interact with your game world.
You can think of a worker type as a sort of mold for these worker instances. Worker types are what you write the code for; instances of these types manage and interact with the world. Each worker type has a worker configuration file (
For example, you could create a server-worker type called
UnrealWorker, and your deployment could have many instances of this worker type simulating the game world.
As outlined above, SpatialOS can use the combined computation of multiple server-worker instances to compute the game world. We call this zoning - splitting up the world into zones (areas of authority). Each zone is simulated by one server-worker instance. This means that the server-worker instances don’t know anything about each other - they might not even be on the same machine in the cloud.
So when you’re writing the code to define server-worker types, you set them up so that their worker instances only know about a specific part (or parts) of the world.
Image: Multiple server-worker instances spread across different machines
Tip: You can switch between Unreal networking and SpatialOS networking from the Unreal toolbar to speed up development iteration.
Using SpatialOS networking helps you isolate issues in your game that are related to having multiple server-worker instances.
However, using Unreal networking lets you iterate on development faster, because it means you can skip various steps (such as generating schema) when you want to test your changes.
SpatialOS hosts your games for you. We call an instance of a running game a deployment. In a deployment, SpatialOS starts server-worker instance(s) for you, running them on machines in the cloud. You don’t need to interact with the machines directly.
Image: A SpatialOS deployment, with connected worker instances
Because each client-worker instance is tied to a player, and runs on the player’s local machine, SpatialOS doesn’t manage a client-worker instance’s workload in the same way as it manages a server-worker instance’s workload. This means that during game development, you set up client-worker types and server-worker types differently. The main difference is around how you synchronize data to and from the game world. Like server-worker instances, client-worker instances can only see a part of the world. However, client-worker instances can see across server-worker instance boundaries.
Image: A client-worker instance can “see” nearby entities, regardless of the boundaries between server-worker instances
—— 2019-07-31 Page updated with limited editorial review 2019-05-21 Page added with editorial review