Adds jiggle physics to bones of a Skeleton3D. It reacts to animated or global motion as if it's connected with a rubber band to its initial position. As it reacts to acceleration instead of velocity, bones of constantly moving objects will not "lag behind" and have a more realistic behaviour.
The node inherits from BoneAttachment3D and can also be used as such. It overrides the bone's global pose respecting the current pose, so the bone pose still be animated.
See the examples directory for some examples.
- Installation
- Usage
- Node Properties
- WiggleProperties Resource
- Pose Modes
- Functions
- Testing in Editor
- Breaking Changes from the Godot 3.x Version
Note Requires Godot 4.x. For Godot 3.x, see the 3.x branch.
- Search for
wigglebonein theAssetLibeditor tab - Download and install the plugin
- Enable the plugin in the project settings via the
Pluginstab
or...
- Clone this repository or download the archive
- Copy the folder
addons/wiggleboneto your project'saddonsfolder (create it if needed) - Enable the plugin in the project settings via the
Pluginstab
You can now add WiggleBone nodes to a Skeleton3D. See the example scenes in examples.
| Title | Name | Description |
|---|---|---|
| Enabled | enabled |
Enables or disables wiggling. When disabled, the bone returns to it's current pose. |
| Properties | properties |
Properties are stored in a separate WiggleProperties resource type. |
| Constant global force | const_force_global |
This applies a global constant force additional to the gravity already set in WiggleProperties. |
| Constant local force | const_force_local |
This applies a constant force relative to the bone's pose. |
| Bone Name | bone_name |
Inherited from BoneAttachment3D. Selects which bone should be used. |
Warning Should work when
BoneAttachment3D.override_poseistrue. UsingBoneAttachment3D.use_external_skeletonis not supported yet.
Properties are stored in a separate WiggleProperties resource type. This way, bone properties can be reused (saved) and shared between multiple bones, for example, on symetric bones.
| Title | Name | Description |
|---|---|---|
| Mode | mode |
Two different pose modes are supported: Rotation and Dislocation. |
| Stiffness | stiffness |
This is the bones tendency to return to its original pose. The higher the value the stronger the pull. |
| Damping | damping |
Reduces the bones motion. The higher the value the slower it moves in general. |
| Gravity | gravity |
The force pulling at the tip (mode Rotation) or origin (mode Dislocation). |
| Title | Name | Description |
|---|---|---|
| Length | length |
This defines the bone's length. At its end is the point at which gravity and other forces are pulling. This is required as the length influences the motion. |
| Max Degrees | max_degrees |
The maximum number of degrees the bone can rotate around it's pose. |
| Title | Name | Description |
|---|---|---|
| Max Distance | max_distance |
The maximum distance the bone can move around its pose. |
Two different pose modes are supported.
The bone rotates around its origin relative to the its pose. The rotation angle can be limited using Max Degrees (max_degrees). It has an upper limit of 90° due to the implementation. All values have a soft limit.
The bone moves around its origin relative to its pose without rotating. The distance can be limited using Max Distance (max_distance). All values have a soft limit.
This functions can be called on the WiggleBone node.
Adds a single impulse force for the next frame. If global is false, the force is relative to the bone's pose.
Resets movement and resets the bone to its pose. Can be used, for example, after "teleporting" the character (moving instantaneously a long distance) to prevent overshooting.
When a WiggleBone node is selected in the scene tree, a force can be applied to it by dragging its handle. The handle appears at the bone's end when Rotation mode is used or at the origin when Dislocation mode is used, respectively. Another way is to drag or rotate the Skeleton3D or one of its parents.
The editor gizmo (cone/sphere) can be hidden in the 3D viewport by disabling it in View > Gizmos > WiggleBone
mass_center(Vector3) was replaced bylength(float)const_forcewas renamed toconst_force_global
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent