godot-docs/tutorials/assets_pipeline/escn_exporter/physics.rst

Physics properties
==================

Exporting physics properties is done by enabling "Rigid Body" in Blender's
physics tab:

.. image:: img/enable_physics.png

.. important::
    By default, a single Blender object with rigid body enabled will export as
    three nodes: a PhysicsBody, a CollisionShape, and a MeshInstance3D.

Body type
---------

Blender only has the concept of "Active" and "Passive" rigid bodies. These
turn into Static and RigidBody nodes. To create a kinematic body, enable the
"animated" checkbox on an "Active" body:

.. image:: img/body_type.jpg

Collision shapes
----------------

Many of the parameters for collision shapes are missing from Blender, and many
of the collision shapes are also not present. However, almost all of the
options in Blender's rigid body collision and rigid body dynamics interfaces
are supported:

.. image:: img/collision_shapes.jpg

There are the following caveats:
 - Not all of the collision shapes are supported. Only ``Mesh``, ``Convex
   Hull``, ``Capsule``, ``Sphere`` and ``Box`` are supported in both Blender and
   Godot
 - In Godot, you can have different collision groups and collision masks. In
   Blender you only have collision groups. As a result, the exported object's
   collision mask is equal to its collision group. Most of the time, this is
   what you want.

.. important::
    To build compound physics shapes, parent together multiple objects with
    rigid body enabled. The physics properties are taken from the parent-most
    rigid body, and the rest are used as collision shapes.

Collision geometry only
-----------------------

Frequently you want different geometry for your collision meshes and your
graphical meshes, but by default, the exporter will export a mesh along with the
collision shape. To only export the collision shape, set the object's maximum
draw type to Wire:

.. image:: img/col_only.png

This will also influence how the object is shown in Blender's viewport.
Most of the time, you want your collision geometry to be shown see-through when
working on the models, so this works out fairly nicely.