Version: 2021.2
Grid snapping
Scene visibility

Using custom Editor tools

From the Scene viewAn interactive view into the world you are creating. You use the Scene View to select and position scenery, characters, cameras, lights, and all other types of Game Object. More info
See in Glossary
, you can access custom tools created with the Tool Modes API. You can access them by:

  • Clicking the Available Custom Editor Tools drop-down menu in the SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
    See in Glossary
    view Tool toolbarA row of buttons and basic controls at the top of the Unity Editor that allows you to interact with the Editor in various ways (e.g. scaling, translation). More info
    See in Glossary
    Overlay.

  • Opening the Tools Settings toolbar Overlay.

Custom Editor tools are available from a menu in the Scene view Tools toolbar Overlay
Custom Editor tools are available from a menu in the Scene view Tools toolbar Overlay

Global tools vs. contextual tools

Some custom tools are global and others are contextual:

  • A global tool affects any type of GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
    See in Glossary
    , and is always available no matter what type of GameObject you select. For example, a transform tool could be accessible all the time because it works with any GameObject.

  • A contextual custom tool only affects a specific type of GameObject, and is only available when you select GameObjects of that type. For example, a custom manipulator for lights should only be accessible when you select a light.

Activating custom Editor tools from the Scene view toolbar

To activate custom Editor tools, right-click the Available Custom Editor Tools button in the Scene view toolbar.

This opens a menu divided into the following sections:

  • A. Recent: lists the most recently used global tools.

    This section does not appear until you activate activate a global tool for the first time in the current session.

  • B. Selection: lists all contextual tools that affect one or more GameObjects in the current selection.

    This section does not appear if there are no custom tools in the Project that affect the selection.

  • C. Available: lists all available global tools.

    This section always appears, as long as the Project contains custom tools.

If the Project does not contain any custom tools, the menu will not have the custom tools icon.

When you select a tool from the menu, the Available Custom Editor Tools button changes to the icon for the selected tool.

Selecting the Custom Transform Tool from the menu displays its icon in the Scene view toolbar
Selecting the Custom Transform Tool from the menu displays its icon in the Scene view toolbar

Activating contextual tools from the Component Editor Tools panel

The Component Editor Tools appear in the Tools Settings toolbar Overlay in the main Scene view window.

The Tool Settings toolbar contains all contextual custom tools that affect one or more selected GameObjects. It updates automatically whenever the selection changes.

  • Click a button to activate a tool.

  • Available Custom Editor Tools button and Component Editor tools panel added in 2019.1 NewIn20191
Grid snapping
Scene visibility