โ๏ธCustom Poses
Last updated
Last updated
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
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)
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
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.
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
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
GUI on the Scene View only while the editor hand is selected and if Gizmos are enabled
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.
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
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.