用途:面向 Godot 4.3+ 的资源导入与管理,涵盖图片压缩、3D 场景导入、音频格式、资源格式和导入配置。示例以 GDScript 为主、C# 为辅,不使用已废弃 API。
主要能力:
- 导入机制:文件放入 res:// 后按类型自动导入,设置存于同名 .import 文件;.godot/imported/ 为编译缓存,不应修改,.godot/ 应加入 .gitignore,.import 文件需提交版本控制。改设置后在 Import 面板点 Reimport。
- 图片导入:压缩模式含 Lossless、Lossy、VRAM Compressed、VRAM Uncompressed、Basis Universal;像素画与 UI 用 Lossless,3D 纹理与移动端大图用 VRAM Compressed。关键设置含 Mipmaps、Fix Alpha Border、Premult Alpha、Filter、Repeat。像素画可在项目设置将默认纹理过滤设为 Nearest。
- 3D 场景导入:推荐 glTF(.gltf/.glb),也支持 .blend、.fbx、.dae、.obj。节点命名后缀可自动生成节点,如 -col、-convcol、-rigid、-navmesh、-occluder。Import 面板可设 Root Type、Root Name、LOD、光照烘焙、动画导入与 FPS。运行时可用 preload()/load(),Godot 4.7+ 的 GLTFDocument 支持 ImportFlags 位域。
- 动画导入:在 Advanced Import Settings 的 Animations 标签按起止帧拆分片段并设循环模式;可用 Skeleton3D 重定向在不同骨架间共享动画。
- 音频导入:短音效用 WAV,音乐用 OGG Vorbis,MP3 作备选;可设 Loop、Loop Offset、Force Mono、BPM。3D 定位音频应启用 Force Mono。
- 资源格式:.tres 为文本、便于版本控制与手改;.res 为二进制、加载更快。场景用 .tscn 文本格式。大资源可用 ResourceLoader.load_threaded_request()/get_status()/get() 线程加载。
限制与注意:资料未提供安装命令、收费或平台信息。Godot 4.7 有变更:EditorSceneFormatImporter 多个常量移入 ImportFlags 枚举;字体 hinting 默认由 1 改为 3。常见问题含纹理模糊、透明边缘暗边、模型无碰撞、动画缺失、移动端显存过高、远处闪烁、音频循环爆音、场景文件过大、重克隆后设置丢失、线程加载卡顿等,均给出对应修复方式。