Adding an OnClick-event to a Notification¶

Introduction¶

This tutorial will guide you through the process of triggering an action whenever you click on a Notification.

After finishing this tutorial, you will know how to:

• Create a class with the INotificationAction Interface
• Add an action to your Notifications

Main Class¶

Start a new project and call it "NotificationActionExample".

An unwritten rule in programming is that you give your variables, classes, methods, etc, clear names. They should be named in such a way so that you know what their function is when you read their name.

As you might have noticed, when we created this project, the class inside the project is named "Class1" by default.

1
2
3
4
5
6

namespace NotificationActionExample
{
    public class Class1
    {
    }
}

Obviously this is not a very clear name. Lets start with renaming Class1 and give it the name "Main". The reason for this name is that usually the first class in your project will be your main class which manages and executes everything else. Of course you are free to call it whatever, it is not required to be named "Main" for the mod to work, just make sure the name represents the function of this class.

To rename the class, right click on Class1 in your Solution Explorer and select Rename.

Then type in "Main" and press enter.

Now we need to get access to callbacks which allows us to execute code at a certain point in the games lifecycle. To get access to these callbacks we need to inherit from the Mod-class.

Where it says public class Main, change this to public class Main : Mod.

The Mod-class gives us access to a couple of callbacks. For this example we are interested in the OnGameStarted()-callback.

Inside your Main-class, add:

1
2
3
4

protected override void OnGameStarted()
{

}

Now we can set up our notification inside OnGameStarted(), just like in the "Creating your first script mod" guide.

Lets add the following code to OnGameStarted():

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

//Priority is an optional argument when calling the NotificationManager
NotificationPriority priority = NotificationPriority.Default;

//Color is an optional argument when calling the NotificationManager
//Beware, using Color can cause a small issue, read note below
Color color = Company.Current.Color;
string title = "Notification Action";
string message = "Click this notification to trigger a Notification Action";

//Lets use a bell as an icon
FontIcon icon = FontIcon.FaSolid("\uf0f3");

NotificationManager.Current.Push() requires 6 arguments:

1. Priority (Optional)
2. Color (Optional)
3. Title
4. Message
5. Action
6. Icon

We have set variables for all the arguments, except Action. Before we can create and set a variable for this argument, we have to create a new Class.

NotificationAction Class¶

Lets create a new Class.

Right click on your project in your Solution Explorer, then go to Add > New Item...

Then in the next window select Class and give it the name NotificationAction.cs and click Add.

Once you have added this new class, follow the steps below:

1. Implement the INotificationAction-interface.

After you implemented the interface, your NotificationAction-class should now look like this:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

class NotificationAction : INotificationAction
{
    public void Act()
    {
        throw new NotImplementedException();
    }

    public void Read(StateBinaryReader reader)
    {
        throw new NotImplementedException();
    }

    public void Write(StateBinaryWriter writer)
    {
        throw new NotImplementedException();
    }
}

1. (Optional) Remove the throw new NotImplementedException(); from all 3 callbacks, to prevent any exceptions showing up in game.

2. Lets add some code to the Act()-callback. This is the callback that will be triggered when you click on the linked notification. As an action we are going to show another notification that tells us that we succesfully triggered a notification action.

   Lets set up a new notification:

   1 2 3 4 5 6 7 8 9 10 11

   //Priority is an optional parameter NotificationPriority priority = NotificationPriority.Default; //For a color, lets use a somewhat darker green - Make sure you're using the Color32 type, read below Color32 color = new Color32(63, 191, 63, 255); string title = "SUCCES!!!"; string message = "You have succesfully triggered a notification action!"; //Lets use a thumbs up as an icon FontIcon icon = FontIcon.FaSolid("\uf164");

Then we need to call the Notification Manager to actually display this notification. We do this with adding the following statement:

NotificationManager.Current.Push(priority, color, title, message, null, icon);

As a final result your NotificationAction-class should now look like this:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

class NotificationAction : INotificationAction
{
    public void Act()
    {
        //Priority is an optional parameter
        NotificationPriority priority = NotificationPriority.Default;

        //Color is an optional parameter
        Color32 color = new Color32(63, 191, 63, 255);

        string title = "SUCCES!!!";
        string message = "You have succesfully triggered a notification action!";

        //Lets use a thumbs up as an icon
        FontIcon icon = FontIcon.FaSolid("\uf164");

        NotificationManager.Current.Push(priority, color, title, message, null, icon);
    }

    public void Read(StateBinaryReader reader)
    {

    }

    public void Write(StateBinaryWriter writer)
    {

    }
}

Now that we have a class which can go in the INotificationAction action-variable, we can implement it.

Implement the Notification Action¶

Add the following line to your OnGameStarted()-callback in your Main-Class:

INotificationAction action = new NotificationAction();

Your Main-class should now look like this:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

public class Main : Mod
{
    public void OnGameStarted()
    {
        //Priority is an optional parameter
        NotificationPriority priority = NotificationPriority.Default;
        //Color is an optional parameter
        Color color = Company.Current.Color;

        string title = "Notification Action";
        string message = "Click this notification to trigger a Notification Action";

        //Lets use a bell as an icon
        FontIcon icon = FontIcon.FaSolid("\uf0f3");

        INotificationAction action = new NotificationAction();
    }
}

Now we have all the required arguments to call the Notification Manager.

Add the following statement to your OnGameStarted-callback in your Main-Class:

NotificationManager.Current.Push(priority, color, title, message, action, icon);

As a final result your Main-class should look like this:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

public class Main : Mod
{
    public void OnGameStarted()
    {
        //Priority is an optional parameter
        NotificationPriority priority = NotificationPriority.Default;
        //Color is an optional parameter
        Color color = Company.Current.Color;

        string title = "Notification Action";
        string message = "Click this notification to trigger a Notification Action";

        //Lets use a bell as an icon
        FontIcon icon = FontIcon.FaSolid("\uf0f3");

        INotificationAction action = new NotificationAction();

        NotificationManager.Current.Push(priority, color, title, message, action, icon);
    }
}

Compile and run the mod¶

Now we can add this mod to the game and try it out.

Follow the steps below:

1. Build your project into a .dll-file
2. Locate your .dll-file and place it in Content/<your_mod_folder>
3. Create a mod.json file
4. Start Voxel Tycoon and start a new game with your just created mod activated
5. Wait for your game to load...
6. CLICK THAT NOTIFICATION!!!

Play around¶

If you're not yet very familiar with coding, I suggest to play around some more to see what other awesome things you can do with Notification Actions. This is a good way to get better with coding.