Skip to content

Document how to opt out of name suffix customization in 3D import #10835

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
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 @@ -20,11 +20,33 @@ will detect suffixes in object names and will perform actions automatically.
All the suffixes described below can be used with ``-``, ``$``, and ``_`` and are
**case-insensitive**.

Remove nodes (-noimp)
---------------------

Objects that have the ``-noimp`` suffix will be removed at import-time no matter
what their type is. They will not appear in the imported scene.
Opting out
----------

If you do not want Godot to perform any of the actions described below, you
can set the ``nodes/use_node_type_suffixes`` import option to ``false``.
This will disable all node type suffixes, which keeps nodes the same type
as the original file indicated. However, the ``-noimp`` suffix will still
be respected, as well as non-node suffixes like ``-vcol`` or ``-loop``.

Alternatively, you can completely opt out of all name suffixes by setting
the ``nodes/use_name_suffixes`` import option to ``false``. This will
completely stop the general scene import code from looking at name suffixes.
However, the format-specific import code may still look at name suffixes,
such as the glTF importer checking for the ``-loop`` suffix.

Disabling these options makes editor-imported files more similar to the
original files, and more similar to importing files at runtime.
For an import workflow that works at runtime, gives more predictable
results, and only has explicitly defined behavior, consider setting these
options to ``false`` and using :ref:`class_GLTFDocumentExtension` instead.

Remove nodes and animations (-noimp)
------------------------------------

Nodes and animations that have the ``-noimp`` suffix will be removed at
import time no matter what their type is. They will not appear in the
imported scene.

This is equivalent to enabling **Skip Import** for a node in the Advanced Import
Settings dialog.
Expand Down Expand Up @@ -132,3 +154,16 @@ will be imported as a Godot :ref:`class_Animation` with the loop flag set.

In Blender, this requires using the NLA Editor and naming the Action with the ``loop`` or
``cycle`` prefix or suffix.

Material alpha (-alpha)
-----------------------

A material with the ``-alpha`` suffix will be imported with the
:ref:`TRANSPARENCY_ALPHA<class_BaseMaterial3D_constant_TRANSPARENCY_ALPHA>` transparency mode.

Material vertex color (-vcol)
-----------------------------

A material with the ``-vcol`` suffix will be imported with the
:ref:`FLAG_ALBEDO_FROM_VERTEX_COLOR<class_BaseMaterial3D_constant_FLAG_ALBEDO_FROM_VERTEX_COLOR>` and
:ref:`FLAG_SRGB_VERTEX_COLOR<class_BaseMaterial3D_constant_FLAG_SRGB_VERTEX_COLOR>` flags set.