GameObject

Description

Base class for all objects that can exist in a scene. Add components to a GameObject to control its appearance and behavior.

The GameObject is the fundamental object type in Unity. Use GameObject to represent everything in your project, including characters, props, and scenery. A GameObject acts as a container for functional components that determine how the GameObject looks and behaves.

Any script that derives from MonoBehaviour can be added to a GameObject as a component. Use the Component.gameObject property from your MonoBehaviour code to access the GameObject the component is attached to.

MonoBehaviour event functions such as the regular per-frame MonoBehaviour.Update allow you to make the object responsive to events. To receive these event callbacks the GameObject must be active in the scene, which means both the activeSelf and activeInHierarchy properties must be true.

You can create an empty GameObject from code by invoking one of the constructors. However, a more common method is to instantiate a GameObject in Prefab form, with preconfigured components, property values, and child objects. For more information, refer to Instantiating Prefabs at runtime in the Manual.

You can modify many of the properties of this class in the Editor using the Inspector window. For a more comprehensive guide to using the GameObject class, refer to GameObject in the Manual.

The following example creates a GameObject named "myExampleGO" and adds a component of type AudioSource:

  using UnityEngine;

  public class Example_GameObject : MonoBehaviour
  {
      private void Start()
      {
          GameObject myExampleGO = new GameObject("myExampleGO", typeof(AudioSource));
      }
  }

Additional resources: Component.

Properties

Constructors

Public Methods

Static Methods

Inherited Members