GrabStep

​

Role

​

Inspector

​

Code

• completeOnGrab without requireHoldDuration — CompleteGrab() runs on grab if ValidateGrabPosition() passes.
• requireHoldDuration — UpdateStep completes once hold time ≥ minGrabDuration and completeOnGrab is true.
• completeOnRelease — completes on release if not already completed.
• ForceComplete() — bypasses position checks after setting internal completed flag.

// Designer-driven: assign XRGrabInteractable + toggles in Inspector.
// Runtime override example — require left hand only:
using MolcaSDK.VR.Scenario;
using UnityEngine.XR.Interaction.Toolkit.Interactors;

public class GrabSetup : UnityEngine.MonoBehaviour
{
    public GrabStep step;
    public XRBaseInteractor leftHand;

    private void OnEnable() => step.SetRequiredInteractor(leftHand);
}

​

Troubleshooting

• Console: no XRGrabInteractable found — Assign grabInteractable or enable autoFindInteractable and put a XRGrabInteractable on this object or a child.
• Grab registers but step never completes — Check completeOnGrab vs completeOnRelease, requireHoldDuration / minGrabDuration, interactor filters (allowAnyInteractor / requiredInteractor), and position requirement (targetPosition + positionTolerance).
• Wrong hand counts — Set requireSpecificInteractor and assign the XRBaseInteractor for the intended controller.

​

Related

• Step (base class) — lifecycle and Complete()
• VR player manager — disable locomotion during precision grabs
• VR inventory — storing grabbed props

​

Unity Editor

GrabStep on a prop with XRGrabInteractable in same hierarchy.