/Quick-Scene

An alternative to the Unity inspector for quicker modifications without leaving the scene.

Primary LanguageC#MIT LicenseMIT

Banner

Unity Version GitHub PRs Welcome openupm

An alternative to the Unity inspector for quicker modifications without leaving the scene.

Features

  • A quick menu for adding objects into the scene
  • Object component modifications in-scene
  • GameObject modifications in-scene
  • Supports multi-object selection
  • Add components to objects quickly

Installation

Install via UPM (using Git URL)

  1. Navigate to your project's Packages folder and open the manifest.json file.
  2. Add this line below the "dependencies": { line
"com.nomnom.quick-scene": "https://github.com/nomnomab/Quick-Scene.git",
  1. UPM should now install Quick Scene and it's dependencies.

Don't want to use git? Just download and unzip the repository into the Packages folder.

Install via OpenUPM

The package is available on the openupm registry. It's recommended to install it via openupm-cli.

openupm add com.nomnom.quick-scene

Usage

Scene placement

When holding Shift+A in a scene, you can bring up the placement gizmo. This placement gizmo will dictate where the new object will be placed. Once a point has been determined, left-click to bring up the Add Window.

  • Holding Shift+X will use origin placement instead.

Add Window

Here you can select an object from the native GameObject creation window, or you can scroll down to select a prefab from the project. Otherwise, you can use the search functionality to locate closest matching names.

At the bottom of the Add Window are additional placement options:

  • Place along surface normal
  • Parent to surface

Scene toolbar

Once an object is selected, a toolbar will appear underneath it. This toolbar contains the following:

  • Object name
  • Object components
  • Add component button

Scene toolbar

Clicking the object's name will show the GameObject toolbar. Clicking a component icon will show the given component's inspector window underneath the toolbar.

At the end of the toolbar is an Add Component button. This will show the native Unity menu for the operation.

FAQ

Can I change my keybinds?

  • Yes! Search for MainMenu/Edit/Quick Scene/Add - Pointer, and MainMenu/Edit/Quick Scene/Add - Origin in the shortcuts menu.

I changed my keybinds, but they don't update!

  • If you change keybinds without a recompilation, you'll need to select Edit/Quick Scene/Refresh Keybinds to refresh them.

If my editor crashes, why is there a random floating window?

  • This can happen due to the window not being closed properly. This can be fixed by resetting the Unity layout.

Why does my editor lose performance when in a component window or a GameObject window?

  • This is a known issue with handling multiple in-scene editor windows. Other options are being looked at for more performance.

Why is the search showing options that aren't relevant to what I typed in?

  • Because I don't understand how Sublime's fuzzy search works so I did my best :(