HTTPS SSH

Putting up my datasacks module for easy UI event processing in Unity3D.

Fire up the example game scene for a silly clicker that has some UI that uses datasacks.

Here is a sorta graphical overview of how things work:

Datasacks Overview 2

More examples coming soon. Here are some notes:

What are Datasacks?

Datasacks are Unity3D ScriptableObjects that contain data.

Internally the data is stored as a string but you can access it in code as a string, an int, a float, a bool, and other ways.

The Datasack ScriptableObjects have a custom Unity3D inspector. Via a button on that inspector you can "CODEGEN," which will produce header code in (DSMCodegen.cs) containing all the names of the Datasacks you have created in your project. This is purely for code convenience and type-checking because you can always get at a Datasack by its name (DSM.I.Get( string)), and of course they are always available as draggable objects into monobehaviors.

The general flow pattern is that you put the DSButtonSetUIIntent.cs script on any UI button, and when pressed that will put the name of that button's GameObject into the DSM.UISack variable, unless you specify another Datasack.

Datasacks can be subscribed to for changes, either on a permanent listener basis or on a one-shot basis.

For data presentation, you can put the DSTextGetString.cs onto your UnityEngine.UI.Text components and then the contents of any particular Datasack you want will be live-updated to that Text field.

See the little clicker game supplied for some sample uses. There are other ways. The main point of this is to expose as much functionality in the Unity editor/inspector as possible, and to let non-engineers make meaningful changes to the game without having to involve an engineer.

See notes.txt for what (might be) coming in the future.

Other things you can do with a Datasack can be seen looking at its inspector: change values at runtime, display values, etc.

You can also check the Save boolean to cause it to persist to the PlayerPrefs system between launches of the application.

Obviously you can use JSON and store whatever objects you want into the string portion of a Datasack.

// Here is an example data subscription pattern for your Monobehavior:

public Datasack dataSack;   // populate this in the Unity editor

void    OnDatasackChanged( Datasack ds)
{
    // Here is where you service the notification
    // that the contents of this Datasack changed
    // You can inspect the name of the Datasack if
    // you expect more than one Datasack to call
    // this function.
}

void    OnEnable()
{
    dataSack.OnChanged += OnDatasackChanged;
}
void    OnDisable()
{
    dataSack.OnChanged -= OnDatasackChanged;
}