Coding Creature

Asset Iteration Helper addon for the Godot Engine 4.4+

Version: 1.2.0
Godot Engine Compatibility: 4.4.0+
Author: Coding Creature
License: GPL 3.0
Code Repository: https://github.com/coding-creature-studio/godot-asset-iteration-helper
Follow on X: @CodingCreature

Overview

Asset Iteration Helper is a custom Godot import script designed to streamline the iterative workflow for 3D asset development. It enables modular asset updates, material preservation, and mesh reusability, making it easier to manage imported .glb files across multiple scenes.

Ideal for developers working in teams or constantly refining 3D models.

Installation and Use

Option 1: Use as a Per-File Import Script

  1. Save the script file (godot_asset_iteration_helper.gd) inside your project folder.
  2. In the Godot editor, select a .glb file from your FileSystem.
  3. In the Import dock, scroll down to Import Script.
  4. Select your script (godot_asset_iteration_helper.gd) and reimport.

Option 2: Use as a Global Import Script

  1. Place the script in a globally accessible location (e.g., addons/asset_iteration_helper/).
  2. Open Project > Project Settings > Import Defaults.
  3. Under Scene Import Settings, assign the script to the Import Script field.
  4. All future .glb imports will now use the helper automatically.

Main Features

FeatureDescription
Mesh ExtractionSaves each mesh from a .glb as a standalone .tres file using the format: file_name_mesh_name.tres.
Collision ExportCollision shapes are exported as separate .tres files: file_name_mesh_name_collision.tres.
Persistent References.glb files reference the generated .tres files, ensuring updates are preserved even across scenes or local instances.
Material Override PreservationIf a scene uses a mesh with a different material override, that override is retained after re-import.
Material SeparationOriginal materials are also saved as separate .tres files for easier management.

Import Structure

robot.glb
robot_head.tres
robot_head_collision.tres
robot_body.tres
robot_body_collision.tres
robot_metal_material.tres
robot_lights_material.tres

Changelog

v1.2.0 (August 2025)

  • Existing materials are not overwritten by default (can be changed in the config variables)
  • Minor fixes regarding naming files

v1.1.0 (August 2025)

  • First release version

License

This addon is licensed under the GNU General Public License v3.0 (GPL 3.0). You may use, modify, and redistribute the addon under the same license.

Learn more: gnu.org/licenses/gpl-3.0.html

Stay Connected