Import world textures¶
For a downloadable world, set Basis Universal (compress/mode = 4) and
mipmaps explicitly before importing. Headless import does not perform the editor's
3D texture-detection step.
Set the defaults¶
In your world's project.godot:
[importer_defaults]
texture={
"compress/mode": 4,
"detect_3d/compress_to": 0,
"mipmaps/generate": true
}
Basis transcodes for the target GPU, so one pack can serve multiple platforms. Mode 2 instead bakes platform-specific GPU blocks.
Reimport existing textures¶
Defaults affect newly created .import files only.
- Update the affected textures' import settings, or regenerate their
.importfiles. - Set
compress/normal_map = 1for normal maps; automatic detection can miss them. - Reimport, then export the world pack.
Check the result¶
Inspect imported texture formats and reported video memory. Source PNG size and on-disk cache size do not tell you GPU memory use.
The recorded reference scene used 311.4 MB with headless defaults versus 42.9 MB with platform compression, mipmaps, and normal-map settings. See measurement details.