Version: 2020.3
Language : English
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:

Custom Editor tools are available from a menu in the Scene view toolbar (A) and from a panel (B) that you can toggle on and off
Custom Editor tools are available from a menu in the Scene view toolbar (A) and from a panel (B) that you can toggle on and off

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 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
.

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 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 displays a message which reads “No custom tools available”.

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

You can toggle the Component Editor Tools panel to access custom Editor tools from a toolbar overlaid on the main Scene view window.

In the above example, the Component Editor Tools panel contains buttons for custom tools that affect either the selected light, the selected capsule, or both. It does not contain buttons for global tools.
In the above example, the Component Editor Tools panel contains buttons for custom tools that affect either the selected light, the selected capsule, or both. It does not contain buttons for global tools.

The panel contains buttons for 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.

  • Click the button again to toggle between the current tool and the last active tool.

If the Project does not use any custom tools, the panel is empty.


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