godotengine / godot-docs

Godot Engine official documentation
https://docs.godotengine.org
Other
3.97k stars 3.23k forks source link

Rewrite "Importing 3D scenes" page #6201

Open FreshlyBrewedCode opened 2 years ago

FreshlyBrewedCode commented 2 years ago

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:

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.

yume-tea commented 1 year ago

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 commented 1 year ago

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.