Fix Mouse Capture / Pointer Lock Issues

Quick Diagnosis

Mouse won’t lock to the game window, or cursor escapes during aim.

Most issues are caused by browser focus, permissions, GPU settings, or extension conflicts.

Step-by-Step Fix

1. Click directly in the 3D viewport and accept pointer-lock prompt if shown.
2. Try entering fullscreen from the game page before aiming.
3. Check browser site permissions for cursor/pointer lock restrictions.
4. Disable overlays (screen recorders, GPU overlays) that hijack focus.
5. Use Open Original if embedded context blocks pointer lock in your browser.

Notes & Fallback

Some browser-security combinations treat iframe pointer lock more strictly than top-level pages.

If embedded mode still fails, use Games Hub and launch the original host page from each game detail page.

Related Guides

• Performance & Troubleshooting Guide
• Fix Low FPS
• Fix Input Delay
• Beginner FPS Roadmap

Likely Root Causes

• Pointer lock request is blocked by browser security context.
• Fullscreen and pointer lock sequence is triggered in wrong order.
• Overlay elements steal focus before lock can bind.
• High-DPI scaling/driver overlays interfere with cursor confinement.

Advanced Checks

1. Manually click inside the frame before entering fullscreen to prime pointer lock permissions.
2. Disable GPU overlays (recording/performance overlays) that can hijack pointer events.
3. Test windowed mode first; if lock works there, sequence fullscreen after lock is active.
4. Use another browser engine to confirm if issue is Chromium-only or profile-specific.

How to Confirm the Fix

• Cursor no longer escapes game bounds during wide horizontal flicks.
• Aim remains smooth through fullscreen toggle and back.
• Pointer lock survives at least one full combat wave.

If the issue returns, repeat the checklist after browser restart to isolate persistent versus session-only failures.