Firstborn/Library/PackageCache/com.unity.visualscripting@1.../Documentation~/vs-nodes-events-on-button-i...
Schaken-Mods b486678290 Library -Artifacts
Library -Artifacts
2023-03-28 12:24:16 -05:00

3.7 KiB

On Button Input node

Note

The On Button Input [!includenodes-note-manual]

The On Button Input node listens for a specified action on a virtual button from your Input Manager configuration. [!includenodes-desc-end]

An image of the Graph window. An On Button Input node displays with its details in the Graph Inspector.

Fuzzy finder category

The On Button Input node is in the Events > Input category in the fuzzy finder.

Inputs

The On Button Input [!includenodes-inputs]

Name Type Description
Name String The name of the button the node listens to for an Input event, as it appears in the Input Manager.
Action Press State The specific press state of the button that the node listens for.
Hold The user holds down the button.
Down The user presses the button.
Up The user releases the button.

Additional node settings

The On Button Input [!includenodes-additional-settings]

[!include[nodes-coroutine](./snippets/nodes-coroutine.md)]
Name Type Description

Outputs

The On Button Input [!includenodes-single-output]

[!include[nodes-input-output-trigger](./snippets/input-manager/nodes-input-output-trigger.md)]
Name Type Description

Example graph usage

In the following example, the On Button Input node listens for the user to press the button or key assigned to the Jump axes in the Input Manager. When the user presses the button, the On Button Input node triggers the Rigidbody Add Force node, which adds an Impulse Force to the Rigidbody's Y axis:

An image of the Graph window. An On Button Input node uses an inline value of Jump for its Name input port. Its Action Input port is set to Down. Its Trigger output port connects to the Invoke input port on a Rigidbody Add Force node. The Rigidbody Add Force node uses an inline value of This for its Target, an inline value of 4 for its Y, and has its Mode set to Impulse.

The Add Force node makes the Target Rigidbody lift into the air.

An image of the Game view. Three red spheres are on top of a grey plane, with the middle sphere lifted into the air.

[!includenodes-related] to the On Button Input node: