Working with the Viewport Interaction Model - Lumberyard User Guide

Working with the Viewport Interaction Model

This feature is experimental and is missing some core functionality.

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog, O3DE Discord, or O3DE GitHub to learn more. The Lumberyard forums have been deprecated. You may view past forum discussions in the archive.

The new Viewport Interaction Model replaces the old interaction model in the viewport. This feature combines free and local selection so that you can more easily select, move, and modify entities in the viewport. With the Viewport Interaction Model, you can create custom reference spaces to move your entities. With custom reference spaces, you can move your selected entities in relation to the reference that you specified. The Viewport Interaction Model also unifies entity and component manipulators so that you can interact with entities and components in the same way. Gizmos are deprecated.

The Viewport Interaction Model provides the following benefits:

  • Improves the ability to select your preferred entity, especially for nested hierarchies or levels that have many entities.

  • Prevents you from accidentally deselecting an entity. The entity that you select is locked for editing.

  • Adds keyboard and mouse actions that you can apply to your selected entities. For example, you can freely switch between local, parent, and world space to make changes to your selected entities.

  • Establishes an editing pattern that matches the Component Mode feature. For more information, see Editing Components in the Viewport.

See the following concepts for the Viewport Interaction Model:


With manipulators, you can edit component properties directly in the viewport instead of the Entity Inspector.

For more information, see Using Manipulators.

Custom Reference Target

When you select an entity, you can specify whether to move that entity in relation to another entity.

Viewport Interaction Model Limitations

This feature has the following limitations:

  • The Viewport Interaction Model supports component entities only and doesn't support legacy entities, such as terrain and vegetation.

  • When you enable the Viewport Interaction Model, this feature removes some toolbar options in the Lumberyard Editor Interface, such as vertex snapping.

  • You can't change or customize shortcuts for the Viewport Interaction Model.