Использование библиотеки ресурсов

На сайте

Обзор

Как уже говорилось, вы можете получить доступ к веб-фронтенду библиотеки активов на официальном сайте Godot. Вот как он выглядит при первом посещении:

В верхней части вы видите заголовок, который ведёт вас к различным другим частям библиотеки AssetLib - в данный момент он пуст, так как мы не вошли в систему.

Поиск

В левой боковой панели находится панели поиска + настройки и раздел ассеты занимает основную область содержимого справа. Под панелью поиска вы можете фильтровать ассеты по категории (например 2D инструменты, скрипты и демо проекты), уровень поддержки, версия движка и лицензия. Вы так же можете изменить порядок сортировки, чтобы сортировать по лицензии имени или дате обновления.

Хотя большинство других настроек фильтров должны быть достаточно понятными, стоит пояснить, что значит "уровень поддержки" в Библиотеке ресурсов. В данный момент существует три уровня поддержки и каждый ассет может принадлежать только к одному.

Featured (Рекомендованные) специально отобранные ассеты, ценность которых признана сообществом.

Ассеты Community предоставляются и поддерживаются членами сообщества Godot.

Ассеты Testing являются незавершенными работами и могут содержать ошибки и проблемы с удобством использования. Они не рекомендуются для использования в серьезных проектах, но вам можете скачать их, протестировать и отправить проблемы авторам.

Вы можете смешивать и сопоставлять любые фильтры и критерии поиска, и после нажатия кнопки "Поиск" получить список всех ассетов в библиотеке, которые соответствуют этим критериям.

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

Разбор ассета

Теперь давайте рассмотрим, как выглядит страница ассета и что она содержит.

1. Миниатюра/иконка ассета.

2. Имя ассета.

3. Номер текущей версии ассета.

4. Категория ассета, версия Godot и статус поддержки.

5. Автор/создатель ассета.

6. Лицензия распространения ассета.

7. Дата последнего редактирования/обновления ассета.

8. Текстовое описание ассета.

9. Ссылки, связанные с ассетом(ссылка на скачивание, список файлов, трекер ошибок).

10. Демонстрирующие ассет изображения и видео.

Регистрация и вход в систему

Для загрузки ресурсов в AssetLib необходимо войти в систему, а для этого нужна зарегистрированная учётная запись. В будущем это может также дать вам доступ к другим функциям, таким как комментирование или оценка существующих ресурсов. Для просмотра и загрузки ресурсов вход в систему не требуется.

Страница входа/регистрации может быть доступна из шапки AssetLib.

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

Затем вы можете использовать свое имя пользователя и пароль для входа в систему.

Это изменит внешний вид шапки AssetLib. Теперь вы получите доступ к нескольким новым функциям:

• Лента, которая показывает список обновлений статуса отправленных вами активов (и, возможно, больше в будущем).

• Список выгруженных вами ассетов.

• Возможность размещения новых ассетов.

О том, как отправлять ресурсы в библиотеку, а также каковы правила отправки ресурсов, вы можете узнать в следующей части этого руководства: Посылка в Библиотеку Ассетов.

В редакторе

Примечание

Редактор будет отображать различные категории активов в зависимости от того, просматриваете ли вы вкладку Asset Library Projects менеджера проектов или вкладку AssetLib редактора.

На вкладке Asset Library Projects в панели менеджера проектов отображаются только те ресурсы, которые являются самостоятельными проектами. В библиотеке ресурсов это обозначено категориями Templates (Шаблоны), Demos и Projects.

На вкладке редактора AssetLib будут отображаться только ресурсы, которые сами по себе не являются отдельными проектами. Другими словами, здесь будут отображаться ресурсы из всех категорий, кроме Templates, Demos и Projects.

Вы также можете получить доступ к AssetLib непосредственно из Godot:

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

Как и в веб-версии AssetLib, здесь вы можете искать ассеты по категориям, названиям, а также сортировать их по таким факторам, как название или дата редактирования.

Примечательно, что вы можете извлекать ресурсы только для текущей версии Godot, которую вы используете. Проекты, демо-версии и шаблоны можно загрузить из окна Менеджера проектов AssetLib. Аддоны (инструменты, скрипты, материалы и т.д.) можно загрузить из встроенного в проект AssetLib и добавить в текущий проект. Кроме того, в отличие от использования веб-интерфейса, результаты поиска обновляются в режиме реального времени (вам не нужно нажимать кнопку поиск после каждого изменения поискового запроса, чтобы изменения произошли).

В будущем вы сможете выбрать другого поставщика AssetLib для извлечения ресурсов (с помощью выпадающего меню «Сайт»), однако в настоящее время поддерживается только официальная версия AssetLib с Godot website, а также версия, которая может быть запущена на веб-сервере вашего локального компьютера (опция localhost).

Когда вы нажимаете на ассет, вы видите более подробную информацию о нем.

Если нажать кнопку "Установить", Godot скачает архив с ресурсом и отследит ход его загрузки в нижней части окна редактора. Если загрузка не удалась, вы можете повторить попытку, нажав кнопку "Повторить".

После завершения установки вы сможете приступить к установке, нажав кнопку "Установить". Откроется окно установщика пакетов.

Здесь вы можете увидеть список всех файлов, которые будут установлены. Вы можете отметить файлы, которые не хотите устанавливать, и Godot также сообщит вам о любых проблемах с файлами, которые он не может установить. Эти файлы будут показаны красным цветом, а при наведении на них курсора вы увидите сообщение о том, почему они не могут быть установлены.

После этого вы можете нажать кнопку Install, которая распакует все файлы в архиве и импортирует все содержащиеся в нем ассеты, такие как изображения или 3D-модели. После этого вы увидите сообщение о том, что установка пакета завершена.

Вы также можете использовать кнопку Импорта, чтобы импортировать архивы ресурсов, полученные в другом месте (например, загрузив их непосредственно из веб-интерфейса AssetLib), что проведет вас через ту же процедуру установки пакета, что и для ресурсов, загруженных непосредственно через Godot, которую мы только что рассмотрели.