Библиотека и коллекции

Вкладка "Библиотека", коллекции переиспользуемых ресурсов, откуда они берутся и как попадают в уровень и обратно

Что такое коллекция

Коллекция - это папка переиспользуемых ресурсов. В ней могут быть ресурсы семи видов:

Коллекция не привязана к уровню. Она лежит на вашем устройстве и доступна в любом уровне, который вы открываете

Уровень никогда не ссылается на коллекцию. Импорт всегда копирует внутрь уровня, поэтому уровень остаётся самодостаточной папкой, которая играется где угодно

Источники

Библиотека показывает ресурсы из трёх источников. Каждый - это фильтр-чип над списком:

Коллекцию только для чтения меняют так: копируют её записи в свою коллекцию

Вкладка "Библиотека"

Библиотека - вкладка на домашнем экране редактора, сразу после Создать уровень

Узкий столбец кнопок выбирает вид:

• Коллекции
• Префабы, Темы, Фигуры, Эффекты
• Текстуры, Шрифты, Аудио

Список - справа от этого столбца

Коллекции

• Новая коллекция создаёт пустую коллекцию
• Импорт архива добавляет коллекцию из файла .zip, .tar.gz или .tar. Если эта коллекция уже есть на устройстве, игра спросит, заменить ли её
• Обновить заново читает папку

У каждой строки есть Открыть. У ваших собственных коллекций есть и Удалить. Кнопка сначала спрашивает, а потом удаляет коллекцию вместе со всеми её файлами

Страница коллекции

Поля: Название, Описание, Авторы (через запятую) и Лицензия (Не указана или одна из типовых лицензий)

Ниже - содержимое, у каждой записи есть Убрать

Коллекция только для чтения пишет Только чтение. Чтобы изменить записи, скопируйте их в свою коллекцию

В сборке для Steam на странице вашей собственной коллекции есть ещё раздел публикации. Подробнее - Публикация

Префабы, темы, фигуры, эффекты

Каждая из этих страниц показывает все записи из всех источников. Чипы сужают список

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

У записей, которые можно менять, есть Удалить, и она сначала спрашивает

Текстуры, шрифты, аудио

Эти страницы показывают файлы всех коллекций. Личной библиотеки для файлов нет, поэтому эти виды живут только в коллекциях. У строк есть Копировать и Убрать

Что копия берёт с собой

Копия берёт всё, что нужно записи: фигуры, текстуры, шрифты и вложенные префабы префаба, фигуру частиц эффекта. Сведения об авторстве этих ресурсов тоже переходят вместе с ними

Вкладка "Коллекции"

Коллекции - вкладка настроек уровня, сразу после Префабы. Сверху два режима: Импорт и Собрать коллекцию

Импорт

1. Вкладка показывает список коллекций. Нажмите Открыть у нужной
2. Отметьте нужные записи. Все и Ничего отмечают всё или снимают все отметки
3. Строка Выбрано: N, добавится зависимостей: M показывает, что придёт в уровень. Зависимости добавляются сами
4. Нажмите Импортировать

Весь импорт - один шаг отмены

Текстуры, шрифты и аудио всегда получают в уровне новые id. Их файлы копируются в папку уровня под уникальным именем

Собрать коллекцию

1. Куда выбирает Новая коллекция или одну из ваших. Новая берёт название из поля Название
2. Отметьте ресурсы уровня, любого из семи видов
3. Нажмите Собрать

Новая коллекция получает авторов уровня

Из защищённого уровня нельзя собрать коллекцию. Подробнее - Экспорт и защита

Выбор ресурса и поиск

У поиска и у окон выбора ресурса есть уровень Библиотека для префабов, тем, фигур и эффектов. Он показывает все источники. Окна выбора - это поля фигуры, коллайдера, эффекта и темы и Разместить префаб…

Выбор записи из библиотеки импортирует её в уровень вместе с зависимостями и назначает. При конфликте задаётся тот же вопрос, что и на вкладке "Коллекции"

Браузеры библиотеки внутри вкладок ресурсов уровня работают так же и показывают чипы источников. Подробнее - Ресурсы уровня

Конфликты

Импортируемая запись может уже быть в уровне с тем же id:

• содержимое то же - делать ничего не нужно
• содержимое другое - открывается окно Уже есть в уровне

Окно перечисляет все конфликты, у каждого переключатель Импортировать копией:

Оставить все и Копировать все ставят все переключатели разом. Импортировать применяет выбор, Отмена ничего не импортирует

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

Авторство

Записи о ресурсах уровня охватывают темы, эффекты, фигуры и префабы наравне с текстурами, шрифтами и аудио. Импорт копирует нужные записи в уровень, поэтому авторство приходит вместе с ресурсом

Подробнее - Карточка ресурса

На диске

Коллекции лежат в resources/collections/<collection-guid>/ в папке данных игры. Это та же папка resources рядом с levels, где лежит библиотека устройства. Подробнее - Папка уровня и бэкапы

Коллекция передаётся архивом: Экспорт .zip или Экспорт .tar.gz на её странице, Импорт архива в списке. Архив, который не является коллекцией, отклоняется

Дальше: Публикация, Переиспользование: префабы, копирование, генераторы, Карточка ресурса