# On Runner Variable Change

Executed when the State Machine Runner Variable is modified.

## Description

This event fires whenever a variable on a specific State Machine Runner is changed. Use this to react to per-instance state changes.

## Parameters

| Name         | Description                                               |
| ------------ | --------------------------------------------------------- |
| **Variable** | The variable to monitor for changes                       |
| **Runner**   | The target GameObject containing the State Machine Runner |

## Keywords

`Variable`, `Change`, `State Machine`, `Runner`

## Example

```
Trigger Component:
├─ Event: On State Machine Runner Variable Change
│   ├─ Variable: "Health"
│   └─ Runner: Self
└─ Actions:
    ├─ Update health bar UI
    └─ Play damage effect if health decreased
```

{% hint style="success" %}
This is the most common event for reactive gameplay systems. Use it to:

* Update UI when stats change
* Trigger effects when state changes
* Sync visuals with game logic
  {% endhint %}

{% hint style="info" %}
The **Runner** parameter is typically set to **Self** to monitor the runner on the same GameObject as the Trigger.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ninjutsugames.com/game-creator-2/state-machine-2/visual-scripting/events/on-runner-variable-change.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.