Импорт ресурсов и повторный импорт
Что хранится в .import и кэше, как применять изменения и загружать обработанный ресурс.
Что сохранять при импорте
Импорт превращает исходный ассет в ресурс, который использует движок. Копируйте исходные файлы в проект вместе с зависимостями: для отдельного glTF это .gltf, .bin и изображения по относительным путям.
| Файл | Назначение | В системе контроля версий |
|---|---|---|
| исходный ассет | модель, изображение, звук или другой исходник | сохраняйте |
| имя_ассета.import | импортёр, параметры, UID и путь к результату | сохраняйте рядом с ассетом |
| .reckfell/imported/ | создаваемый кэш обработанных ресурсов | обычно исключайте; он восстанавливается импортом |
| внешний материал или другой извлечённый ресурс | ваши самостоятельные настройки | сохраняйте вместе с его метаданными и зависимостями |
Не редактируйте только кэш: повторный импорт может пересоздать его. .import — не текстура и не замена исходному файлу. Потеряв его, вы теряете в том числе индивидуальные настройки импорта.
Обычный порядок работы
- Поместите исходник в каталог проекта. Выберите его в Content Browser — браузере ресурсов.
- Откройте Import и настройте параметры нужного ассета.
- Нажмите Reimport, дождитесь окончания обработки и проверьте результат.
- Измените исходник во внешнем приложении, сохраните его и вернитесь в редактор. Повторная обработка должна сохранить выбранные параметры.
Пока не нажата Reimport, настройки панели не применены. Выбор другого ресурса может отбросить несохранённые изменения — это отдельно указано в подсказке кнопки. При массовом редактировании отмечайте только параметры, которые действительно нужно заменить: для одинакового импортёра панель поддерживает выборочные изменения, а смена импортёра заменяет набор настроек.
У собственных ресурсов Reckfell — например, .rscene, .rprefab и .rdata — другой путь: это уже сериализованные данные движка, а не исходник для импортёра glTF или текстур. Не ищите для них те же параметры преобразования.
Загружайте ресурс по исходному пути
Для обработанного ресурса используйте ResourceLoader и исходный путь, например asset://Models/model.glb. Движок читает .import и находит соответствующий результат в .reckfell/imported/. Не вписывайте сгенерированное имя .rbin в игровой код: это деталь кэша.
FileAccess нужен для чтения байтов и ваших файлов данных. Он не заменяет импортёр и не гарантирует, что исходное изображение или модель останутся обычным файлом после экспорта игры. Если хотите разобрать внешний glTF во время игры через GltfDocument, это другой путь загрузки.
Импорт без окна редактора
Для автоматической обработки проекта на Windows можно вызвать установленный редактор из PowerShell. Подставьте существующие пути к своему runtime и проекту:
& "C:\Reckfell\Runtime\1.0.0\Reckfell Engine.console.exe" --headless --path "C:\Projects\MyGame" --editor --importКоманда запускает редактор, ждёт обработки ресурсов и завершает его. После неё проверьте код завершения и сообщения импорта. Наличие .import само по себе не доказывает успех: затем загрузите ресурс и проверьте его содержимое. Именно этот путь использован в проверке руководства; работа кнопок мышью и вид окна отдельно не принимались.
Найдите источник проблемы
| Признак | Действие |
|---|---|
| после смены параметра ничего не изменилось | примените Reimport и убедитесь, что изменяли нужный исходник |
| настройки теряются у коллеги | проверьте, передан ли соответствующий .import вместе с исходником |
| ресурс ссылается на отсутствующие файлы | восстановите полный комплект зависимостей, сохранив относительные пути |
| материал снова стал исходным | проверьте режим извлечения и внешнюю ссылку: сохранение материалов |
| в редакторе доступен файл, в сборке нет | разделите обработанный ресурс и исходные байты; проверьте правила включения ресурсов в экспорт |
| на другой машине виден устаревший результат | проверьте исходник и .import, затем выполните импорт локально; не используйте чужой кэш вместо исходных данных |
Проверены реальный импорт и повторный импорт GLB, .import, кэш .rbin и загрузка PackedEntity по исходному пути. Экспорт приложения и восстановление произвольного повреждённого кэша этой проверкой не подтверждены.