Plugin de Unreal Engine

Instalación

El plugin uVersion se distribuye como binario precompilado, gestionado por el cliente desktop. Sin compilación de tu parte, sin archivos fuente que manipular.

Versiones de Unreal admitidas: 5.6 y superiores.

Procedimiento

1. Instala el cliente desktop de uVersion
2. Añade al cliente el workspace que contiene tu proyecto de Unreal
3. El panel de Unreal detecta automáticamente tu .uproject
4. El cliente instala el plugin correspondiente a tu versión de Unreal y a tu plataforma
5. Abre el proyecto en Unreal, el plugin queda activo de inmediato

Actualizaciones

El cliente desktop comprueba si hay versiones nuevas al abrir el proyecto y cada 6 horas. Cuando hay una versión más reciente disponible para tu Unreal, aparece una insignia « Update ready » en el panel de Unreal del cliente. Cierra el editor de Unreal y luego haz clic en ella para aplicar la actualización (el plugin no puede reemplazarse mientras está cargado).

Primera conexión

En el editor de Unreal: Tools → Source Control → Connect to Source Control, elige uVersion en el desplegable Provider.

Tus credenciales se recuperan automáticamente desde el cliente desktop. No tienes nada que volver a escribir. Si por algún motivo el cliente desktop no está instalado, el editor muestra un formulario para introducir la dirección del servidor y tus credenciales.

Qué hace el plugin en Unreal

Source Control nativo

Checkout, checkin, revert, history: todo está accesible desde el clic derecho en el Content Browser, igual que con cualquier otro Source Control Provider de Unreal. Los artistas no tienen nada nuevo que aprender.

Bloqueo automático al editar

Cuando modificas un asset, el plugin coloca automáticamente un lock en el servidor, sin que tengas que hacer un checkout manual. Tú trabajas y el plugin gestiona el bloqueo en silencio.

Diff visual de Blueprint

Compara dos revisiones de un Blueprint directamente en Unreal, con la herramienta de diff visual estándar del editor. Funciona con cualquier commit del historial.

Validación previa al checkin

Antes de cada envío, el plugin ejecuta una serie de comprobaciones sobre los archivos modificados: compilación de Blueprints, convención de nombres, tamaño de las texturas, dependencias faltantes, dependencias circulares, etc. Los errores bloquean el checkin, las advertencias se muestran como avisos. Las reglas se pueden activar y configurar por proyecto desde el panel de Admin del cliente desktop.

Limpieza de redirectors

Cuando renombras o mueves un asset, Unreal crea redirectors que pueden acumularse. El plugin los detecta y los limpia automáticamente en el momento del checkin, actualizando las referencias en todos los assets afectados.

Reconciliación al arranque

Al abrir el proyecto, el plugin comprueba el estado de tus assets y sincroniza el estado con el servidor. Los archivos que estabas editando se vuelven a bloquear automáticamente, para evitar que un compañero se adjudique por error algo que tú habías empezado.

Solicitud de liberación de lock

Si quieres modificar un asset que un compañero ha bloqueado, el plugin te permite enviar una solicitud de liberación. Al compañero le llega una notificación en su cliente desktop.

Problemas frecuentes

« Failed to connect to source control »

Comprueba que estás correctamente conectado en el cliente desktop. Es él quien guarda tus credenciales.

El plugin no se actualiza

Cierra primero el editor de Unreal: el plugin no puede reemplazarse mientras está cargado. Luego haz clic en la insignia de estado del plugin en el panel de Unreal del cliente desktop para volver a ejecutar la comprobación y aplicar la actualización.