Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Node type customization using name suffixes

Часто під час редагування сцени виникають загальні потреби, які потрібно виконати після експорту:

  • Додати виявлення зіткнень до об'єктів.

  • Встановити об'єкти як навігаційні сітки.

  • Deleting nodes that are not used in the game engine (like specific lights used for modeling).

To simplify this workflow, Godot offers several suffixes that can be added to the names of the objects in your 3D modeling software. When imported, Godot will detect suffixes in object names and will perform actions automatically.

Попередження

All the suffixes described below are case-sensitive.

Вилучити вузли (-noimp)

Імена вузлів, з суфіксом -noimp, будуть видалені під час імпорту, незалежно від їх типу. Вони не з’являться на імпортованій сцені.

This is equivalent to enabling Skip Import for a node in the Advanced Import Settings dialog.

Створення зіткнень (-col, -colonly, -convcolonly)

Параметр -col працюватиме лише для об’єктів Mesh. Якщо він виявлений, буде додано дочірній вузол статичного зіткнення, що використовує ту ж геометрію, що і меш (сітка). Буде створена побудована з трикутників форма зіткнення, яка є повільним, але точним варіантом виявлення зіткнень. Цей варіант, як правило, потрібен для геометрії рівня (але дивіться також -colonly нижче).

The option -convcol will create a ConvexPolygonShape3D instead of a ConcavePolygonShape3D. Unlike triangle meshes which can be concave, a convex shape can only accurately represent a shape that doesn't have any concave angles (a pyramid is convex, but a hollow box is concave). Due to this, convex collision shapes are generally not suited for level geometry. When representing simple enough meshes, convex collision shapes can result in better performance compared to a triangle collision shape. This option is ideal for simple or dynamic objects that require mostly-accurate collision detection.

Однак в обох випадках візуальна геометрія може бути занадто складною, або недостатньо гладкою для зіткнень. Це може спричинити збої у фізиці та без потреб уповільнити роботу движка.

To solve this, the -colonly modifier exists. It will remove the mesh upon importing and will create a StaticBody3D collision instead. This helps the visual mesh and actual collision to be separated.

The option -convcolonly works in a similar way, but will create a ConvexPolygonShape3D instead using convex decomposition.

With Collada files, the option -colonly can also be used with Blender's empty objects. On import, it will create a StaticBody3D with a collision node as a child. The collision node will have one of a number of predefined shapes, depending on Blender's empty draw type:

Choosing a draw type for an Empty on creation in Blender

Choosing a draw type for an Empty on creation in Blender

По можливості, намагайтеся використовувати кілька примітивних форм зіткнень замість побудованої з трикутників сітки або опуклих фігур. Первісні форми часто мають найкращі характеристики та надійність.

Примітка

For better visibility on Blender's editor, you can set the "X-Ray" option on collision empties and set some distinct color for them by changing Edit > Preferences > Themes > 3D Viewport > Empty.

If using Blender 2.79 or older, follow these steps instead: User Preferences > Themes > 3D View > Empty.

Дивись також

Дивіться Collision shapes (3D) для детального огляду форм зіткнення.

Створити навігацію (-navmesh)

Вузол сітки (меша) з суфіксом -navmesh буде перетворений у навігаційну сітку. Оригінальний об'єкт Mesh буде видалено під час імпорту.

Створити VehicleBody (-vehicle)

A mesh node with the -vehicle suffix will be imported as a child to a VehicleBody3D node.

Створити VehicleWheel (-wheel)

A mesh node with the -wheel suffix will be imported as a child to a VehicleWheel3D node.

Тверде тіло (-rigid)

A mesh node with the -rigid suffix will be imported as a RigidBody3D.

Цикл анімації (-loop, -cycle)

Animation clips in the source 3D file that start or end with the token loop or cycle will be imported as a Godot Animation with the loop flag set. Unlike the other suffixes described above, this does not require a hyphen.

Для Blender це вимагає використання редактора NLA та іменування дії (Action) з префіксом, або суфіксом, loop чи cycle.