Файлы проекта — документация

Назначение файлов, asset://, user:// и резервная копия.

Где живёт ваша игра

Проект — отдельная папка, в корне которой находится project.reckfell. Сам движок устанавливается отдельно. Так можно обновить редактор, не смешивая его файлы с ресурсами вашей игры.

Для небольшого проекта достаточно такой организации. Названия папок — рекомендация, а не обязательный стандарт движка:

FirstGame/
├── project.reckfell
├── FirstGame.csproj
├── FirstGame.slnx
├── Scenes/
│   └── World.rscene
├── Props/
│   └── Crate.rprefab
├── Scripts/
│   └── Player.cs
└── Assets/
    ├── Textures/
    └── Audio/

Что означают файлы

Файл	Назначение
`project.reckfell`	Настройки приложения, ввода, рендеринга и проекта
`.rscene`	Сохранённое дерево с ролью сцены
`.rprefab`	Сохранённое дерево с ролью префаба
`.rdata`	Отдельный текстовый ресурс, например материал
`.rbin`	Бинарный ресурс
`.cs`	Исходный код C#
`.csproj`	Настройки сборки C# и версия SDK проекта
`.sln`	Решение для инструментов разработки
`.uid`, `.import`	Сопутствующая информация об идентичности и импорте исходных файлов

Расширение помогает понять назначение, но не заменяет правильное содержимое. Нельзя получить рабочий префаб, просто переименовав случайный текстовый файл.

asset:// и user://

asset:// — путь от корня проекта. Например, asset://Props/Crate.rprefab означает Props/Crate.rprefab рядом с project.reckfell. Он не зависит от того, в какой папке диска находится весь проект.

user:// — папка пользовательских данных приложения. Она нужна для сохранений, настроек игрока и других изменяемых файлов. После экспорта папка установки игры может быть недоступна для записи, поэтому не сохраняйте прогресс в asset://.

Это пути к файлам. Путь Player/Camera3D в GetEntity относится к объектам внутри дерева и решает другую задачу.

Что сохранить в резервной копии

Сохраняйте исходные сцены, префабы, код, изображения, звуки, настройки проекта, сопутствующие .uid и .import, а также нужные конфигурации зависимостей и экспорта. После копирования откройте резервный проект и проверьте его запуск.

.reckfell содержит создаваемые редактором данные и кэш импорта. Их обычно не включают в систему контроля версий: редактор пересоздаёт их. Каталоги сборки C# bin и obj тоже обычно генерируются. Если вы пока не уверены, сделайте полную резервную копию закрытого проекта, а исключения настройте позже. Не удаляйте незнакомые папки в рабочем проекте ради очистки.

Система контроля версий хранит историю изменений, но не заменяет отдельную резервную копию. Не включайте в публичное хранилище личные ключи провайдеров или другие секреты.

Как безопасно переместить проект

Закройте редактор и скопируйте всю папку проекта, а не один World.rscene. Откройте project.reckfell из нового места через менеджер проектов, дождитесь импорта и соберите C#. Пути asset:// продолжат работать внутри перенесённой папки; абсолютные пути на вашем компьютере могут потребовать исправления.

Для перемещения отдельных ресурсов внутри проекта пользуйтесь Assets. Строки путей в C# после этого проверяйте отдельно.