Plugin Unreal Engine

Installation

Le plugin uVersion est distribué en binaire précompilé, géré par le client desktop. Pas de compilation à votre charge, pas de fichiers source à manipuler.

Versions Unreal supportées : 5.6 et supérieur.

Procédure

1. Installez le client desktop uVersion
2. Ajoutez votre workspace contenant le projet Unreal au client
3. Le panneau Unreal détecte automatiquement votre .uproject
4. Le client installe le plugin correspondant à votre version d'Unreal et à votre plateforme
5. Ouvrez le projet dans Unreal, le plugin est actif immédiatement

Mises à jour

Le client desktop vérifie les nouvelles versions à l'ouverture du projet et toutes les 6 heures. Quand une version plus récente est disponible pour votre Unreal, une pastille « Update ready » apparaît dans le panneau Unreal du client. Fermez l'éditeur Unreal, puis cliquez dessus pour appliquer la mise à jour (le plugin ne peut pas être remplacé tant qu'il est chargé).

Première connexion

Dans l'éditeur Unreal : Tools → Source Control → Connect to Source Control, choisissez uVersion dans la dropdown Provider.

Vos identifiants sont récupérés automatiquement depuis le client desktop. Vous n'avez rien à retaper. Si pour une raison ou une autre le client desktop n'est pas installé, l'éditeur affiche un formulaire pour saisir l'adresse du serveur et vos identifiants.

Ce que le plugin fait dans Unreal

Source Control natif

Checkout, checkin, revert, history : tout est accessible depuis le clic droit dans le Content Browser, comme avec n'importe quel autre Source Control Provider Unreal. Les artistes n'ont rien de nouveau à apprendre.

Verrouillage automatique à l'édition

Quand vous modifiez un asset, le plugin pose automatiquement un lock côté serveur, sans que vous ayez à faire un checkout manuel. Vous travaillez, le plugin gère le verrouillage en silence.

Diff Blueprint visuel

Comparez deux révisions d'un Blueprint directement dans Unreal, avec l'outil de diff visuel standard de l'éditeur. Fonctionne sur n'importe quel commit de l'historique.

Validation pré-checkin

Avant chaque envoi, le plugin lance une série de vérifications sur les fichiers modifiés : compilation des Blueprints, convention de nommage, taille des textures, dépendances manquantes, dépendances circulaires, etc. Les erreurs bloquent le checkin, les warnings s'affichent en avertissement. Les règles sont activables et configurables par projet depuis le panneau Admin du client desktop.

Nettoyage des redirectors

Quand vous renommez ou déplacez un asset, Unreal crée des redirectors qui peuvent s'accumuler. Le plugin les détecte et les nettoie automatiquement au moment du checkin, avec mise à jour des références dans tous les assets concernés.

Réconciliation au démarrage

À l'ouverture du projet, le plugin vérifie l'état de vos assets et synchronise le statut avec le serveur. Les fichiers que vous étiez en train de modifier sont automatiquement re-locked, pour éviter qu'un coéquipier ne s'attribue par erreur quelque chose que vous aviez commencé.

Demande de libération de lock

Si vous voulez modifier un asset qu'un coéquipier a verrouillé, le plugin vous permet d'envoyer une demande de libération. Une notification arrive chez le coéquipier dans son client desktop.

Problèmes courants

« Failed to connect to source control »

Vérifiez que vous êtes bien connecté dans le client desktop. C'est lui qui détient vos identifiants.

Le plugin ne se met pas à jour

Fermez d'abord l'éditeur Unreal : le plugin ne peut pas être remplacé tant qu'il est chargé. Puis cliquez sur la pastille de statut du plugin dans le panneau Unreal du client desktop pour relancer la vérification et appliquer la mise à jour.