[JaXt0r]

Merge order: 1a → 1b → 1c → 1d → 2a → 2b → 3a → 3b → 3c, all into engine/hvr-replacement (no stacking). Each branch still contains the commits of the earlier steps, so after the earlier PR is merged the diff of this one shrinks to its own step. Plan: Docs/HVR-replacement/.

Description

Phase 2a: item grabbing on the Xri backend (needs 1x). Default backend stays Hvr.

• A NearFarInteractor per hand (direct grab, distance grab that pulls the item to the hand, UI pointing on the same ray) replaces the 1c UI-only rays. Own line-of-sight filter, 10 m range.
• GothicGrabInteractable (velocity tracking, two hands, throw) + XriInteractableBridge on oCItem raise the same VrInteractable events as HVR (BeforeGrabbed, Grabbed, Released, hover). Only the active backend's bridge runs.
• Grabbing/hovering is switched off while swimming. A small sphere per controller is the stand-in hand (hands are Phase 5, on hold).

To test

• - Hvr: grab, throw and distance-grab items exactly as before.
• - Xri: grab an item with each hand; distance grab pulls it into the hand (label appears on hover).
• - Xri: grab with both hands, release one → still held; drop → falls normally.
• - Xri: a wall between hand and item prevents hover/grab.
• - Xri: swim → no hover/grab; leave water → works again.
• - Xri: menu laser still works.
• Known: grabbed world items add 0 to the inventory on both backends (Amount is 0, see Docs/HVR-replacement/found-bugs.md). Throw feel is XRI default, not tuned. Every loaded item is processed by XRI each frame → check frame time on Quest in item-dense places.

Test on (delete if irrelevant)

• PCVR
• Mobile VR (Quest/Pico)

🤖 Generated with Claude Code