Skip to content
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

Rewrite "Importing 3D scenes" page #6201

Open
FreshlyBrewedCode opened this issue Sep 19, 2022 · 2 comments
Open

Rewrite "Importing 3D scenes" page #6201

FreshlyBrewedCode opened this issue Sep 19, 2022 · 2 comments
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement

Comments

@FreshlyBrewedCode
Copy link

FreshlyBrewedCode commented Sep 19, 2022

Your Godot version: 4.0 beta1

Issue description: The current documentation about importing 3D assets from external tools such as Blender is outdated. It does not cover the new workflow present in the latest 4.0 beta release. It also seems to be missing some notable 3.x features.

URL to the documentation page (if already existing): Importing 3D scenes

Context

I've recently started experimenting with Godot and was struggling to find a good workflow for importing 3D assets. This was partially because the latest documentation is not up-to-date with the latest beta build of Godot 4.0. However, I found it generally difficult to figure out a reliable 3D workflow from Blender to Godot using just the official docs.

Missing/Outdated Documentation

Related to #5121.

Improvements

Here are some general ideas for improving the clarity of the page:

  • Instead of having several Exporting <format> from Blender sections, create sections for different formats/tools (e.g. "Importing from Blender", "Importing from Maya", "Importing FBX").
    • Cover the available options for getting 3D assets from a given tool into Godot and mention the recommended approach (if applicable)
      • Blender
      • Maya
      • 3DS Max
      • Substance
    • Cover specific limitations/features/considerations for a given file format
      • glTF
      • FBX
      • OBJ
      • DAE

Please note that these are points I noticed after only several days of using Godot. I may have missed documentation that is already available elsewhere. However, I assume my experience is similar to what many other first time Godot users experience, and this is a common topic for first time users.

@FreshlyBrewedCode FreshlyBrewedCode changed the title Rewrite Importing 3D scenes page Rewrite "Importing 3D scenes" page Sep 19, 2022
@skyace65 skyace65 added the area:manual Issues and PRs related to the Manual/Tutorials section of the documentation label Dec 28, 2022
@yume-tea
Copy link

yume-tea commented Jan 5, 2023

Screenshot 2023-01-04 172207
Just wanted to add that this section on custom import scripts is also outdated. The post_import(scene) method was changed to _post_import(scene) in Godot 4

@Deozaan
Copy link

Deozaan commented Mar 13, 2023

I found what I believe is a copy-paste error on this documentation page.

Generate > NavMesh: If checked, generates an OccluderInstance3D sibling node for occlusion culling using the mesh's geometry as a basis for the occluder's shape.

I believe it should say Generate > Occluder or something similar instead of NavMesh. There is a paragraph just above it that is about NavMeshes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement
Projects
None yet
Development

No branches or pull requests

4 participants