GLTF Level Importer Addon for Godot

Tools that enable you to build entire functional levels in Blender for Godot. It extends the GLTF import functionality to provide allow seamless importing of Godot Nodes and Scenes from Blender, and enables re-use of Godot resources like Materials for optimization and a more efficient workflow.

    Features:

• Replace placeholder objects with PackedScenes and set properties to customize their behaviour.
• Automatically replace GLTF materials with any Godot ones by name.
• Create optimized Box and Sphere CollisionShape3D's directly in Blender. Also create FogVolume and OccluderInstance3D.
• Convert Bezier curves to Path3D, full support including aligned and free handles, tilt, and the option to loop curves by connecting the first and last points.

• Create MultiMeshInstance3D from Blender Instances (experimental, may be replaced with the GLTF extension available in Blender 4.0)

    Why?

Switching between software breaks your flow, being able to build out your level geometry and the functional parts of your level in one program maximises your productivity.

You can leverage the power of a dedicated level editor like Hammer without having to reinvent the wheel, customize Blender layouts and shortcuts to optimize your workflow.

Take advantage of an existing Blender ecosystem to power your level design. Build level geometry and texturing with addons like DreamUV, Geometry Nodes to build custom tools like MultiMesh scatterers with more flexibility and real-time feedback compared to Godot's existing toolset, and use Asset Libraries to organize and search your scenes and materials.

    How to use the addon:

1. Install the addon by dropping the folder in your Addons directory and enabling it.
2.  Create a new GLTFLevelImporterDefault Resource where you can define which folders the addon will use to find meshes and scenes, and what files the importer will be used for.
3. In the addon folder you will find the gltf_register_scene.tscn scene, add your Resource to the "Extensions to Register" array and save the scene.
4. Restart the editor to take effect.

Note: Advanced users can create a new class inheriting GLTFLevelImporterBase to have full control over how Scenes, Materials, etc are collected and when the Extension is used.

    How to set up in Blender:

In your GLTF export settings you must enable Custom Properties and under Data - Mesh enable Attributes and Loose Points. It is also recommend to disable image exporting in Data - Material - Images - None to optimize exported file size. Add the ld_geonodes.blend file to your Asset Libraries in Blender to access the export geonodes anywhere.

• Entities can be defined with a custom property named entity, with the value as the name of the scene. Any Custom Properties that share the name of a property on that scene will also be set. You set these entities up in an AssetLibrary and link them, then enable Override Properties to edit the values.
• Materials only need to have the same name as one in your Material folder. You will need to set up the materials separately in Blender and Godot.
• CollisionShapes, OccluderInstance, and FogVolumes can be defined with the Custom Properties "collshape", "occluder", and "fogvolume" respectively, and the value should be "box" or "sphere". Box shapes should not be rotated in edit mode as this will lead to errors but the object itself can be rotated. Collision shapes will also automatically have their scale adjusted to prevent errors.
• Bezier Curves should have the Custom Property "path" and the value "bezier". You need to enable the Bezier Curves Export geometry node supplied when exporting. The Custom Property "loop" with a boolean value can be used to connect the start and end points on the path.
• Multimeshes need the Custom Property "multimesh" and the value must be the name of the mesh defined in your mesh folder.  You need to enable the Instance Export geometry node supplied when exporting.

    Supported versions:

Godot 4.2.x

Blender 3.6