Stage Grab Mode
stage_grab_modeConfigure touch-based grabbing in VR: rest a hand on objects to hold them, then open the hand to release or toss, with configurable timing and object filters.
Instructions
Grab by touch: in VR a hand takes a thing by resting on it (the palm or the finger bases touching it, the hand nearly still) for hold_s seconds (a ring fills), holds it, and lets go when the hand opens past half its grip for release_s seconds (a ring empties; closing again keeps it). A let-go thing falls under gravity onto what is under it, with the hand's speed (a toss flies). Inside a person (stage_embody) the person's hand holds it, and the grab and the drop go into the take. Fingertips alone stay the pinch for menus. objects: "unlocked" (every small thing the scene does not lock) or a list of names, globs allowed (["drum_stick_*", "bottle"]). Grabbed things are never saved: the edits file keeps them where they stood. on=False lets go of everything held. Saved in world.json grab; stage_grab_rule sets one object (a fixed bar, a big thing allowed, a thing never taken). Emits: grab_counting, grabbed, grab_releasing, grab_released, grab_landed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| on | No | ||
| scene | Yes | ||
| hold_s | No | ||
| scenes | No | ||
| objects | No | ||
| release_s | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |