Skip to content

Document 3D viewport keyboard focus and navigation #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JamieW105 merged 1 commit into from
Oct 14, 2026
Merged

Document 3D viewport keyboard focus and navigation #39

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/editor/viewport.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,15 @@ Prerequisites: a loaded writable scene with an object. Stop Play for authoring n

## Navigate and select

1. Hover or click the authoring viewport. Avoid typing into another text field while using navigation keys.
1. Stop Play and hover or click the **3D** authoring viewport. Clicking gives the viewport keyboard focus, so navigation continues even if the pointer moves outside it. If an Inspector field or Explorer rename field has focus, click the viewport to return keyboard control to it.
2. Orbit with middle-button drag, right-button drag, or left-button drag away from the gizmo. **Shift + middle drag** pans; the wheel dollies.
3. Use **W/A/S/D** to move the editor camera and **Q/E** for horizontal panning.
4. Click a rendered object to select it. **F** or **Frame (F)** frames the selection; **Home** or **Reset (Home)** resets the editor camera.

Expected result: only the authoring camera moves. The selected entity remains available in Inspector. Clicking empty space clears selection unless Shift or the command modifier is held; this is not a multi-selection promise.

Hold a movement key for continuous navigation; release it to stop. **W/S** move forward/backward, **A/D** move left/right, and **Q/E** pan left/right. These keys do not navigate the 2D authoring viewport. Navigation pauses when the editor window loses focus. If keys appear unresponsive, stop Play, activate the editor window, then click the 3D viewport to leave any focused text field. In Play, WASD is forwarded to scripts instead of moving the authoring camera.

## Move, rotate and scale

1. Select the object and choose **Move**, **Rotate** or **Scale** in the main toolbar.
Expand Down
2 changes: 1 addition & 1 deletion content/user/editor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ A folder organizes hierarchy; a primitive is renderable geometry. A script compo

## Viewport navigation

These controls apply to the authoring viewport when hovered/focused and no text field captures keyboard input:
These controls apply to the **3D** authoring viewport when hovered or focused. Click it to take keyboard focus back from an Inspector or Explorer text field. Navigation pauses when the editor window loses focus; stop Play to move the authoring camera.

| Control | Action |
| --- | --- |
Expand Down
Loading