Grabbing
More actions
In Resonite, most items(Including some avatars) can be grabbed and moved around by users. This also includes being able to climb surfaces or objects.
Grabbing can be controlled in a number of ways:
- For User's they can edit their Grab Options
- For creators, you can customize the grab behavior on individual items by editing the item's Component:Grabbable Component.
- The Grabbable Setter Tool allows easy selecting between an item being grabbable or not.
- The permissions system can also prevent grabbing using allow lists or block lists.
How to Grab
Controllers
On most controllers and control schemes there is a dedicated button usually called grab. You can find the matching button for your controller on our controls page.
Hand Tracking
Leap Motion & Vive Hand Tracking
For both Leap Motion & Vive Hand Tracking, these systems internally determine if you are pinching anything. Usually with your Index finger and Thumb.
When the pinch strength is reported to Resonite at a sufficient strength, we will then attempt a Grab. Items are detected within a short distance away from your Index finger or palm of hand, whichever matches an item first.
Both systems also report a "Grab Strength" which is currently unused there is a GitHub issue tracking that here.
Other
Other hand tracking items are not officially supported, you can find GitHub isuses for them to track:
Grab Options
In VR, an additional context menu item is available. 'Grabbing'. It contains two options:
- Grab - Swaps between various grabbing mode.
- Auto - Determines the grab mode automatically.
- If the hand is facing up Palm Grab is used, otherwise Precision.
- Precision - Uses the space between the tip of your index finger and the tip of your thumb to determine the grabbed items.
- Operates like a "Pinch" gesture but is still triggered by the standard Grab button on your controller.
- Laser - Only allows grabbing via lasers.
- Auto - Determines the grab mode automatically.
- Hold to Hold/Sticky grab
- Toggles between needing to hold 'grip' to hold the item and 'grip' toggling grabbing an item on and off.
The default grab mode can be chosen in Grabbing Settings
Grab Spheres
Officially called 'Grab Areas', they the part of the Avatar that is the area of effect for 'Palm' grab, their position and activation(Spheres turn red) can be viewed in Edit mode.
Their position is set on an avatar(Initially in the Avatar Creator) by the location of a Component:AvatarToolAnchor, these are typically found on the hand slot.
Video
See Also
Control over items that can be grabbed
- Component:Grabbable - Component for controlling what can be grabbed
- Component:Slider - Grabbing without reparenting
- Category:ProtoFlux:Interaction:Grabbable - For a list of ProtoFlux nodes related to grabbing
- Component:GrabBlock - A way to stop something from being grabbed
World/environment controls
- Component:GrabbablePermissions - World level grabbable controls
- Component:LocomotionGrip - Allow a surface to be climbable
Avatar systems that control/relate to grabbing
- Component:Grabber - The part of the avatar that allows for grabbing
- Component:InteractionHandler#HandGrabType - Documentation on the Grab Settings within the InteractionHandler component.