post header image for Working with in Unity 3D - Part 1 - Intro and App Structure

Working with in Unity 3D - Part 1 - Intro and App Structure

11th November 2014

This is part of a three-post series on working with in Unity. For more info please see the other posts in the series:

Part 1 - Intro and App Structure

Part 2 - Services, Helpers and Looming

Part 3 - Tests, Typescript and Common Code

For a while it has been my intention to follow up my work with in Unity, but other things have always gotten in the way and thus I have only just managed to get round to it.

Over the past 9 months of working with Parse I have encountered some pretty nasty issues which I decided to solidify by putting together this guide and sample project which I hope will help others out there!

But first..

What is is a backend as a service (BaaS). This means they take care of managing servers, operating systems, load balancing and all of that leaving you with a simple API that you can use to get what you need done.

I have been using Parse for most of my projects of late for a few reasons, mainly its ease of use (more of that later) and incredibly generous pricing:

2014-11-10_15-58-19 (thats about 77 million free API requests per month, per app!)

In comparison to the competition its much cheaper, Microsoft's Azure based Mobile Services for example:

2014-11-10_16-00-33 features a simple way to store..

[code lang="csharp"] var shield = new Armor { DisplayName = "Wooden Shield", IsFireproof = false, Rupees = 50 };

shield.SaveAsync(); [/code]

.. and retrieve data:

[code lang="csharp"] var query = new ParseQuery() .WhereLessThanOrEqualTo("rupees", ((Player)ParseUser.CurrentUser).Rupees); query.FindAsync().ContinueWith(t => { IEnumerable result = t.Result; }); [/code]

You can also have routines run on the server written using Javascript:

[code lang="javascript"] Parse.Cloud.define("averageStars", function(request, response) { var query = new Parse.Query("Review"); query.equalTo("movie",; query.find({ success: function(results) { var sum = 0; for (var i = 0; i < results.length; ++i) { sum += results[i].get("stars"); } response.success(sum / results.length); }, error: function() { response.error("movie lookup failed"); } }); }); [/code]

I wont go into the API any more here but their docs are pretty good and will explain things much better than me:

Parse Unity Sample Project

I have provided a simple Sample Project that hopefully should help with explaining how things work:


The source code for which can be found on github here.

Application Structure

Although has a Unity SDK that looks very simmilar to the .Net API, there are some pretty important differences which ill get into later.

Firstly, everyone's project structure is different and only experience and time will lead you to your own personal preference. For me, I like to setup my project folder like this:


One folder for the Unity project, one for the Backend and one Common library that is shared between the two.

If you use Visual studio this can all be set into one solution:


Frontend (ParseUnitySampleProject)

This is the Unity project, you can structure this how you like but I have provided a simple login / signup / logged in menus demo to show how I organise the libraries and code within it:



The common project contains code that is common to the frontend and backend. This is usually just models that represent the database, in this case its just a simple class GameUser:

[code lang="csharp"][parseclassname("_user")] public class GameUser : ParseUser {
[ParseFieldName("playerName")] public string PlayerName { get { return GetProperty("PlayerName"); } set { SetProperty(value, "PlayerName"); } }

public bool IsPlayerNameSet { get { return !String.IsNullOrEmpty(PlayerName); } }

} [/code]

Every time you build the common project the DLL that gets created is automatically copied into the game thanks to the build task:



The backend contains the code that will run on and the associated tests:


I like to use Typescript for my backend and so the project is a Typescript project mixed with C# for unit testing. I have provided my unfinished Typescript definition file for with the project:


To be continued..

In the next part of this post ill talk more about the specifics of how to interact with the API in Unity and some special helpers that I have developed to aid with that.