PhysicalLocomotion has a feature which is unique to it, called Gripping. This feature allows you to grip other objects in the world in order to use them to climb or traverse the world. A good analogy is rock climbing as this is exactly how this feature feels to use. Gripping, only works when allowed by the world author.
This feature is commonly called "Climbing" or "Physical Grab/Climbing" or even "Player Climbing", the official name "Gripping" will be used throughout this page.
Additionally, this feature is often confused with "Grabbables" which refer to any object in that you can move around in the world by grabbing it. These features are independent, for a quick way to remember the difference:
Grabbing involves 'moving an object which you are "Grabbing"
Gripping involves moving you using an object which you are "Gripping"
Or if that doesn't work, its the difference between climbing a ladder and moving that ladder.
World authors can configure this feature by changing the properties on the PhysicalLocomotion component. The main property here is "Gripping" which has the following settings and meanings:
Disabled - Fully prevents any gripping in this world when using this locomotion module.
GrippableObjects - Allows gripping on objects that are explicitly tagged with a Component that indicates that a Slot or Object can be gripped. These components are:
LocomotionGrip - The most common. Used to explicitly signal the grippable state of an object.
Gizmos - These are also tagged as "GrippableObjects" but cannot be gripped, see #Gripping Process below for more info.
CharacterColliders - Allows gripping on objects that contain colliders who's "CharacterCollider" property is enabled
AnyObjects - Allows gripping on anything, including players.
Gripping Process
When a user attempts to grip in a world, the following steps occur to determine if there is a successful grip or not.
If gripping is set to Disabled, stop. You can't grip ever.
If there is already a grip in progress, as in is this user already holding onto another object. Stop. You can only have one active grip.
Run a physics operation to get any colliders within the "GripRadius" of the user's actively gripping hand.
Filter the returned colliders:
If the collider's active user is the same as the active user of the collider, remove it from the results.
If gripping is set to AnyObjects, all colliders in the "GripRadius" are included.
If gripping is set to CharacterColliders, colliders who do NOT have the "CharacterCollider" checkbox enabled are removed from the results.
If gripping is set to GrippableObjects, colliders who do NOT have a "LocomotionGrip" component on them or within their parents are removed from the results.
From the filtered list the first collider which passes ALL the following rules is then "Gripped":
If the collider has a "LocomotionGrip" component on them or within their parents, it must be Enabled.
The collider must NOT be a part of a Gizmo
Gripping Users
Gripping users is treated the same way as the "Gripping Process" above. So keep the following items in mind:
You cannot manually opt in to be grippable by editing your avatar unless the Gripping property on the locomotion is set to "GrippableObjects", if this is the case add a "LocomotionGrip" component to your avatar root and enable it.
If you want to opt out of being grippable then regardless of the world settings, you will need to add a "LocomotionGrip" component to your avatar root AND User Root and uncheck their Enabled properties.
Examples
Related Components
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
