Plugin do Unreal Engine

Instalação

O plugin uVersion é distribuído como binário pré-compilado, gerenciado pelo cliente desktop. Nada de compilar por sua conta, nada de arquivos de código para manipular.

Versões do Unreal suportadas: 5.6 e superiores.

Procedimento

1. Instale o cliente desktop do uVersion
2. Adicione ao cliente o workspace que contém seu projeto do Unreal
3. O painel do Unreal detecta automaticamente seu .uproject
4. O cliente instala o plugin correspondente à sua versão do Unreal e à sua plataforma
5. Abra o projeto no Unreal, o plugin fica ativo imediatamente

Atualizações

O cliente desktop verifica novas versões ao abrir o projeto e a cada 6 horas. Quando há uma versão mais recente disponível para o seu Unreal, um selo « Update ready » aparece no painel do Unreal do cliente. Feche o editor do Unreal e clique nele para aplicar a atualização (o plugin não pode ser substituído enquanto está carregado).

Primeira conexão

No editor do Unreal: Tools → Source Control → Connect to Source Control, escolha uVersion no menu suspenso Provider.

Suas credenciais são recuperadas automaticamente do cliente desktop. Você não precisa digitar nada de novo. Se por algum motivo o cliente desktop não estiver instalado, o editor exibe um formulário para inserir o endereço do servidor e suas credenciais.

O que o plugin faz no Unreal

Source Control nativo

Checkout, checkin, revert, history: tudo fica acessível pelo clique com o botão direito no Content Browser, exatamente como em qualquer outro Source Control Provider do Unreal. Os artistas não têm nada de novo para aprender.

Bloqueio automático ao editar

Quando você modifica um asset, o plugin aplica automaticamente um lock no servidor, sem que você precise fazer um checkout manual. Você trabalha e o plugin cuida do bloqueio em silêncio.

Diff visual de Blueprint

Compare duas revisões de um Blueprint diretamente no Unreal, com a ferramenta de diff visual padrão do editor. Funciona em qualquer commit do histórico.

Validação antes do checkin

Antes de cada envio, o plugin executa uma série de verificações nos arquivos modificados: compilação de Blueprints, convenção de nomenclatura, tamanho das texturas, dependências ausentes, dependências circulares etc. Os erros bloqueiam o checkin, os warnings aparecem como avisos. As regras podem ser ativadas e configuradas por projeto a partir do painel Admin do cliente desktop.

Limpeza de redirectors

Quando você renomeia ou move um asset, o Unreal cria redirectors que podem se acumular. O plugin os detecta e os limpa automaticamente no momento do checkin, atualizando as referências em todos os assets afetados.

Reconciliação na inicialização

Ao abrir o projeto, o plugin verifica o estado dos seus assets e sincroniza o status com o servidor. Os arquivos que você estava editando são bloqueados novamente de forma automática, para evitar que um colega assuma por engano algo que você havia começado.

Pedido de liberação de lock

Se você quiser modificar um asset que um colega bloqueou, o plugin permite enviar um pedido de liberação. Uma notificação chega ao colega no cliente desktop dele.

Problemas comuns

« Failed to connect to source control »

Verifique se você está corretamente conectado no cliente desktop. É ele que guarda suas credenciais.

O plugin não atualiza

Feche primeiro o editor do Unreal: o plugin não pode ser substituído enquanto está carregado. Em seguida, clique no selo de status do plugin no painel do Unreal do cliente desktop para executar a verificação novamente e aplicar a atualização.