Booty5 HTML5 Game Maker 1.9.3b out now – Droidscript support added

It has been a long while since I released an update of Booty5, but at last it is here. A good fellow over at Droidscript got in touch to let me know that they had added a plugin for their awesome app (check it out to see what I mean by awesome) which enables developers to develop games using the Booty5 API directly on an Android device and / or via a desktop browser, which to me is coolness of a higher degree. I had planned a release of Booty5 to push out the latest changes to the engine as well as support for texture packer trimmed bitmaps amongst other things so I went ahead and interfaced the Booty5 editor directly with the Droidscript app allowing games to be sent directly to Droidscript and played on the device. This provides a very rapid development environment directly on device.

The changes for this release include:

  • By setting the host in project settings to the wifi address supplied to you by the Droidscript app and checking the Droidscript checkbox, you can run your projects directly on a connected Android device
  • Updated to the very latest Booty5 engine which includes support for features like tasks, events and smaller exported scene data
  • Open in IDE no longer opens in WebStorm by default, instead Visual Studio Code is used
  • Projects no longer deploy separate source files, instead booty5_debug.js or booty5_min.js are deployed
  • Socket.io can now be exported with projects
  • New export location added to project properties that allows you to specify where deployed files will go when running / testing
  • Host project property added which allows deployed projects to launch a specific host url when running / testing
  • Added two new canvas fit modes, Fit Greatest / Fit Smallest
  • Added Body and Head properties to project properties, additional html can be added here to be exported in the body and head sections of the html file
  • Added nodejs command prompt button
  • Fixed crash bug when creating a label with no font
  • Added animation sets to brushes
  • Removed animation frames, start frame and playback speed from actors, you now specify the animation name to play as default
  • Get actor size will now get brush size if no geometry attached

Note that the Booty5 plugin for Droidscript is currently in beta (see the beta group for more details.)

The manual and API documentation have also been updated so please don’t forget to view / grab them.

The changes to the Booty5 engine v1.5.2 include:

  • Added support for events and event notification (see b5.EventsManager)
  • Added support for tasks (see b5.TasksManager)
  • Added support to brushes for animation sets
  • Added support to actors for working with brush animation sets (see b5.Actor.playAnim)
  • Bitmap based actors now support trimmed atlas images
  • Image based actors that use an atlas will use the size of the atlas frame, can be overridden by setting ignore_atlas_size to true
  • Removed support for web Marmalade
  • All booty5 scene data is now loaded into the b5.data space instead of window
  • Xoml data property names have been minified to greatly cut down Xoml datas format storage size
  • Added polyfill for RequestAnimationFrame to support older browsers
  • Some examples have been updated to fix various issues

Booty5 is a free Javascript based HTML5 game engine available on Github and a fully fledged game / app editor available for free. See the Booty5 HTML5 game maker website for more details.

Happy coding, don’t forget to leave feedback and report issues on Facebook / Google+ etc…

Colour Cycle Effect Unity Shader

Just added a new colour cycle effect transparent Unity shader to the free shaders collection. This shader can be used to overlay a y-axis colour cycle effect over a texture

The code for the shader is shown below:

Shader "Unlit/ColourCycleTexture"
{
	Properties
	{
		_MainTex("Color (RGB) Alpha (A)", 2D) = "white" {}
		_WaveSpeed ("WaveSpeed", Range(-1000, 1000)) = 20
		_Frequency ("Frequency", Range(0, 100)) = 10
		_Amplitude ("Amplitude", Range(0, 3)) = 0.02
		_RedScale("Red Scale", Range(0, 3)) = 1
		_GreenScale("Green Scale", Range(0, 3)) = 1
		_BlueScale("Blue Scale", Range(0, 3)) = 1
	}
	SubShader
	{
		Tags{ "Queue" = "Transparent" "RenderType" = "Transparent" }
		Blend SrcAlpha OneMinusSrcAlpha
		LOD 100

		Pass
		{
			CGPROGRAM
			#pragma vertex vert
			#pragma fragment frag

			#include "UnityCG.cginc"

			struct appdata
			{
				float4 vertex : POSITION;
				float2 uv : TEXCOORD0;
			};

			struct v2f
			{
				float2 uv : TEXCOORD0;
				float4 vertex : SV_POSITION;
			};

			sampler2D _MainTex;
			float4 _MainTex_ST;
			fixed _Frequency;
			fixed _WaveSpeed;
			fixed _Amplitude;
			fixed _RedScale;
			fixed _GreenScale;
			fixed _BlueScale;

			v2f vert (appdata v)
			{
				v2f o;
				o.vertex = mul(UNITY_MATRIX_MVP, v.vertex);
				o.uv = TRANSFORM_TEX(v.uv, _MainTex);
				return o;
			}

			fixed4 frag (v2f i) : SV_Target
			{
				fixed2 uvs = i.uv;
				fixed4 col = tex2D(_MainTex, uvs);
				fixed d = sin(uvs.y * _Frequency + _Time * _WaveSpeed) * _Amplitude;
				col.r += d * _RedScale;
				col.g += d * _GreenScale;
				col.b += d * _BlueScale;
				return col;
			}
			ENDCG
		}
	}
}

The shader works by adjusting the colour of the texel pulled from the texture applying a wave effect which is then scaled by red, green and blue scaling factors which can be used to change the colour of the overlaid effect. Here are a few parameters to try:

Produce a nice upwards red scroll effect:
Wave Speed – -150
Frequency – -20
Amplitude – -1
Red Scale – 0
Green Scale – 0.4
Blue Scale – 0

Produce a slow flash:
Wave Speed – 150
Frequency – 1
Amplitude – 1
Red Scale – 0
Green Scale – 0.4
Blue Scale – 0

You may need to adjust the red, green and blue scaling factors to match the colour of your texture.

Wavy Text Unity Shader

Just added a new wavy transparent shader to the free shaders collection. This shade can be used to apply x and y axis waves to textures which looks nice on bitmapped based text, e.g.:

Wavy Transparent Unity Shader

Wavy Transparent Unity Shader

The code for the shader is shown below:

Shader "Unlit/WaveTransTexture"
{
	Properties
	{
		_MainTex("Color (RGB) Alpha (A)", 2D) = "white" {}
		_WaveSpeedX ("X Axis WaveSpeed", Range(0, 100)) = 20
		_FrequencyX ("X Axis Frequency", Range(0, 100)) = 10
		_AmplitudeX ("X Axis Amplitude", Range(0, 100)) = 0.02
		_WaveSpeedY ("Y Axis WaveSpeed", Range(0, 100)) = 20
		_FrequencyY ("Y Axis Frequency", Range(0, 100)) = 10
		_AmplitudeY ("Y Axis Amplitude", Range(0, 100)) = 0.02
	}
	SubShader
	{
		Tags{ "Queue" = "Transparent" "RenderType" = "Transparent" }
		Blend SrcAlpha OneMinusSrcAlpha
		LOD 100

		Pass
		{
			CGPROGRAM
			#pragma vertex vert
			#pragma fragment frag

			#include "UnityCG.cginc"

			struct appdata
			{
				float4 vertex : POSITION;
				float2 uv : TEXCOORD0;
			};

			struct v2f
			{
				float2 uv : TEXCOORD0;
				float4 vertex : SV_POSITION;
			};

			sampler2D _MainTex;
			float4 _MainTex_ST;
			fixed _FrequencyX;
			fixed _AmplitudeX;
			fixed _WaveSpeedX;
			fixed _FrequencyY;
			fixed _AmplitudeY;
			fixed _WaveSpeedY;

			v2f vert (appdata v)
			{
				v2f o;
				o.vertex = mul(UNITY_MATRIX_MVP, v.vertex);
				o.uv = TRANSFORM_TEX(v.uv, _MainTex);
				return o;
			}

			fixed4 frag (v2f i) : SV_Target
			{
				fixed2 uvs = i.uv;
				uvs.x += sin(uvs.y * _FrequencyX + _Time * _WaveSpeedX) * _AmplitudeX;
				uvs.x = (uvs.x * 0.9) + 0.05;
				uvs.y += cos(uvs.x * _FrequencyY + _Time * _WaveSpeedY) * _AmplitudeY;
				uvs.y = (uvs.y * 0.9) + 0.05;
				fixed4 col = tex2D(_MainTex, uvs);
				return col;
			}
			ENDCG
		}
	}
}

The code works by applying a sine wave to the y-axis source texture coordinate and pumping that into the x-axis texture coordinate, a similar thing is done with the x-axis source texture coordinate, except that a cosine wave is applied to it. Note that when using this shader you should leave a little space around the bitmap text (around 10% of the image size) to prevent borders from showing.

Creating a Unity leaderboard using node.js and redis

I’ve recently added a new node.js based leaderboard system for Unity to Github. I’m going to use something like this in my next game which will feature global leaderboards as a major focus of the game.You can grab the code from Github.

Let start by taking a look at what the repo contains:

Node.js Server

The server side code is written in JavaScript using Node.js with Redis for super fast storage. To use this code you will need a web server that allows you to host your own node.js scripts. There are plenty of super cheap VPS providers around these days so if you go that route take a look at my article on installing node on your own VPS here. You will also need Redis, take a look at my article on installing Redis here.

Once you have everything installed and setup, run main.js located in the Server folder to set the leaderboards server off going:


node main.js

Once running, the server will be listening for connections from Unity on the default port which is set in server.js.

The entire leaderboards service consists of 3 files:

  • server.js – The web server which interacts with the Uniy app
  • leaderboard.js – The leaderboard code which communicates with Redis to store an retrieve persistent data
  • main.js – A main file to create the server and set it off running

The code in server,js is straight forward and much of it was already covered in this article here. The main changes include dealing with data hiding, we now pass the data base64 encoded via the d parameter:

var vars = body.split("=");
if (vars[0] == "d")
{
	var data = Buffer.from(vars[1], "base64");
	console.log("Data: " + data);
	this.processCommand(data.toString(), res);
}

Here we decode the base 64 string data then pass it on to be processed. This enables me to encrypt the data at the other end then decrypt it when it arrives at this end (not covered in this article), this will allow me to hide what is sent and minimise the chance that someone spams my leaderboards with fake data.

The next major change is to handle commands that are passed to the server, to allow the client to perform different actions such as submit a score or get the users rank etc..

leaderboard.js was added to take care of all actions that are related to dealing with the actual leaderboard data, such as chatting to Redis about what to do with the data. The leaderboard class handles all of this including pushing multiple commands to Redis in one go instead of sending them separately to speed things up. For example sending scores to multiple leaderboards at the same time:

setUserScores(userName, scores, cb)
{
	var multi = this.client.multi();
	for (var t = 1; t < this.MAX_BOARDS + 1; t++)
	{
		var name = this.boardName + ":" + t;
		if (scores[t - 1] > 0 && scores[t - 1] < this.MAX_SCORE)
			multi.zadd([name, scores[t - 1], userName]);
	}
	multi.exec((err, replies) =>
	{
		if (cb) cb(err);
	});
}

Here we issue many zadd commands to redis at the same time.

Unity Client

The Unity client code is implemented in Leaderboards.cs located in the Client folder. Lets take a quick look at the code:

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
using System;
using System.Text;

public class Leaderboards : MonoBehaviour
{
    public const int RANK_INVALID = -1; // The rank is invalid

    private static string _Url = "http://localhost";
    private static string _Port = "8080";

    // Submits users score to the server.
    //
    // @param which             Leaderboard index to submit score to
    // @param score             Score to submit
    // @param userName          Name of user to submit score for
    // @param OnScoreSubmitted  Callback to call when operation completes or fails, a bool is passed to the callback which
    //                          is true if an error occurred or false if not
    //
    public void SubmitScore(int which, int score, string userName, Action<bool> OnScoreSubmitted)
    {
        StartCoroutine(SubmitScoreToServer(which, score, userName, OnScoreSubmitted));
    }

    private IEnumerator SubmitScoreToServer(int which, int score, string userName, Action<bool> OnScoreSubmitted)
    {
        Debug.Log("Submitting score");

        // Create a form that will contain our data
        WWWForm form = new WWWForm();
        StringBuilder sb = new StringBuilder("m=score");
        sb.Append("&w=");
        sb.Append(which.ToString());
        sb.Append("&s=");
        sb.Append(score.ToString());
        sb.Append("&n=");
        sb.Append(userName);
        byte[] bytes = Encoding.UTF8.GetBytes(sb.ToString());
        form.AddField("d", Convert.ToBase64String(bytes));

        // Create a POST web request with our form data
        UnityWebRequest www = UnityWebRequest.Post(_Url + ":" + _Port, form);
        // Send the request and yield until the send completes
        yield return www.Send();

        if (www.isError)
        {
            // There was an error
            Debug.Log(www.error);
            if (OnScoreSubmitted != null)
                OnScoreSubmitted(true);
        }
        else
        {
            if (www.responseCode == 200)
            {
                // Response code 200 signifies that the server had no issues with the data we sent
                Debug.Log("Score send complete!");
                Debug.Log("Response:" + www.downloadHandler.text);
                if (OnScoreSubmitted != null)
                    OnScoreSubmitted(false);
            }
            else
            {
                // Any other response signifies that there was an issue with the data we sent
                Debug.Log("Score send error response code:" + www.responseCode.ToString());
                if (OnScoreSubmitted != null)
                    OnScoreSubmitted(true);
            }
        }
    }

    // Submits a collection of scores to the server.
    //
    // @param scores            Scores to submit, once score per leaderboard
    // @param userName          Name of user to submit score for
    // @param OnScoresSubmitted Callback to call when operation completes or fails, a bool is passed to the callback which
    //                          is true if an error occurred or false if not
    //
    public void SubmitScores(int[] scores, string userName, Action<bool> OnScoresSubmitted)
    {
        StartCoroutine(SubmitScoresToServer(scores, userName, OnScoresSubmitted));
    }

    private IEnumerator SubmitScoresToServer(int[] scores, string userName, Action<bool> OnScoresSubmitted)
    {
        Debug.Log("Submitting scores");

        WWWForm form = new WWWForm();
        StringBuilder sb = new StringBuilder("m=scores");
        sb.Append("&a=");
        for (int t = 0; t < scores.Length; t++)
        {
            sb.Append(scores[t].ToString());
            if (t < scores.Length - 1)
                sb.Append(",");
        }
        sb.Append("&n=");
        sb.Append(userName);
        byte[] bytes = Encoding.UTF8.GetBytes(sb.ToString());
        form.AddField("d", Convert.ToBase64String(bytes));

        UnityWebRequest www = UnityWebRequest.Post(_Url + ":" + _Port, form);
        yield return www.Send();

        if (www.isError)
        {
            Debug.Log(www.error);
            if (OnScoresSubmitted != null)
                OnScoresSubmitted(true);
        }
        else
        {
            if (www.responseCode == 200)
            {
                Debug.Log("Scores sent complete!");
                Debug.Log("Response:" + www.downloadHandler.text);
                if (OnScoresSubmitted != null)
                    OnScoresSubmitted(false);
            }
            else
            {
                Debug.Log("Scores sent error response code:" + www.responseCode.ToString());
                if (OnScoresSubmitted != null)
                    OnScoresSubmitted(true);
            }
        }
    }

    // Gets the user rank from the server.
    //
    // @param which             Leaderboard index to submit score to
    // @param score             Score to submit
    // @param userName          Name of user to submit score for
    // @param OnScoreSubmitted  Callback to call when operation completes or fails, an int is passed to the callback which
    //                          represents the users rank
    //
    public void GetRank(int which, string userName, Action<int> OnRankRetrieved)
    {
        StartCoroutine(GetRankFromServer(which, userName, OnRankRetrieved));
    }

    private IEnumerator GetRankFromServer(int which, string userName, Action<int> OnRankRetrieved)
    {
        Debug.Log("Getting rank");

        WWWForm form = new WWWForm();
        StringBuilder sb = new StringBuilder("m=rank");
        sb.Append("&w=");
        sb.Append(which.ToString());
        sb.Append("&n=");
        sb.Append(userName);
        byte[] bytes = Encoding.UTF8.GetBytes(sb.ToString());
        form.AddField("d", Convert.ToBase64String(bytes));

        UnityWebRequest www = UnityWebRequest.Post(_Url + ":" + _Port, form);
        yield return www.Send();

        if (www.isError)
        {
            Debug.Log(www.error);
            if (OnRankRetrieved != null)
                OnRankRetrieved(RANK_INVALID);
        }
        else
        {
            if (www.responseCode == 200)
            {
                Debug.Log("Get rank complete!");
                Debug.Log("Response:" + www.downloadHandler.text);
                if (OnRankRetrieved != null)
                {
                    int rank = RANK_INVALID;
                    int.TryParse(www.downloadHandler.text, out rank);
                    OnRankRetrieved(rank);
                }
            }
            else
            {
                Debug.Log("Get rank error response code:" + www.responseCode.ToString());
                if (OnRankRetrieved != null)
                    OnRankRetrieved(RANK_INVALID);
            }
        }
    }

    // Gets the users ranks from the server.
    //
    // @param userName          Name of user to submit score for
    // @param OnRanksRetrieved  Callback to call when operation completes or fails, callback has an array of ints, with
    //                          each element representing a leaerboard rank
    //
    public void GetRanks(string userName, Action<int[]> OnRanksRetrieved)
    {
        StartCoroutine(GetRanksFromServer(userName, OnRanksRetrieved));
    }

    private IEnumerator GetRanksFromServer(string userName, Action<int[]> OnRanksRetrieved)
    {
        Debug.Log("Getting ranks");

        WWWForm form = new WWWForm();
        StringBuilder sb = new StringBuilder("m=ranks");
        sb.Append("&n=");
        sb.Append(userName);
        byte[] bytes = Encoding.UTF8.GetBytes(sb.ToString());
        form.AddField("d", Convert.ToBase64String(bytes));

        UnityWebRequest www = UnityWebRequest.Post(_Url + ":" + _Port, form);
        yield return www.Send();

        if (www.isError)
        {
            Debug.Log(www.error);
            if (OnRanksRetrieved != null)
                OnRanksRetrieved(null);
        }
        else
        {
            if (www.responseCode == 200)
            {
                Debug.Log("Get ranks complete!");
                Debug.Log("Response:" + www.downloadHandler.text);
                if (OnRanksRetrieved != null)
                {
                    string[] sranks = www.downloadHandler.text.Split(',');
                    int[] ranks = new int[sranks.Length];
                    int i = 0;
                    foreach (string s in sranks)
                    {
                        ranks[i] = RANK_INVALID;
                        int.TryParse(sranks[i], out ranks[i]);
                        i++;
                    }
                    OnRanksRetrieved(ranks);
                }
            }
            else
            {
                Debug.Log("Get ranks error response code:" + www.responseCode.ToString());
                if (OnRanksRetrieved != null)
                    OnRanksRetrieved(null);
            }
        }
    }
}

This class contains four methods at present:

  • SubmitScore – Submits a score to the server
  • SubmitScores – Submits a collection of scores to the server
  • GetRank – Gets the users rank from the server
  • GetRanks – Gets all of the users ranks from the server

Internally each request to the server is called via a coroutine and the supplied callback that we pass is called when a response from the server comes in, e.g.:

Leaderboards lbds = GetComponent<Leaderboards>();
lbds.GetRank(which, (int rank) =>
{
    // Do something with the result
});

Its also worth mentioning that when we send data to the server we make some effort to hide it which makes it a little harder for someone to spam the server with false scores, e.g.:

// Create a form that will contain our data
WWWForm form = new WWWForm();
StringBuilder sb = new StringBuilder("m=score");
sb.Append("&w=");
sb.Append(which.ToString());
sb.Append("&s=");
sb.Append(score.ToString());
sb.Append("&n=");
sb.Append(userName);
byte[] bytes = Encoding.UTF8.GetBytes(sb.ToString());
form.AddField("d", Convert.ToBase64String(bytes));

Note how we firstly encode the data to bytes then convert it to a base 64 string, this enables us to add a step between, where we can encrypt the byte data using whatever means we like.

Whats coming next….

I plan to extend the server to allow queries of the data, so I can for example view all of the leaderboards from a website and possibly on device.

Getting Unity 3D and node.js talking

I’m working on a Unity 3D game at the moment that needs a global leaderboard system that works across platform and not tied into the likes of Google Play or Game Centre. After taking a look at various technologies including my old favourite .NET (specifically thew newish .NET Core) I decided to use node.js because a) I want to learn it and b) .NET is a bit of overkill I think.

So I installed node.js then wrote a small server:

"use strict";

var http = require("http");

class Server
{
	constructor()
	{
		this.port = 8080;
		this.ip = "localhost";

		this.start();
	}

	start()
	{
		this.server = http.createServer((req, res) =>
		{
			this.processRequest(req, res);
		});

		this.server.on("clientError", (err, socket) =>
		{
			socket.end("HTTP/1.1 400 Bad Request\r\n\r\n");
		});
		console.log("Server created");
	}

	listen()
	{
		this.server.listen(this.port, this.ip);
		console.log("Server listening for connections");
	}

	processRequest(req, res)
	{
		// Process the request from the client
		// We are only supporting POST
		if (req.method === "POST")
		{
			// Post data may be sent in chunks so need to build it up
			var body = "";
			req.on("data", (data) =>
			{
				body += data;
				// Prevent large files from benig posted
				if (body.length > 1024)
				{
					// Tell Unity that the data sent was too large
					res.writeHead(413, "Payload Too Large", {"Content-Type": "text/html"});
					res.end("Error 413");
				}
			});
			req.on("end", () =>
			{
				// Now that we have all data from the client, we process it
				console.log("Received data: " + body);
				// Split the key / pair values and print them out
				var vars = body.split("&");
				for (var t = 0; t < vars.length; t++)
				{
					var pair = vars[t].split("=");
					var key = decodeURIComponent(pair[0]);
					var val = decodeURIComponent(pair[1]);
					console.log(key + ":" + val);
				}
				// Tell Unity that we received the data OK
				res.writeHead(200, {"Content-Type": "text/plain"});
				res.end("OK");
			});
		}
		else
		{
			// Tell Unity that the HTTP method was not allowed
			res.writeHead(405, "Method Not Allowed", {"Content-Type": "text/html"});
			res.end("Error 405");
		}
	}

}

module.exports.Server = Server;

Create a file called server.js and add the above code.

Note that the above code is designed as a module so you can import it into your own code, e.g.:

var server = require('./server');

var httpServer = new server.Server();
httpServer.listen();

Create a file called main.js and add the above code. Run the server by running node main.js

In the server code we create an instance of a HTTP client then we begin listening for connections. When a connection comes in we read the POST data and print out the key / value pairs that are sent.

On the Unity side we write the following code to test out our mini server:

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class Leaderboards : MonoBehaviour
{
    private static string _Url = "http://localhost";
    private static string _Port = "8080";

    public void SubmitScore(int which, int score)
    {
        StartCoroutine(SubmitScoreToServer(which, score));
    }

    private IEnumerator SubmitScoreToServer(int which, int score)
    {
        Debug.Log("Submitting score");

        // Create a form that will contain our data
        WWWForm form = new WWWForm();
        form.AddField("which", which.ToString());
        form.AddField("score", score.ToString());

        // Create a POST web request with our form data
        UnityWebRequest www = UnityWebRequest.Post(_Url + ":" + _Port, form);
        // Send the request and yield until the send completes
        yield return www.Send();

        if (www.isError)
        {
            // There was an error
            Debug.Log(www.error);
        }
        else
        {
            if (www.responseCode == 200)
            {
                // Response code 200 signifies that the server had no issues with the data we went
                Debug.Log("Form sent complete!");
                Debug.Log("Response:" + www.downloadHandler.text);
            }
            else
            {
                // Any other response signifies that there was an issue with the data we sent
                Debug.Log("Error response code:" + www.responseCode.ToString());
            }
        }
    }
}

In the above code we create a form, add the data that we wish to send then create a web request (UnityWebRequest) to send the form to our test server. We send the request then yield the coroutine until the send completes. We finally test the response code to ensure that our data was sent ok,

To test, add the component to an object and then call SubmitScore(1, 100), you should see the following displayed from node:

Server created
Server listening for connections
Received data: which=1&score=100
which:1
score:100

And in the Unity console you should see:
Submitting score
Form sent complete!
Response:OK

At the moment this is still pretty much test code and doesn’t handle security other than to check for idiots sending really POST data. You should really encrypt the data sent to the server to prevent even bigger idiots from spamming your server with false information.

Next I will be looking at redis as a persistent store for my leaderboard data. I will be extending the node.js server code to include this functionality. I may do a blog on redis soon and then one another that includes details on how to use redis to create a leaderboard.

2D water shader in Unity 3D

I recently found the need to spruce up the water in a new 2D game that I am working on, so I decided to have a play around with Unity shaders again. Here’s the code to the shader:

Shader "Unlit/WaterTexture"
{
	Properties
	{
		_MainTex ("Texture", 2D) = "white" {}
		_ScrollX ("X Scroll Speed", Range(-10, 10)) = 0
		_WaveSpeed("WaveSpeed", Range(0, 100)) = 10
		_FrequencyX("X Axis Frequency", Range(0, 100)) = 34
		_AmplitudeX("X Axis Amplitude", Range(0, 100)) = 0.005
	}
	SubShader
	{
		Tags { "RenderType"="Opaque" }
		LOD 100

		Pass
		{
			CGPROGRAM
			#pragma vertex vert
			#pragma fragment frag

			#include "UnityCG.cginc"

			struct appdata
			{
				float4 vertex : POSITION;
				float2 uv : TEXCOORD0;
			};

			struct v2f
			{
				float2 uv : TEXCOORD0;
				float4 vertex : SV_POSITION;
			};

			sampler2D _MainTex;
			float4 _MainTex_ST;
			fixed _ScrollX;
			fixed _FrequencyX;
			fixed _AmplitudeX;
			fixed _WaveSpeed;

			v2f vert (appdata v)
			{
				v2f o;
				o.vertex = mul(UNITY_MATRIX_MVP, v.vertex);
				o.uv = TRANSFORM_TEX(v.uv, _MainTex);
				return o;
			}

			fixed4 frag(v2f i) : SV_Target
			{
				fixed time = _Time * _WaveSpeed;
				fixed2 uvs = i.uv;
				fixed offset = (_ScrollX * _Time);
				uvs.x += offset;
				uvs.x = fmod(uvs.x, 1);
				uvs.x += sin(uvs.y * _FrequencyX + time) * _AmplitudeX;
				fixed2 uvs2 = i.uv;
				uvs2.x -= offset;
				uvs2.x = fmod(uvs2.x, 1);
				if (uvs2.x < 0)
					uvs2.x += 1;
				uvs2.y = 1 - i.uv.y;
				uvs2.x += sin(uvs2.y * _FrequencyX + time) * _AmplitudeX;
				fixed4 col = tex2D(_MainTex, uvs);
				fixed4 col2 = tex2D(_MainTex, uvs2);
				col = (col + col2) / 2;
				return col;
			}

			ENDCG
		}
	}
}

The main section of the code is the fragment shader, it plays with the textures U coordinates by applying a sine wave to them, it then does the same with the pixel on the opposite side of the V axis then merges them both together, it also scrolls the textures, this produces a nice running water effect.

You can grab all shaders that I make public from Github

Feel free to re-use the shader in your own creations.

Installing and running Node.js on a VPS

Introduction

I recently had the requirement to implement a global none app store specific leaderboard system that can track scores and players for a mobile game that I am developing in Unity3D. After much investigation node.js seems to be the technology to use to create a server to handle it. I want it to be as quick as possible without having to resort to C++, plus I’ve been looking for an excuse to play with node.js in more detail. Ok, so I went to ovh.net and purchased one of their super cheap VPS (Virtual private server). I opted for Debian 8 LAMP (this is the Debian 8 Linux OS with, Apache web server, MySQL and PHP). After reading up the set up instructions, I managed to get logged into my VPS using PUTTY on Windows.

Installing node.js on a VPS

First thing to do is install node.js to the VPS. In the Putty terminal type the following:

Download and run the Nodesource PPA (personal package archive) installer script:

cd ~
curl -sL https://deb.nodesource.com/setup_6.x -o nodesource_setup.sh
sudo bash nodesource_setup.sh

Install node.js:

sudo apt-get install nodejs

Install the build essentials for some packages that require compilation

sudo apt-get install build-essential

Testing out the node.js installation

Ok, so now we have node.js installed, its time to create a hello world and run it to ensure that it works. In terminal create hello.js:

cd ~
nano hello.js

If you do not have the nano text editor installed then you can install it as follows:

sudo apt-get install nano

Once the file is open add the following code:

#!/usr/bin/env nodejs
var http = require('http');
http.createServer(function (req, res)
{
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end('Hello World!\n');
}).listen(8080, 'localhost');
console.log('Server is running at http://localhost:8080/');

Make the script executable:

chmod +x ./hello.js

Run the script:

./hello.js

Note that the script is blocking because it is sat in an infinite loop waiting for connections, so you can no longer type anything into terminal. To test, run another instance of terminal (Putty on Windows) and enter the following to test the script:

curl http://localhost:8080

You should see “Hello World” printed out which is the response from the hello.js script.

Installing and using Process Manager (PM2) for node.js

The next issue we need to look at is how to make our script run in the background so it does not block. To do that we need install a tool called PM2 (process manager for node.js):

sudo npm install -g pm2

Once installed we can set our script off running as a background process with:
pm2 start hello.js

And to make PM2 re-run when the server reboots:

pm2 startup systemd

Note that when PM2 restarts it will restart all of its running processes.

Getting node.js to work with Apache

The general idea is to run the node.js server on a different port and forward requests to a specific url to this port using a reverse proxy. To do this we need to update an Apache config file httpd.conf. Note that if you do not find this file in the /etc/apache2/ directory then you will need to create it and add the following text:

ProxyPass /node http://localhost:8000/
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

And add the following line to /etc/apache2/apache2.conf to ensure that the file gets included

Include /etc/apache2/httpd.conf

Note that it is likely that the proxy module is not enabled on Apache, in which case enable it using:

a2enmod proxy_http

Now requests to http://www.yourdomain.com/node will be forwarded to localhost:8000, adjust the original hello world node.js script to listen on port 8000 and give it a test.

Marmalade SDK 8.4 out now

The latest and greatest version of the Marmalade SDK is now available here
Highlights

  • C++11 support now available.
  • Apple Pencil pressure reading is now supported on iPad Pro in addition to existing 3D Touch support.
  • Slide Over and Split View multitasking now available to Marmalade apps on supported iPad models.
  • Compression of assets in APKs on Android is now supported.
  • Windows 10 ARM builds can now be directly deployed to any attached device without any special configuration.
  • s3eCamera can now return high quality still images on Android, rather than the viewfinder preview.
  • s3eWebView updated to use newer version of Chromium Embedded Framework on Windows Desktop.

A full list of changes is available here.

Marmalade SDK 8.2 is out now

The latest and greatest version of the Marmalade SDK is now available here.

Highlights

  • IncrediBuild support for ARM architecture
  • Improved video support for Windows Desktop
  • Updated version of ZeroBrane Studio for Quick
  • Multidex support for Android

A full list of changes is available here.

Developing games for mobile and desktop? Then why not go cross platform and try out the Marmalade SDK, its now free. Available in C++ and Lua flavours.