Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Settings dialog.
Create collisions (-col, -convcol, -colonly, -convcolonly)
----------------------------------------------------------

The option ``-col`` will work only for Mesh objects. If it is detected, a child
If the option ``-col`` is detected, a child
static collision node will be added, using the same geometry as the mesh. This
will create a triangle mesh collision shape, which is a slow, but accurate
option for collision detection. This option is usually what you want for level
Expand All @@ -80,6 +80,17 @@ This helps the visual mesh and actual collision to be separated.
The option ``-convcolonly`` works in a similar way, but will create a
:ref:`class_ConvexPolygonShape3D` instead using convex decomposition.

The types of Blender nodes that the above 4 options work with are summarized below.

+------------------+----------------------+--------------------+
| Suffix | Works on Mesh object | Works on Mesh data |
+==================+======================+====================+
| ``-col`` | ✔️ | ✔️ |
| ``-convcol`` | ✔️ | ✔️ |
| ``-colonly`` | ✔️ | ❌ |
| ``-convcolonly`` | ✔️ | ❌ |
+------------------+----------------------+--------------------+

With Collada files, the option ``-colonly`` can also be used with Blender's
empty objects. On import, it will create a :ref:`class_StaticBody3D` with a
collision node as a child. The collision node will have one of a number of
Expand Down
Loading