Менеджер проектов: создание, импорт и восстановление
Стартовый префаб, импорт существующего проекта, удаление записи, Git-метаданные и Recovery Mode.
Менеджер проектов создаёт проекты, добавляет существующие в список и открывает их в редакторе. Запуск самого исполняемого файла без выбранного проекта обычно приводит в этот экран. Из командной строки его можно вызвать параметром --project-manager.
Создать проект
- Нажмите Create и задайте имя.
- Выберите отдельный каталог проекта. Create Folder создаёт вложенный каталог с именем проекта; проверьте итоговый путь перед подтверждением.
- Выберите доступный рендерер под целевое устройство. Если сомневаетесь, начните с первого проекта, где описаны установка и запуск.
- Выберите, нужны ли служебные файлы Git, затем подтвердите создание.
- Дождитесь открытия редактора и завершения начального импорта. Ошибки создания каталога или файлов нужно исправить до продолжения.
В текущем коде создание проекта записывает project.reckfell, icon.svg и стартовый Main.rprefab с корнем Entity3D по имени Main. В application/run/main_scene назначается asset://Main.rprefab. Это исходная заготовка, а не готовая игровая сцена с камерой, освещением и логикой.
Не создавайте новый проект поверх каталога с важными файлами. Если Main.rprefab уже существует, текущий диалог отказывается создавать стартовый префаб и предлагает пустой каталог. Это не универсальная защита любых файлов от перезаписи при всех действиях менеджера.
Что означает выбор Git
Опция Git создаёт .gitignore и .gitattributes. Для генерации этих файлов Git-плагин не нужен. Она не выполняет git init, не создаёт коммит и не подключает удалённый репозиторий. Интеграция управления версиями внутри редактора — отдельная задача.
Добавить существующий проект
Нажмите Import и выберите project.reckfell либо каталог, в котором он находится. Это добавляет ссылку на существующий проект; файлы проекта не копируются автоматически в новую папку.
Для ZIP выберите архив и отдельный каталог распаковки. Архив должен содержать project.reckfell. Дождитесь окончания извлечения и прочитайте сообщение, если часть файлов не удалось записать. Убедитесь, что открываете корень проекта, а не каталог на уровень выше.
После переноса каталога на другой диск старая запись может указывать на отсутствующий путь. Импортируйте project.reckfell из нового расположения и уберите ненужную старую запись. Не создавайте второй пустой проект вместо импорта существующего.
Scan ищет проекты в выбранном каталоге. Для одного проекта точнее использовать Import с конкретным файлом. Скачанный пример добавляется тем же способом; отдельная работающая онлайн-библиотека для локального импорта не нужна.
Открыть в редакторе или запустить игру
| Действие | Результат |
|---|---|
| Open in Editor | Открывает проект для редактирования. Двойной щелчок по записи также используется для открытия. |
| Run Project | Запускает назначенный стартовый уровень без обычного сеанса редактирования. |
| Open in Editor (Verbose Mode) | Открывает редактор с подробным журналом для диагностики. |
| Open in Editor (Recovery Mode) | Открывает ограниченный режим восстановления; запуск игры в нём отключён. |
Если Run Project не запускает нужную игру, проверьте application/run/main_scene и наличие указанного файла. Само присутствие записи в списке не доказывает исправность проекта и сборки C#. Если менеджер сообщает Assets need to be imported first, сначала откройте проект в редакторе и дождитесь начального импорта.
Формат проекта
Текущий проект использует целочисленное project_schema=1 в секции [reckfell]. При одиночном открытии менеджер проверяет схему и версию формата конфигурации. config_version — номер формата файла, а не версия движка 1.0.0.
При сообщении Unsupported project или о несовместимой конфигурации не меняйте номера вручную: это не преобразует содержимое. Проверьте, что выбрана сборка, поддерживающая именно этот проект, и сохраните исходную копию. Для неподдерживаемой схемы текущий диалог не предлагает автоматическое преобразование.
Убрать запись из списка
Remove from Project List удаляет запись менеджера, а не каталог проекта. Файлы можно снова добавить через Import. В текущем обработчике удаления вызов удаления содержимого отключён.
Перед действием проверьте путь выбранной записи. Удаление каталога через файловый менеджер — другая операция; менеджер проектов не восстанавливает удалённые таким способом файлы.
Поиск, избранное и теги
Отметьте часто используемый проект как избранный, чтобы быстрее находить его. В Manage Tags назначьте теги по назначению проекта, например prototype или tools. Фильтр поддерживает запрос tag:prototype; несколько тегов можно указать через пробел.
Теги записываются в application/config/tags проекта, поэтому переносите project.reckfell вместе с остальными файлами. Запись в локальном списке менеджера и данные самого проекта — разные сущности.
Если проект падает при открытии
Сначала сохраните копию проекта. В контекстном меню выберите Open in Editor (Recovery Mode). Режим временно отключает tool-скрипты, плагины редактора, нативные расширения и автоматическое восстановление открытых уровней. Игра в нём не запускается.
Используйте его для поиска проблемного плагина, скрипта или ресурса, а не как обычный режим разработки. Он не гарантирует исправление повреждённого файла и не заменяет резервную копию. После исправления причины закройте редактор и откройте проект обычным способом.
Для диагностики также пригодятся решение проблем и сборка C#.
Настройки самого менеджера
Через Settings доступны язык, масштаб, тема и сетевой режим. Эти параметры относятся к инструменту, а не к игровому окну проекта. Подробные текущие ключи масштаба и темы приведены в настройке интерфейса.
Online/Offline управляет доступностью сетевых функций. Включение Online само по себе не подтверждает наличие работающего каталога шаблонов, обновления или нужного экспортного комплекта. Локальные проекты можно создавать и импортировать без скачивания шаблона из магазина.
Формат стартового префаба и отдельный запуск изолированного проекта проверены текущим Runtime; инструкции диалога, импорта, удаления записи и Recovery Mode сверены с исходниками. Физические действия в менеджере, ZIP-распаковка, удаление записи и Recovery Mode здесь не выполнялись.