Skip to content

Document 3D viewport keyboard focus and navigation - #39

Merged
JamieW105 merged 1 commit into
mainfrom
fix/viewport-navigation-docs
Oct 14, 2026
Merged

JamieW105 merged 1 commit into
mainfrom
fix/viewport-navigation-docs

Conversation

@JamieW105

@JamieW105 JamieW105 commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Clarify how to restore WASD and Q/E navigation in the native 3D editor: click the viewport to return focus from Inspector/Explorer text fields, stop Play for authoring navigation, and activate the editor window. Document continuous movement, focus retention, directions and 2D limits.

Companion engine fix: Rustic-Game-Engine/engine#33

Validation: ESLint with zero warnings, production build (434 pages), TypeScript --noEmit, npm audit (zero vulnerabilities), documentation structure and exported link/anchor checks passed.

@JamieW105 JamieW105 added area:website Documentation website type:docs Documentation changes labels Oct 14, 2026
JamieW105 added a commit to Rustic-Game-Engine/engine that referenced this pull request Oct 14, 2026
Clicking the 3D viewport previously gave it keyboard focus and then
disabled WASD and Q/E: egui reports keyboard capture for any focused
widget, including the viewport itself. Allow the focused viewport to
receive its own keys, retain hover navigation when no other widget has
focus, and pause keyboard navigation when the editor window loses focus.
Use the same focus rule for embedded Play input.

Add headless egui regression tests for clicked/hovered viewports,
text-field focus and window focus loss. Document controls and recovery
steps in the engine guide and the companion website PR:
Rustic-Game-Engine/docs#39.

Validation:
- All 32 `rustic-editor` tests passed, including the three focus
regression tests.
- `cargo fmt --all -- --check` and `git diff --check` passed.
- `cargo clippy --locked -p rustic-editor --all-targets -- -D warnings`
passed.
- Companion website lint, production build, TypeScript, audit and
docs/link checks passed.
- All required engine CI checks passed on Linux and Windows, including
rendered viewport verification and application smoke tests.
- Windows CI built a fresh installer, tested toolchain failures and
packaged Setup, and uploaded the 21.7 MB `windows-installer` artifact:
https://github.com/Rustic-Game-Engine/engine/actions/runs/38491493926/artifacts/11862971142.

Native desktop interaction has not been manually tested in this
workspace.
@JamieW105
JamieW105 merged commit a77555a into main Oct 14, 2026
1 check passed
@JamieW105
JamieW105 deleted the fix/viewport-navigation-docs branch October 14, 2026 01:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:website Documentation website type:docs Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants