Plugin Unreal Engine

Installazione

Il plugin uVersion è distribuito come binario precompilato, gestito dal client desktop. Nessuna compilazione a tuo carico, nessun file sorgente da manipolare.

Versioni di Unreal supportate: 5.6 e successive.

Procedura

1. Installa il client desktop di uVersion
2. Aggiungi al client il workspace che contiene il tuo progetto Unreal
3. Il pannello Unreal rileva automaticamente il tuo .uproject
4. Il client installa il plugin corrispondente alla tua versione di Unreal e alla tua piattaforma
5. Apri il progetto in Unreal, il plugin è attivo immediatamente

Aggiornamenti

Il client desktop controlla la presenza di nuove versioni all'apertura del progetto e ogni 6 ore. Quando è disponibile una versione più recente per il tuo Unreal, nel pannello Unreal del client compare un badge « Update ready ». Chiudi l'editor Unreal, poi cliccaci sopra per applicare l'aggiornamento (il plugin non può essere sostituito finché è caricato).

Prima connessione

Nell'editor Unreal: Tools → Source Control → Connect to Source Control, scegli uVersion nel menu a tendina Provider.

Le tue credenziali vengono recuperate automaticamente dal client desktop. Non devi reinserire nulla. Se per qualche motivo il client desktop non è installato, l'editor mostra un modulo per inserire l'indirizzo del server e le tue credenziali.

Cosa fa il plugin in Unreal

Source Control nativo

Checkout, checkin, revert, history: tutto è accessibile dal clic destro nel Content Browser, proprio come con qualsiasi altro Source Control Provider di Unreal. Gli artisti non hanno nulla di nuovo da imparare.

Blocco automatico durante la modifica

Quando modifichi un asset, il plugin applica automaticamente un lock lato server, senza che tu debba fare un checkout manuale. Tu lavori, il plugin gestisce il blocco in silenzio.

Diff visivo dei Blueprint

Confronta due revisioni di un Blueprint direttamente in Unreal, con lo strumento di diff visivo standard dell'editor. Funziona su qualsiasi commit della cronologia.

Validazione prima del checkin

Prima di ogni invio, il plugin esegue una serie di controlli sui file modificati: compilazione dei Blueprint, convenzione di denominazione, dimensione delle texture, dipendenze mancanti, dipendenze circolari, ecc. Gli errori bloccano il checkin, i warning vengono mostrati come avvisi. Le regole si possono attivare e configurare per progetto dal pannello Admin del client desktop.

Pulizia dei redirector

Quando rinomini o sposti un asset, Unreal crea redirector che possono accumularsi. Il plugin li rileva e li pulisce automaticamente al momento del checkin, aggiornando i riferimenti in tutti gli asset interessati.

Riconciliazione all'avvio

All'apertura del progetto, il plugin verifica lo stato dei tuoi asset e sincronizza lo stato con il server. I file che stavi modificando vengono automaticamente ri-bloccati, per evitare che un collega si attribuisca per errore qualcosa che avevi iniziato.

Richiesta di rilascio del lock

Se vuoi modificare un asset che un collega ha bloccato, il plugin ti permette di inviare una richiesta di rilascio. Una notifica arriva al collega nel suo client desktop.

Problemi comuni

« Failed to connect to source control »

Verifica di essere correttamente connesso nel client desktop. È lui a custodire le tue credenziali.

Il plugin non si aggiorna

Chiudi prima l'editor Unreal: il plugin non può essere sostituito finché è caricato. Poi clicca sul badge di stato del plugin nel pannello Unreal del client desktop per rieseguire il controllo e applicare l'aggiornamento.