zachar3 / godot-destruction-plugin

Adds a method of converting a list of meshes into rigidbodies.

Godot Destruction Plugin

Addon for creating a destruction effect for meshes based on a segmented version.

demonstration.webm

Installation

For Godot 3 install and enable the Destruction plugin from the asset library.

For Godot 4 and above, download the addon from the releases and put the contents in the addons folder. It can then be enabled under plugin settings as usual.

Usage

1. Install the Cell Fracture addon in Blender, join your mesh and use F3 to search for Cell Fracture. Set the Source Limit to how many RigidBodies you want in your game. (~5 – 20)
2. Select everything, right click and select Set Origin > Origin to Center of Mass (Volume).
3. Export to Godot as OBJ or GLTF file.
4. Add a Destruction node to the intact node and set the Fragmented scene to the imported scene.
5. Call destroy() to destroy the object.

Performance

The plugin is only tested in very small scenes.

License

Code licensed under the MIT license.

Marble texture licensed CC0 by 3DTextures, optimized for file size.

All other files licensed under CC0.

This project is REUSE compliant.