Skip to content

Basic Usage

Jump to bottom
Hiroyuki Akasaki edited this page Jul 14, 2025 · 4 revisions

boneDynamicsNode allows dynamics settings for one section (2 joints) per node. When applying to a joint chain with multiple joints, multiple boneDynamicsNodes are required.

basic_usage.py is a script that applies boneDynamicsNode to any joint chain. Select the joint chain from root to tip in order and execute the script.

basic_usage

Initial Parameters to Check

  • Enable : Disables all calculations when turned off.
  • Reset Time : Dynamics are disabled when the current frame is equal to or less than this value. This is the start frame of the simulation.
  • Fps : Used to calculate delta time. Enter a value equal to the FPS of the scene. Default is 30.

For detailed dynamics settings, refer to Dynamics Parameters.

Required Settings

Check the following settings to ensure correct results:

  • Set "Playback Speed" to Play Every Frame.
  • Disable "Cached Playback".

Note: Starting from version 0.4.2, "Cached Playback" is automatically disabled by the node.

Joint Requirements

There are several requirements for joint states. If you create joints with Create Joints and set Orient Joint, these requirements should normally be met.

  • Rotate should be [0,0,0], with only Joint Orient having a value.
  • Do not edit rotatePivot, rotatePivotTranslate, scalePivot, or scalePivotTranslate.
  • Rotate Order is only available for xyz.
  • Rotate Axis should remain [0,0,0].
  • Keep Inherits Transform checked.
  • Keep Offset Parent Matrix at its default value.
  • Receive InverseScale from the parent Scale and keep Segment Scale Compensate checked. Shear is not supported.

joint_requirements

Bake to Keyframes

Before rendering, bake to keyframes to finalize the dynamics behavior. To bake, select the joint and execute Bake Simulation from the Key menu, then delete the boneDynamicsNode.

Clone this wiki locally