Comment migrer un projet Unreal de la 5.4 à la 5.8

Comment migrer un projet Unreal de la 5.4 à la 5.8

Pour migrer un projet Unreal de la 5.4 à la 5.8, copiez le projet, ouvrez la copie dans la 5.8, laissez-la recompiler, corrigez les avertissements liés aux plugins et aux dépréciations, puis testez. Comptez environ une journée pour un projet de taille moyenne. Les points à risque sont les plugins tiers et tout code C++ qui s’appuie sur des API dépréciées au fil de quatre versions : c’est là que passe l’essentiel du temps.

Cet article est un guide pratique pour passer d’UE 5.4 à 5.8. C’est une checklist que vous pouvez suivre sur un projet réel sans perdre un week-end en mauvaises surprises, et elle complète notre présentation des nouveautés d’Unreal Engine 5.8.

Avant de migrer : sauvegarder et créer une branche

Ne migrez jamais sur place. Si vous utilisez un gestionnaire de versions, créez une branche et migrez-y ; sinon, copiez d’abord tout le dossier du projet. Notez votre version actuelle du moteur et la version exacte de chaque plugin tiers, car la compatibilité des plugins est ce qui casse le plus souvent. Migrer une copie signifie qu’une migration ratée ne vous coûte que du temps, et vous pouvez comparer le comportement avec la version 5.4 intacte.

Comment ouvrir un projet 5.4 dans la 5.8

Installez Unreal Engine 5.8 depuis le launcher à côté de la 5.4, sans la remplacer. Faites un clic droit sur le .uproject, choisissez Switch Unreal Engine Version et sélectionnez 5.8, ou ouvrez d’abord la 5.8 puis choisissez le projet. L’éditeur proposera de recompiler ; acceptez. Un projet C++ devra être recompilé avec le nouveau moteur : assurez-vous donc que votre chaîne d’outils correspond à ce qu’attend la 5.8. La première ouverture est lente car les shaders et les données dérivées sont reconstruits ; c’est normal, il ne s’agit pas d’un blocage.

Corriger la compatibilité des plugins

Les plugins sont le point de blocage habituel. Les plugins du Marketplace peuvent nécessiter une version compatible avec la 5.8, que vous mettez à jour depuis le launcher ; certains ne sont peut-être pas encore à jour, et vous devez alors attendre, les remplacer ou les désactiver. Pour un plugin qui ne se charge pas, désactivez-le dans le .uproject et vérifiez que l’éditeur s’ouvre, puis réactivez-les un par un pour trouver le coupable. Les plugins du moteur qui étaient expérimentaux en 5.4 ont pu être déplacés ou renommés d’ici la 5.8 : consultez le navigateur de plugins plutôt que de supposer qu’ils ont disparu.

Corriger les dépréciations et les redirecteurs

Le code C++ qui utilisait des API dépréciées entre la 5.4 et la 5.8 générera des avertissements ou des erreurs de compilation ; traitez-les en vous appuyant sur l’API de la 5.8. Côté contenu, les assets renommés ou déplacés sont gérés par des redirecteurs, mais laisser traîner des redirecteurs ralentit les chargements et fragilise les références : lancez donc Fix Up Redirectors sur vos dossiers de contenu une fois le projet stabilisé. Ne supprimez pas d’assets pour faire taire un avertissement de référence tant que vous ne savez pas ce qui pointe vers eux.

Comment tester après la migration

Une compilation sans erreur ne signifie pas que le travail est terminé. Jouez les boucles de jeu principales, vérifiez que les Blueprints se comportent toujours correctement, repérez les changements d’éclairage ou de matériaux dus aux mises à jour de Lumen et de Substrate, et profilez un niveau représentatif pour détecter de nouvelles saccades. Comparez avec la copie 5.4 lorsque quelque chose semble anormal. Les surprises courantes sont un éclairage modifié, une fonctionnalité de plugin dont le comportement a changé et des ajustements d’entrées ou de physique. Corrigez, testez à nouveau, puis fusionnez la branche de migration.

La même tâche dans Ludus AI

Après la migration, la partie fastidieuse consiste à traquer ce qui a cassé dans tout le projet. Dans Ludus AI, qui fonctionne d’UE 5.4 à 5.8, vous pouvez saisir la consigne suivante :

The project just moved from 5.4 to 5.8. Find the Blueprints and C++
that reference deprecated or renamed APIs, and the broken references,
and list them by file.

Comme Ludus AI a synthétisé l’ensemble du projet toutes les 5 secondes, il suit les références à travers les Blueprints, les casts, les assets et le C++ et renvoie la liste de ce qu’il faut corriger, au lieu que vous ouvriez chaque fichier pour le découvrir. C’est toujours vous qui décidez comment corriger chaque point, et vous testez en mode jeu. Il raccourcit la passe « qu’est-ce qui a réellement cassé », qui représente l’essentiel du travail lors d’un saut de quatre versions.

FAQ

Combien de temps faut-il pour migrer de la 5.4 à la 5.8 ? Environ une journée pour un projet de taille moyenne, davantage si vous dépendez de plugins pas encore mis à jour ou de code C++ fortement déprécié. Migrez toujours une copie ou une branche.

Puis-je sauter des versions et passer directement de la 5.4 à la 5.8 ? Oui. Vous n’avez pas besoin de passer par la 5.5, la 5.6 et la 5.7. Attendez-vous simplement à quatre versions de dépréciations et de changements de plugins d’un coup, d’où l’importance des tests.

La migration va-t-elle casser mes Blueprints ? Généralement pas la logique elle-même, mais des assets renommés et des plugins dont le comportement a changé peuvent casser des références ou le rendu visuel. Les redirecteurs gèrent la plupart des renommages ; testez les boucles de jeu principales après la migration.

Ludus AI fonctionne-t-il à la fois sur la 5.4 et la 5.8 ? Oui. Ludus AI prend en charge UE 5.4 à 5.8 en septembre 2026 : il fonctionne avant et après la migration et peut vous aider à retracer ce qui a changé.

Conclusion

Migrer quatre versions d’un coup semble pire que ce n’est : copiez le projet, laissez la 5.8 recompiler, corrigez les plugins et les dépréciations, puis testez les boucles qui comptent. Le travail consiste à trouver ce qui a cassé, pas à effectuer la migration elle-même. Ludus AI, l’assistant d’IA le plus avancé pour Unreal Engine, fonctionne de la 5.4 à la 5.8 et peut retracer les références cassées à votre place, pour que la passe post-migration devienne une liste plutôt qu’une chasse.

Commencez à créer avec Ludus AI