docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    On Input System Event Button node

    Note

    The On Input System Event Button node is an Input System package node. For more information about how to use the Input System package in Visual Scripting, see Capture user input in an application.

    The On Input System Event Button node listens for a specific Input Action from a Player Input component. It doesn't send or read any other data.

    Use this node when you want to read user input but don't require any other data from an Input Action.

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

    Fuzzy finder category

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

    Inputs

    The On Input System Event Button node has the following input ports:

    Name Type Description
    Target Player Input The Player Input component that Visual Scripting uses to display a list of input actions. The default is This, which is the Player Input component attached to the GameObject where Visual Scripting runs the Script Graph. You can also connect a node that outputs a Player Input component.
    Input Action Input Action An input action. Use the dropdown to select an input action from the Player Input component specified in Player Input, or connect a node that outputs an input action.

    Controls

    The On Input System Event Button node has the following controls:

    Name Type Description
    Input Action Change Type Input Action Change Option Set an Input Action Change Type to choose the interaction type that triggers the node.
    On Pressed The node triggers when a user presses the button from the selected Input Action input asset.
    On Hold The node triggers when a user holds the button from the selected Input Action input asset.
    On Released The node triggers when a user releases the button from the selected Input Action input asset.

    You can also set this control from the Graph Inspector.

    Additional node settings

    The On Input System Event Button node has additional settings. Access these settings from the Graph Inspector:

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

    Outputs

    The On Input System Event Button node has one output port:

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

    Example graph usage

    In the following example, an On Input System Event Button node counts how many times the user has pressed a button from the Fire Input Action and logs the result to the console.

    When a user presses a button associated with the Fire Input Action, Visual Scripting gets the current value of the Count Object variable with a Get Variable node. The Get Variable node sends Count's current value to an Add Inputs node's A port. Then, the Float literal node sends a value of 1 to the Add Inputs node's B port.

    The On Input System Event Button node triggers the Set Variable node and assigns the value from the Add Inputs node's Sum port as the New Value of Count. The Set Variable node logs the value of Count to the console with the Debug Log node:

    An image of the Graph window, that displays an On Input System Event Button node connected to a Set Variable node. The Set Variable node takes its New Value input from an Add Inputs node, which adds the current value of the Count variable to the value from a Float literal node. The Set Variable node logs the result to the console with a Debug Log node.

    Related nodes

    The following nodes are related or similar to the On Input System Event Button node:

    • On Input System Event Float node
    • On Input System Event Vector 2 node
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)