docs.unity3d.com
    Show / Hide Table of Contents

    On Mouse Enter node

    Note

    The On Mouse Enter node is an Input Manager node. For more information about how to use the Input Manager with Visual Scripting, see Capture user input in an application.

    The On Mouse Enter node listens for the user's mouse pointer location to enter the Collider of a specified GameObject. When the mouse enters the Collider or GUI element, the node triggers the next node connected to it. It doesn't send or receive any other data.

    An image of the Graph window. An On Mouse Enter node displays with its details in the Graph Inspector.

    Fuzzy finder category

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

    Inputs

    The On Mouse Enter node has one input port:

    Name Type Description
    Target GameObject The GameObject with the Collider that triggers the On Mouse Enter node.

    Additional node settings

    The On Mouse Enter node has additional settings. Access these settings from the Graph Inspector:

    Name Type Description
    Coroutine Toggle Enable Coroutine if you want Visual Scripting to run this node and any of its connected nodes as a coroutine. Coroutine nodes don't execute all their code in a single frame, so they can spread an effect over several frames. Coroutines can also help optimize your code. For more information on coroutines, see the Unity User Manual section on Coroutines.

    Outputs

    The On Mouse Enter node has one output port:

    Name Type Description
    Trigger Output Trigger The control output port. Make a connection to specify what Visual Scripting should do after the configured Input event occurs in your application.

    Example graph usage

    In the following example, the On Mouse Enter node triggers the Instantiate GameObject node when the user's mouse enters the Collider on the Script Machine's GameObject. The Instantiate node creates an instance of the Light Prefab, at the Prefab's Position and with the Prefab's Rotation. The graph saves the new instance of the GameObject to a Scene variable, Spotlight, so it can interact with the GameObject again later.

    An image of the Graph window. An On Mouse Enter node's Trigger output port connects to the Invoke input port on an Instantiate GameObject node. The Instantiate GameObject's Original uses an inline value of the project's Light Prefab. A GameObject Literal node also uses the Light Prefab as an inline value. The GameObject Literal connects to a Transform Get Position node and a Transform Get Rotation node, which provide the Position and Rotation inputs for the Instantiate GameObject node. The Instantiate GameObject node's Exit port triggers the Assign input port on the Set Variable node, and assigns the new GameObject as the value of the Spotlight Scene variable.

    The result is a spotlight that appears over the On Mouse Enter node's Target GameObject, when the user's mouse enters the Collider.

    An image of the Game view, that displays a simple scene with a plane and a cube GameObject. The cube is lit by a spotlight from above.

    Related nodes

    The following nodes are related or similar to the On Mouse Enter node:

    • On Button Input node
    • On Keyboard Input node
    • On Mouse Down node
    • On Mouse Drag node
    • On Mouse Exit node
    • On Mouse Input node
    • On Mouse Over node
    • On Mouse Up node
    • On Mouse Up As Button node
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023