Файлы .unitypackage используются для переноса ассетов, скриптов, материалов, текстур, моделей и других ресурсов между проектами Unity. В таком формате часто распространяются готовые ассеты и наборы ресурсов.
В этой инструкции разберём, как импортировать .unitypackage в Unity, какие файлы выбирать при импорте и что делать, если пакет не устанавливается.
Что такое файл .unitypackage
.unitypackage — это архив Unity, содержащий файлы проекта вместе с информацией об их расположении и некоторыми дополнительными данными.
Внутри пакета могут находиться:
- 3D-модели и анимации;
- текстуры и материалы;
- C#-скрипты;
- префабы;
- сцены;
- шейдеры;
- аудиофайлы;
- демо-сцены и документация.
После импорта содержимое пакета обычно появляется в папке Assets вашего проекта.
Шаг 1. Откройте проект в Unity
Запустите Unity Hub и откройте проект, в который хотите установить ассет.
Перед импортом крупных пакетов рекомендуется сохранить проект и, если он важен, сделать резервную копию или commit в системе контроля версий.
Это особенно полезно, если пакет содержит собственные скрипты, настройки, шейдеры или файлы, которые могут конфликтовать с уже установленными ассетами.
Шаг 2. Запустите импорт .unitypackage
В верхнем меню Unity выберите:
Assets → Import Package → Custom Package...
После этого откроется окно выбора файла.
Шаг 3. Выберите файл .unitypackage
Найдите скачанный файл с расширением .unitypackage, выберите его и нажмите Open / Открыть.
Unity начнёт анализировать содержимое пакета. В зависимости от его размера это может занять некоторое время.
Шаг 4. Выберите файлы для импорта
После обработки пакета Unity покажет окно Import Unity Package со списком файлов.
Если вы хотите установить ассет полностью, обычно можно оставить выбранными все элементы.
Если вам нужна только часть ассета, снимите галочки с ненужных файлов.
Однако делать это следует осторожно. Например, префаб может зависеть от материалов, текстур, скриптов или других ресурсов из пакета. Если не импортировать необходимые зависимости, ассет может работать неправильно.
Шаг 5. Нажмите Import
Проверьте список файлов и нажмите кнопку Import.
Unity добавит выбранные ресурсы в проект. Если пакет большой или содержит много текстур, моделей и шейдеров, импорт может занять некоторое время.
Не закрывайте Unity до завершения операции.
Шаг 6. Найдите импортированный ассет
После завершения импорта откройте окно Project.
Файлы из .unitypackage появятся внутри папки Assets. Точное расположение зависит от структуры самого пакета.
Например:
Assets/НазваниеАссета/
Внутри могут находиться папки Prefabs, Scripts, Materials, Textures, Scenes, Demo и другие.
Альтернативный способ импорта .unitypackage
Есть и более быстрый вариант.
В некоторых версиях и конфигурациях Unity файл .unitypackage можно открыть непосредственно из файловой системы, после чего Unity предложит импортировать его в открытый проект.
Также пакет можно перетащить в окно Unity, если этот способ поддерживается вашей версией редактора.
Тем не менее способ через:
Assets → Import Package → Custom Package...
остаётся наиболее понятным и предсказуемым вариантом, особенно для новичков.
Что делать после импорта ассета
Установка .unitypackage не всегда означает, что ассет сразу готов к использованию.
После импорта рекомендуется посмотреть его документацию. Также проверьте папки с названиями Documentation, Readme, Demo, Example или Scenes.
Если в комплекте есть демонстрационная сцена, откройте её — это один из самых быстрых способов понять, как автор предполагает использовать ассет.
Некоторым пакетам также могут потребоваться дополнительные зависимости или определённый render pipeline: Built-in Render Pipeline, URP или HDRP.
Почему .unitypackage не импортируется
Иногда при установке пакета возникают ошибки. Рассмотрим наиболее распространённые причины.
Пакет создан для другой версии Unity
Ассет мог быть разработан для более новой или старой версии редактора.
Проверьте требования ассета и сравните их с версией Unity вашего проекта.
Небольшая разница в версиях не обязательно приводит к проблемам, но совместимость не гарантируется.
После импорта появились ошибки в Console
Откройте:
Window → General → Console
и посмотрите сообщения об ошибках.
Частые причины:
- отсутствуют необходимые зависимости;
- пакет использует устаревший API;
- возник конфликт с другим ассетом;
- используется несовместимая версия Unity;
- проект использует другой render pipeline;
- в проекте уже существуют скрипты или плагины с конфликтующими классами.
В проекте уже есть файлы с такими именами
При импорте внимательно проверяйте список файлов, особенно если пакет устанавливает ресурсы в общие папки проекта.
Перед установкой большого или незнакомого пакета лучше сделать резервную копию проекта.
Можно ли удалить импортированный .unitypackage?
Сам исходный файл .unitypackage после успешного импорта проекту обычно не нужен.
Unity извлекает его содержимое в папку Assets, поэтому скачанный .unitypackage можно переместить или удалить.
Но это не удалит уже импортированные файлы из проекта.
Чтобы удалить сам ассет из Unity, необходимо удалить его файлы и папки из Assets. Перед этим убедитесь, что другие части проекта от них не зависят.
Чем .unitypackage отличается от пакетов Package Manager
Не стоит путать обычный файл .unitypackage с пакетами, устанавливаемыми через Unity Package Manager.
.unitypackage обычно импортирует файлы непосредственно в Assets.
Package Manager используется для пакетов, подключаемых к проекту через систему пакетов Unity. Управлять ими можно через:
Window → Package Manager
Поэтому инструкция по установке .unitypackage и установка пакета через Package Manager — это разные процессы.
Краткая инструкция
Чтобы импортировать .unitypackage в Unity:
- Откройте нужный проект.
- Выберите Assets → Import Package → Custom Package...
- Укажите файл
.unitypackage. - Дождитесь появления окна Import Unity Package.
- Выберите необходимые файлы.
- Нажмите Import.
- Найдите импортированные ресурсы в папке Assets.
После установки проверьте документацию ассета и убедитесь, что он совместим с вашей версией Unity и используемым render pipeline.
Частые вопросы
Куда устанавливается .unitypackage?
В большинстве случаев содержимое .unitypackage импортируется в папку Assets проекта с сохранением структуры папок, которая была задана при создании пакета.
Нужно ли распаковывать .unitypackage перед установкой?
Нет. Вручную распаковывать файл не требуется. Unity самостоятельно прочитает пакет и предложит выбрать содержимое для импорта.
Можно ли импортировать .unitypackage в уже существующий проект?
Да. Но перед импортом большого стороннего пакета рекомендуется сохранить резервную копию проекта или создать commit.
Почему после импорта ассет не работает?
Проверьте Console, версию Unity, необходимые зависимости и совместимость ассета с вашим render pipeline. Также изучите документацию самого ассета.
Можно ли установить только часть .unitypackage?
Да. В окне Import Unity Package можно снять галочки с ненужных файлов. Но будьте внимательны: некоторые файлы могут быть зависимостями других компонентов ассета.
