Documentation | Discord

---

2D squishy softbodies for the Godot game engine.

---

Adds the SoftBody2D node which creates a set of RigidBody2Ds and Joint2Ds used with a Skeleton2D in order to deform the texture.

Installation

• Automatic (Recommended): Download the plugin from the official Godot Asset Store using the Asset Store tab in Godot.
• Manual: Download the source code and move only the addons folder into your project addons folder.

Requires Godot 4.4 or newer.

Optional: Godot Rapier Physics

Force based breaking (break_mode = FORCE) needs Godot Rapier Physics: install it and select Rapier2D under Project Settings → Physics → 2D. Everything else works on stock Godot Physics.

Video Tutorial

Features

You can create multiple types of softbodies with this plugin, such as:

• Bouncy SoftBody2D
• Breakable/Deformable SoftBody2D
• SoftBody2D with Hole

Recent additions (see CHANGELOG.md): shape holding joint_reach, force based breaking, cut(), edge_clearance, bake_scale and debug_draw.

Demos live in demos/ (open demos/demo_hub.tscn) and tests in tests/ (godot --headless res://tests/run_tests.tscn). Run ./lint.sh before committing.

How this plugin creates a softbody

1. Create polygon from texture around edge.
2. Optionally do the same for hole texture.
3. Create multiple regions of same size around polygon.
4. Delete the regions the polygon or inside the hole polygon.
5. Creates a `Skeleton2D` child. Creates a set of `Bone2D` nodes of the `Skeleton2D`, each having a region and assign correct weights to them.
6. Creates a set of `RigidBody2D` nodes, one for each region with a `CollisionShape2D` child, a `RemoteTransform2D` child that targets the coresponding `Bone2D` position, and a set of `Joint2D` children that connect neighbouring rigidbodies. Also for each `Bone2D` node, make it lookat another neighbour node.
7. When the joint length is too big, the joints breaks. Then, the weights for both bones are updated to no longer have weights in the other region.

Star History