Documentation

Support

Unity Lite

Open Unity Lite

Unity Lite

Use a button to transform a GameObject

Understand how you can transform a GameObject when you click on a button.
Read time 2 minutesLast updated 2 days ago

Use this example to understand how to scale, rotate, or move a GameObject when the user clicks on a button.
1

Create a button in your UI Canvas.

  1. Select UI Canvas in the Hierarchy panel.
  2. Right-click and select UI > Button to create a new button.
2

Create a New Logic script.

  1. In the Project panel, select the My Logic folder.
  2. Select Add (+).
  3. Select New Script. Unity Lite creates a new Logic script in the folder.
  4. Enter a name for your script and press Enter.
3

Add the script to the GameObject you want to transform.

  1. Select or create a GameObject from the Hierarchy panel.
  2. From the Inspector panel, select Add Component.
  3. Choose your Logic script from the list.
4

Set up the logic in the Logic Editor.

  1. In the Project panel, double-click the Logic script to open the Logic Editor.
  2. Drag a When event listener into the Logic Editor.
  3. Add a Clicked On event inside the When node. This triggers the logic when the user clicks the button.
  4. Select Add (+) next to Variables to create a new variable for the button and set its type to Object.
  5. Drag the
    button
    variable into the Clicked On socket.
  6. Add an action node to define how the GameObject should change when the user clicks the button. You can choose from:
    • ScaleByValue or ScaleToValue to change the size of the GameObject.
    • RotateByValue or RotateToValue to rotate the GameObject.
    • MoveByValue or MoveToValue to change the position of the GameObject.
  7. Drag the Me variable, which refers to the GameObject the script belongs to, into the Object socket.
  8. Enter the value you want to transform:
    • For scaling, enter the scale value. For example, if using a ScaleByValue node, a value of
      1
      doubles the object's size.
    • For rotation, enter the rotation angle.
    • For movement, enter the target position.
  9. Set the transformation time. Set it to
    0
    if you want the change to happen instantly.
Example Logic script to scale a GameObject when a button is clicked.

Example Logic script to scale a GameObject when a button is clicked.

  1. Close the Logic Editor.
5

Link the Button to your script.

  1. In the Hierarchy panel, select the GameObject that has your Logic script attached.
  2. Drag the UI Button you created earlier from the Hierarchy panel into the button variable reference in your script component.
Press Play to test your scene. When you click the button, the GameObject transforms according to your specified logic.