Skip to main content

Generate Twist Bones (Alpha)

🌊 Any Platform

Improves the look of the elbow joint by generating twist bones covering part of the lower arm that is closer to the elbow.

It creates new twist bones with constraints, and automatically repaints the bones weights of all meshes of the avatar which use that bone.

warning

🚧🚧🚧 This component is currently in an alpha phase. 🚧🚧🚧

At the moment, it only fully supports meshes that are part of the base mesh armature.

The current version will not be able to generate twist bones for additional meshes used by VRCFury Armature Link, and may not be able to generate twist bones for additional meshes used by Modular Avatar Merge Armature.

Both are intended to be supported in the future, but it's significantly harder to do so. The component is still released in this state of development as it is beneficial for the bare skin of your avatar.

Thank you for your understanding.

Video comparison of before, and then, after twist bones are added on the arm. Notice how the outlines bite on the elbow joint.

twist-compare.png Left: Generate Twist Bones active / Right: Original avatar

How to use

To use this component:

  • Add a "PA Generate Twist Bones" component anywhere in your avatar.
  • The tool will be setup to handle the elbow joint by twisting the part of the lower arm that is closer to the elbow.
info

If you're encountering difficulties with the use of this component, please report any issues on the Discord server. Thank you!

このコンポーネントの使用に問題がある場合は、Discordサーバーで問題を報告してください。 ありがとうございます!

Unity_N37ilQuCVl.png

warning

🚧🚧🚧 This component is currently in an alpha phase. 🚧🚧🚧

At the moment, it only fully supports meshes that are part of the base mesh armature.

The current version will not be able to generate twist bones for additional meshes used by VRCFury Armature Link, and may not be able to generate twist bones for additional meshes used by Modular Avatar Merge Armature.

Both are intended to be supported in the future, but it's significantly harder to do so. The component is still released in this state of development as it is beneficial for the bare skin of your avatar.

Thank you for your understanding.

Option: Custom weight distribution

Vertices that are located inside the space between the lower arm bone and the hand bone are repainted based on their distance to the lower arm bone.

The component will use a linear weight distribution by default, meaning that the weight is directly proportional to that distance.

You can choose a custom Weight Distribution curve. The X axis of the curve represents the normalized distance to the lower arm bone.

The curve should look like a slope going uphill. Always keep the (0,0) and (1,1) points where they are.

tLLlJZ4XEX.pngrR2EJxtTwA.png

Option: Bracelets and Wristwatches

If you're wearing arm bracelets, or a wristwatch, or any rigid object which is part of your arm as a SkinnedMeshRenderer (simple MeshRenderers do not count), you need to specify blendshapes that either show or hide those bracelets. These blendshapes are used to figure out which vertices are part of that bracelet.

Performance considerations

Each twist bone:

  • Adds one bone to the avatar's main Armature that is used by mesh skinning, and
  • Adds one constraint.

By default, the component adds one twist bone for each arm, making for a total of 2 bones used by mesh skinning, and 2 constraints.

If there are multiple components that create the same twist bone on different SkinnedMeshRenderers armatures, but it's effectively the same bone when the armatures are merged together, then only one constraint is created.

Experimental compatibility options

note

🚧🚧🚧 These options are experimental and are likely to be removed in future updates. 🚧🚧🚧

This component is currently in an alpha stage, as there are technical difficulties to integrate this component so that it works with various armature merging systems such as VRCFury Armature Link and Modular Avatar Merge Armature.

For this reason, some experimental options are available during this alpha stage to try some things out.

Default mode

By default, this component will execute after Modular Avatar Merge Armature executes.

"Execute before Modular Avatar Merge Armature"

When enabled, this component will be processed before Modular Avatar Merge Armature executes.

This can be used to create twist bones in other armatures using the Use Custom option, before Modular Avatar or VRCFury tries to merge armatures.

"Execute in Optimizing phase"

When enabled, this component will be processed during the Optimization phase.

This is supposed to be an incorrect use of the Optimization phase as generating twist bones is not an optimization, but it gives a chance to try executing this component in a particular point in the build process.

Versions

  • 1.11.1: Fix Generate Twist Bones help URL no longer points to localhost.
  • 1.11.0: Added.

Classification: This component is application-agnostic, however, the quality and relevance of the generated twist bones heavily depends on the inverse kinematics strategy or animation system used by your target platform or app, as different platforms and apps may orient the arm bones differently for a given arm position. This can make the generated twist bones irrelevant on some platforms or apps.