✍️Custom Poses

Overview

Sometimes auto generated poses won't cut it and you need something more custom or restrictive, for example: you always want the user to grab a tea cup by the handle instead of by cup body. This is where Grabbable Poses come in handy

Poses are saved by caching the transform positions/rotations of each Transform under the Hand Object then applying those positions when a pose is activated. This means that poses are saved on a per-rig basis, if you have multiple hands with different rigs you will have to save multiple poses to one object using a different pose index value for each hand and each pose. This also means that if you change hand models later in production you must either use the same rig as the old hand or recreate your custom poses.

Video showing how to setup an advanced pose. Very similar process for setting up a non-advanced pose and pose area

Grabbable Pose

Good for simple static custom poses that the automatic pose system has trouble producing or poses you want to force the player to always have, like a weapon, mug, or pen. For a more complicated pose like a doorknob you want to grab from any angle or a stick you want to grab only along or around, use the Advanced Grabbable Pose.

Multiple poses can be added to one grabbable. By default the pose that is closest to the hands relative position and rotation on grab will be chosen.

(Optional) If you have an object made of multiple colliders you can add a Grabbable to each collider and have a different pose attached to each collider.

Pose Enabled will only allow the pose to be used when true

Pose Name is for organizational purposes and is not required

Pose Index needs to match the hand's pose index for this pose to work (This is to allow multiple hand models to have different poses saved on one grabbable object)

Advanced Settings

Position Weight the higher the position strength the more this pose will be prioritized based on the hands distance when deciding between multiple poses

Rotation Weight the higher the rotation strength the more this pose will be prioritized based on the hands distance when deciding between multiple poses

Linked Poses all the poses in this list will only be active when this pose is currently grabbed. Good for things like a shotgun you only want the barrel to be grabbable with the second hand when the trigger is held

Pose Scriptable

Pose Scriptable is used to save and pass a pose between different grabbable pose components. A pose scriptable can be created by right clicking in the project window and selecting Create/Auto Hand/Custom Pose, then attaching it to a Grabbable Pose.

Right Click in the Project window, Auto Hand/Custom Pose

Overwrite button shows when scriptable not empty

When you add a scriptable pose to a grab pose a button prompt will appear that will allow you to overwrite the pose scriptable with the pose saved on the local grabbable pose

When you add a saved scriptable pose to a grabbable pose it will priories the poses on the scriptable

Pose Editor Hand

You can create an editor hand by creating a hand copy of one of the existing hands in the scene

When you select the hand copy you will see a tool like this (if gizmos are enabled)

Use this tool to pose the hand, invert the hand to be opposite left/right, and save the poses

Remember to delete the hands copy when done creating a new pose

GUI on the Scene View only while the editor hand is selected and if Gizmos are enabled

Advanced Grabbable Pose

Uses the same root settings as the grabbable pose

This component will enforce a pose along the given angles and range from the point the pose was saved in for objects that need to be grabbed across a strict line and/or radius, like a bat handle or a steering wheel.

Setup Video

Center Object optional override the pivot point that the pose will rotate and move across the range of. Important for objects with mesh's that aren't centered with a handle or line.

Up is the direction in which your advanced pose will rotate around. Represented by a white disc around the transform or center object

Use Invert Pose will allow the hand turned 180 degrees on the axis to be used.

• If enabled on a pose that holds a hammer with the thumb facing up and hammer head facing up it will also allow for the pose to be held with the thumb facing up and the hammer head facing down

Angle of the pose allowed around the local up direction of the transform or center object

Range of the pose allowed along the local up direction of the transform or center object

Test Angle/Range can be used to test what the pose will look like at a specific angle. It will update the position of the active Editor Hand when the values change and gizmos are enabled

Hand Pose Areas

Force the hand to take the saved pose when entering the trigger area of this object. Will only activate when not holding an object Useful for creating poses when a hand is near something, like a small button to press with the index finger.