spatial

# SpatialOS: Build worlds where everything matters.

SpatialOS is a computation platform that allows you to exceed the power of a single game engine or server.

## Code Beyond Server Boundaries

SpatialOS can create a swarm of hundreds of conventional game engines that overlap together to create a huge, seamless world. Develop unconstrained by the computational and concurrent player limits of a single engine.

## Grow a Persistent World

A SpatialOS world can contain millions of persistent entities and manage their state and history. Design gameplay that allows players to affect the world in meaningful, long-lasting ways.

## Deploy Fast, Iterate Fast

Use just a few CLI commands to run your world on the SpatialOS Platform, then instantly share with players. SpatialOS handles all infrastructure management and data synchronization for you, greatly increasing the speed at which you can build and grow your online world.

## `spatial` toolbelt

The `spatial` toolbelt is a command line toolchain that allows you to build and manage your SpatialOS simulations locally and in the cloud.

Note: `spatial` toolbelt has its own internal update mechanism. This package just bootstraps the toolbelt onto your computer.

## SpatialOS SDK

The SDK has a number of dependencies on things like a JDK and Unity being installed. Once you have installed spatial you can set those up via spatial setup install-dependencies --version {SDK version}.

## Package parameters

Supply like `--params="/option:'value' ..."` ([see docs for --params](https://github.com/chocolatey/choco/wiki/CommandsInstall#options-and-switches))

* `cliStructureVersion` (optional, defaults to `v2`) - The `cliStructureVersion` that you're intending to use. This affects the layout of commands within the toolbelt. There should be no reason to set this other than to try out new versions ahead of their being generally released.

You can change this later via `spatial config set cli-structure {version}`.

You can get the current value via `spatial config get cli-structure`.

* `region` (optional, defaults to `west`) - The `region` you want to download spatialOS CLI from. The available options are `west` and `china`.