initial release of the Starter Project for SpatialOS

Author: johnprobable

.gitignore

@@ -0,0 +1,4 @@
+spatial.log
+spatialos_worker_packages.json
+build/
+logs/

README.md

@@ -1,2 +1,26 @@
-# StarterProject
-This is a SpatialOS starter project with useful core features that you can extend to build your own SpatialOS application
+# Starter Project
+---
+
+*Copyright Improbable Worlds Ltd, 2017*
+
+- *GitHub repository*: [https://github.com/spatialos/StarterProject](https://github.com/spatialos/StarterProject)
+
+---
+
+## Introduction
+
+This is a SpatialOS starter project with useful core features that you can extend to build your own SpatialOS application.
+
+It contains:
+
+* A Player spawned on client connection as per the [Unity Client Lifecycle Guide](https://spatialos.improbable.io/docs/reference/latest/tutorials/client-lifecycle).
+* A Cube spawned through a snapshot via an entity template method and an Unity prefab.
+* The rest of the features included in the [BlankProject](https://github.com/spatialos/BlankProject).
+
+If you run into problems, or want to give us feedback, please visit the [SpatialOS forums](https://forums.improbable.io/).
+
+## Running the project
+
+To run the project locally, first build it by running `spatial worker build`, then start the server with `spatial local start`. You can connect a client by opening the Unity project and pressing the play button, or by running `spatial local worker launch UnityClient default`. See the [documentation](https://spatialos.improbable.io/docs/reference/latest/developing/local/run) for more details.
+
+To deploy the project to the cloud, first build it by running `spatial worker build -t=deployment`, then upload the assembly with `spatial cloud upload <assembly name>`, and finally deploy it with `spatial cloud launch <assembly name> <launch configuration file> <deployment name> --snapshot=<snapshot file>`. You can obtain and share links to connect to the deployment from the [console](http://console.improbable.io/projects). See the [documentation](https://spatialos.improbable.io/docs/reference/latest/developing/deploy-an-application) for more details.

default_launch.json

@@ -0,0 +1,43 @@
+{
+  "template": "small",
+  "world": {
+    "chunkEdgeLengthMeters": 50,
+    "snapshots": {
+      "snapshotWritePeriodSeconds": 0
+    },
+    "dimensions": {
+      "xMeters": 1500,
+      "zMeters": 1500
+    }
+  },
+  "workers": [
+    {
+      "worker_type": "UnityWorker",
+      "load_balancing": {
+        "auto_hex_grid": {
+          "num_workers": 1
+         }
+      },
+      "permissions": [{
+        "all": {}
+      }]
+    },
+    {
+      "worker_type": "UnityClient",
+      "permissions": [{
+        "entity_creation": {
+          "allow": false
+        },
+        "entity_deletion": {
+          "allow": false
+        },
+        "entity_query": {
+          "allow": true,
+          "components": [
+              "*"
+          ]
+        }
+      }]
+    }
+  ]
+}

schema/improbable/global/ClientAuthorityCheck.schema

@@ -0,0 +1,5 @@
+package improbable.global;
+
+component ClientAuthorityCheck {
+  id = 1002;
+}

schema/improbable/global/PlayerCreation.schema

@@ -0,0 +1,9 @@
+package improbable.global;
+
+type CreatePlayerRequest {}
+type CreatePlayerResponse {}
+
+component PlayerCreation {
+  id = 1001;
+  command CreatePlayerResponse create_player(CreatePlayerRequest);
+}

schema/improbable/global/Quaternion.schema

@@ -0,0 +1,8 @@
+package improbable.global;
+
+type Quaternion {
+  float x = 1;
+  float y = 2;
+  float z = 3;
+  float w = 4;
+}

schema/improbable/global/WorldTransform.schema

@@ -0,0 +1,9 @@
+package improbable.global;
+
+import "improbable/global/Quaternion.schema";
+
+component WorldTransform {
+    id = 1000;
+    EntityPosition position = 1;
+    improbable.global.Quaternion rotation = 2;
+}

schema/improbable/player/ClientConnection.schema

@@ -0,0 +1,14 @@
+package improbable.player;
+
+type ClientDisconnectRequest{}
+type ClientDisconnectResponse{}
+
+type HeartbeatRequest{}
+type HeartbeatResponse{}
+
+component ClientConnection {
+  id = 1003;
+  uint32 timeout_beats_remaining = 1;
+  command HeartbeatResponse heartbeat(HeartbeatRequest);
+  command ClientDisconnectResponse disconnect_client(ClientDisconnectRequest);
+}