Joint dynamics properties

The joint dynamics properties are part of the joint properties. Its dialog displays the dynamics settings and parameters of the last selected joint. If no object is selected, the dialog is inactive. If more than one joint is selected, then some parameters can be copied from the last selected joint to the other selected joints (Apply to selection-buttons. Be aware that this however only has an effect between joints of same type or mode):

[Joint dynamics dialog]


  • Motor enabled: enables or disables the motor of the joint. If disabled, the joint is free. Available only if the joint is in torque/force mode.
  • Target velocity: the target velocity for the joint motor. The target velocity will be instantaneously reached if the maximum torque/force is high enough; otherwise the target velocity is gradually approached.
  • Max. torque/force: the maximum torque or force at which the joint motor operates.
  • Lock motor when target velocity is zero: when the joint has its motor enabled and the control loop is disabled, then it acts in velocity control. When the target velocity is zero, then it may drift, since the torque/force will only act as internal friction. To avoid this, you can enable this item, which will lock the joint in position when its target velocity is set to zero.
  • Engine specific properties: allows adjusting engine-specific parameters. Refer to the dynamics engines properties dialog related to joints.
  • Control loop enabled: enables or disables the joint control loop. By default, a built-in PID controller is used (see further down).
  • Target position: the desired joint target position.
  • Upper velocity limit: allows limiting the regulation velocity to a maximum value.
  • Custom control: if enabled, then the joint will be controlled via a joint control callback script. This allows the user to write very specific joint controllers, that will be executed at each physics engine simulation step (i.e. by default 10 times more often than the simulation time step).
  • Edit custom control loop: allows editing the joint control callback script for a custom joint control.
  • Position control (PID): if enabled, then the joint will be controlled in position by modulating the joint velocity via the built-in PID controller.
  • Proportional / Integral / Derivative parameter: the PID position control parameters.
  • Spring-damper mode: if enabled, then the joint will be controlled in position by modulating the joint force/torque via the built-in spring-damper controller.
  • Spring constant K / Damping coefficient C: the spring-damper parameters.

  • Recommended topics

  • Joints
  • Joint types and operation
  • Joint properties
  • Dynamics module
  • Dynamics engines properties related to joints