mirror of
https://github.com/unity-atoms/unity-atoms.git
synced 2025-01-30 20:02:49 -05:00
532008c768
* Restructure tutorials and add two new tutorials - Non-generated documentation review and edit - Consistent terminology - Stylistic changes - Minor structure changes - Minor clarifications - Typo fixes - Split basic tutorial into two - Tutorials are easier to follow when they are short and to the point - Added event and variable instancer tutorials - Had to bump node version for the docker container to work * #189 - Fixing minor nitpicks Co-authored-by: Adam Ramberg <adam@mambojambostudios.com>
28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
---
|
||
id: actions
|
||
title: Actions
|
||
hide_title: true
|
||
sidebar_label: Actions
|
||
---
|
||
|
||
# Actions
|
||
|
||
The `ChangeFillAmount` function created in the listeners tutorial is actually a Response of type `UnityEvent`. However, in Unity Atoms there is also the possibility to create Responses as Scriptable Objects called Actions. An Action is a function as a Scriptable Object that does not return a value. As a side note there are also Functions in Unity Atoms, which are exactly like Actions, but does return a value. To demonstrate the concept of an Action as a Response lets create an Action called `HealthLogger.cs` that gives some love to the console and logs the player’s health whenever it changes:
|
||
|
||
```cs
|
||
[CreateAssetMenu(menuName = "Unity Atoms/Examples/Health Logger")]
|
||
public class HealthLogger : IntAction
|
||
{
|
||
public override void Do(int health)
|
||
{
|
||
Debug.Log("<3: " + health);
|
||
}
|
||
}
|
||
```
|
||
|
||
It is possible to create the `HealthLogger` by right clicking and go _Create / Unity Atoms / Examples / Health Logger_ (this is available due to the call to `CreateAssetMenu`). When created we can add it as an Action Response to the `HealthListener`:
|
||
|
||
|
||
|
||
Every time the player’s health is changed we now log out the player’s health. This particular example is pretty simple, but I’m sure you can come up with lots of other use cases for it (for example play a sound or emit some particles).
|