Плагин для Unreal Engine

Установка

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

Поддерживаемые версии Unreal: 5.6 и выше.

Порядок действий

1. Установите desktop-клиент uVersion
2. Добавьте в клиент workspace с вашим проектом Unreal
3. Панель Unreal автоматически обнаруживает ваш .uproject
4. Клиент устанавливает плагин, соответствующий вашей версии Unreal и вашей платформе
5. Откройте проект в Unreal, плагин активен сразу же

Обновления

Desktop-клиент проверяет наличие новых версий при открытии проекта и каждые 6 часов. Когда для вашего Unreal доступна более новая версия, в панели Unreal клиента появляется значок « Update ready ». Закройте редактор Unreal, затем нажмите на него, чтобы применить обновление (плагин нельзя заменить, пока он загружен).

Первое подключение

В редакторе Unreal: Tools → Source Control → Connect to Source Control, выберите uVersion в выпадающем списке Provider.

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

Что плагин делает в Unreal

Нативный Source Control

Checkout, checkin, revert, history: всё доступно из меню правой кнопки мыши в Content Browser, точно так же, как с любым другим Source Control Provider для Unreal. Художникам не нужно учить ничего нового.

Автоматическая блокировка при редактировании

Когда вы изменяете asset, плагин автоматически ставит блокировку на стороне сервера, без необходимости выполнять checkout вручную. Вы работаете, а плагин управляет блокировкой незаметно.

Визуальный diff Blueprint

Сравнивайте две ревизии Blueprint прямо в Unreal с помощью стандартного визуального инструмента diff редактора. Работает с любым коммитом в истории.

Проверка перед checkin

Перед каждой отправкой плагин выполняет серию проверок изменённых файлов: компиляция Blueprint, соглашение об именовании, размер текстур, отсутствующие зависимости, циклические зависимости и другое. Ошибки блокируют checkin, предупреждения отображаются как уведомления. Правила можно включать и настраивать для каждого проекта из панели Admin desktop-клиента.

Очистка redirector

Когда вы переименовываете или перемещаете asset, Unreal создаёт redirector, которые могут накапливаться. Плагин обнаруживает и очищает их автоматически во время checkin, обновляя ссылки во всех затронутых assets.

Согласование при запуске

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

Запрос на снятие блокировки

Если вы хотите изменить asset, который заблокировал товарищ по команде, плагин позволяет отправить запрос на снятие блокировки. Уведомление приходит товарищу в его desktop-клиент.

Частые проблемы

« Failed to connect to source control »

Убедитесь, что вы правильно вошли в desktop-клиент. Именно он хранит ваши учётные данные.

Плагин не обновляется

Сначала закройте редактор Unreal: плагин нельзя заменить, пока он загружен. Затем нажмите на значок статуса плагина в панели Unreal desktop-клиента, чтобы заново выполнить проверку и применить обновление.