Quest 3 Controller Strafe Movement & On-Screen Hints

[buddha314]

Summary

Enhance VR controller support for Quest 3 with strafe movement and add on-screen controller hints for better UX.

Status: New
Priority: P1 (High)
Estimated Time: 4-6 hours
Labels: vr, quest3, controllers, ux, P1

Current Status

• ✅ 3D Chat interface works in VR
• ✅ Basic WebXR controller support enabled
• ❌ Strafe movement not configured for Quest 3 controllers
• ❌ No on-screen hints showing controller mappings

Tasks

Controller Movement (2-3 hrs)

• Configure thumbstick for strafe movement (left/right)
• Test thumbstick forward/backward movement
• Add smooth locomotion option
• Test on Quest 3 hardware
• Configure dead zones for thumbsticks
• Add movement speed controls

On-Screen Controller Hints (2-3 hrs)

• Create ControllerHints component (3D GUI panel)
• Display controller button mappings
  • Left thumbstick: Movement (strafe, forward/back)
  • Right thumbstick: Rotation/teleport
  • Trigger: Interact/select
  • Grip: Push-to-talk (future)
  • A/X buttons: Menu/actions
• Show hints on first VR session
• Add toggle to show/hide hints
• Position hints in comfortable viewing area
• Fade out after user demonstrates understanding

Controller Mapping (Quest 3)

Left Controller:

• Thumbstick: Strafe (left/right) + Forward/Back
• Trigger: Point & interact with UI
• Grip: (Reserved for push-to-talk)
• X button: Toggle menu
• Y button: (Reserved)

Right Controller:

• Thumbstick: Snap turn / Smooth rotation
• Trigger: Point & interact with UI
• Grip: Grab objects
• A button: Confirm/Accept
• B button: Cancel/Back

Files to Create/Modify

• client/src/lib/VRControllerConfig.ts - Controller configuration
• client/src/components/vr/ControllerHints.tsx - On-screen hints panel
• client/src/app/page.tsx - Update WebXR setup with movement config

Acceptance Criteria

• Left thumbstick enables strafe movement (left/right)
• Forward/backward movement works smoothly
• Controller hints appear when entering VR
• Hints clearly show all button mappings
• User can toggle hints on/off
• Movement feels natural (no jitter or lag)
• Dead zones prevent drift
• Tested on actual Quest 3 hardware

Dependencies

• Issue 3D Chat Screen & Immersive VR Application #45: 3D Chat Screen (already has basic VR support)
• Quest 3 hardware for testing

Testing Notes

Must test on actual Quest 3 device to verify:

• Thumbstick responsiveness
• Movement speed feels natural
• Hints are readable at distance
• No motion sickness from movement

Priority Rationale

P1 (High) - VR usability is critical. Without proper movement controls and hints, VR experience is frustrating for users.