Scene Commands

What Is A Scene Command?

A scene command is a command that remains active on the scene until you decide to stop its action, or until a certain key is hit.

Few scene commands can be active at the same time, which can create more sophisticated behaviors.

Few scene commands being active

How to use Scene Commands?

Some of MonKey's Commands are scene commands: as soon as you use them, they will appear active on the scene.

There are two types of scene commands: the ones that work until you request to close them, and the ones that have an action when you hit the indicated keys.

The ones that work until you close them will appear on the lower right corner of the scene view.

The ones that require an input will appear on bottom center of the scene view.

How to stop a Scene Command?

To stop a scene command, you can click on the cross next to the name of the command on the lower right corner of the scene view.

You can scroll through the list of current scene commands using the mouse scroll if you cannot see the one you want to stop.

Scene Commands that require an input will also indicate how to stop it.

In any case you did something using a scene command that you would like to revert, the scene commands all have an Undo support.

Scene Command Combinations

A lot of scene commands work really well when combined with other:

  • Using "Lock Distance" and "Lock Collision" will lock few objects' transform so that they are at a minimum distance from each-other, while making sure they are all sticking to the underlying terrain
  • Using "Lock Chain" and "Lock Distance All" can help you create a nice path through a forest by making objects be pushed by the objects you chained together
  • Experimenting with different combinations is of course recommended :)

However, some other combinations will not work, as some scene commands may conflict with each other:

  • Having a "Lock Axis" and "Lock Collision" won't work in most cases: the two commands are both going to try to move the objects around and most likely wont be able to resolve the final position.

Limitations of Scene Commands

Some Commands may slow down the editor when operating with a large amount of objects. We are doing our best to provide the best performances possible, however adding a lot of scene commands affecting a lot of game objects at the same time will inevitably lead to a lot of math being done!

If the editor start to slow down, consider reducing the amount of objects affected by scene commands, or reducing the amount of active scene commands.

Note: A bug in Unity 2018.1.0f2 prevents MonKey (and other asset store plugins) to render properly the Scene Commands' UI if you use linear color space. If the colors seem lighter than they should, that's the reason! The issue is fixed in 2018.2.