From 954b469e3bce5ea407bb12c9adc34cc5afed85f4 Mon Sep 17 00:00:00 2001 From: BenBlueeeee <120208759+BenBlueeeee@users.noreply.github.com> Date: Thu, 5 Feb 2026 17:51:32 +0000 Subject: [PATCH 1/2] Add summary of blender nodes that work with -col etc --- .../importing_3d_scenes/node_type_customization.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst b/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst index bd8ce6a83f0..6085913e3d2 100644 --- a/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst +++ b/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst @@ -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 @@ -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 From cf7cdcc29d31a996e4171661ee867e8cffb1174b Mon Sep 17 00:00:00 2001 From: BenBlueeeee <120208759+BenBlueeeee@users.noreply.github.com> Date: Thu, 5 Feb 2026 18:09:48 +0000 Subject: [PATCH 2/2] fix suffix formatting add double back ticks around around -col etc --- .../node_type_customization.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst b/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst index 6085913e3d2..38c0f213c5a 100644 --- a/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst +++ b/tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst @@ -82,14 +82,14 @@ The option ``-convcolonly`` works in a similar way, but will create a 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 | ✔️ | ❌ | -+--------------+----------------------+--------------------+ ++------------------+----------------------+--------------------+ +| 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