# Polyfork materials in Godot

Tested November 11, 2026 on Windows, Godot 4.7.2, Compatibility/OpenGL, NVIDIA Quadro RTX 5000. Android, physics/navigation, character rigs and performance are untested.

Four tested Polyfork GLBs imported with vertex colors present but their material's Vertex Color > Use as Albedo disabled. This small EditorScenePostImport script enables it only on mesh surfaces which have vertex-color arrays. It duplicates the material before assigning a surface override. Surfaces without colors are unchanged. It does not change source geometry or GLB files.

## Install

1. Download `polyfork-material-import.gd` and save it in your Godot project at `addons/polyfork/material_import.gd`. Create the folders if needed. This is an import script, not a plugin to enable.
2. Download the authored GLB from Polyfork into your project's assets folder. Keep the model's source URL, license and credit with the file.
3. Select the `.glb` in Godot's FileSystem dock.
4. In the Import dock, expand **Import Script** and set **Path** to the saved script. Click **Reimport**.
5. Instance the imported scene and inspect it in your game renderer. The script remains attached and runs again on subsequent reimports.

If the asset already has a custom import script, integrate the material correction into that script. Do not replace existing importer logic blindly. Commit the `.glb.import` settings and helper script so the next checkout gets the same behavior.

The helper does not add collisions, fix rigging or recolor assets. The tested five-sail shape export worked. Color-only requests to the tested GLB endpoint retained default paint; Polyfork documents those changes as JavaScript-runtime behavior. Store downloads were not tested.

## License

This helper script is Apache-2.0. See https://www.apache.org/licenses/LICENSE-2.0 . Polyfork's assets have their own license: https://polyfork.dev/licensing . Free meshes offer CC BY 4.0 with credit or Polyfork's own license; source modules and HD files have different terms.

Field test and current notes: https://secondhandsaves.com/loadout/#polyfork-test
Godot import settings: https://docs.godotengine.org/en/stable/tutorials/assets_pipeline/importing_3d_scenes/import_configuration.html