Importer un GLB dans Unity : pourquoi ce n'est pas pris en charge par défaut et comment installer glTFast

Par défaut, Unity ne sait pas importer les fichiers GLB (glTF). Les formats de modèles 3D que le manuel officiel d'Unity présente comme pris en charge nativement sont .fbx, .dae (Collada), .dxf et .obj ; glTF et GLB ne figurent pas dans cette liste (source : Unity Manual - Model file formats, en juillet 2026). Pour travailler avec du GLB, vous ajoutez via le Package Manager Unity glTFast (com.unity.cloud.gltfast), un package fourni officiellement par Unity. Une fois celui-ci installé, il suffit de copier un GLB dans le dossier Assets pour qu'il soit importé comme n'importe quel autre format 3D.

Cet article se concentre uniquement sur la procédure technique qui permet à Unity de lire un GLB. Pour une vue d'ensemble, de la conversion d'une illustration en modèle 3D jusqu'à la réalité du rigging et de l'animation, consultez Transformer l'illustration d'un personnage 2D en 3D dans Unity : conversion, import et conditions pour l'animer. Si vous souhaitez comprendre l'ensemble du flux de travail, commencez par cet article.

Remarque : Figmee est actuellement un service qui permet de générer et de télécharger des images façon figurine et des données de modèle 3D (GLB / 3MF) à partir des dessins et illustrations que vous importez. La vente d'objets physiques imprimés en 3D est en préparation (Coming Soon).

Pourquoi Unity ne lit pas le GLB par défaut

Unity est conçu pour utiliser le FBX comme voie d'importation interne, et le manuel officiel recommande lui-même d'utiliser .fbx autant que possible, comme bonne pratique. Le glTF 2.0, de son côté, est un format défini par le Khronos Group pour un affichage rapide à l'exécution, et il est largement utilisé sur le web et dans le rendu en temps réel. Comme les deux formats ne visent pas le même objectif, le glTF ne fait tout simplement pas partie du cœur d'Unity.

Nous détaillons les différences de nature entre ces formats dans OBJ, FBX, STL, GLB : quelles différences ? Guide pour choisir son format de fichier 3D. Si vos données sont déjà au format GLB, le plus simple est de les charger directement avec glTFast, sans passer par une conversion.

Installer Unity glTFast (environ 3 minutes)

Unity glTFast est un package officiel fourni par Unity, conçu en privilégiant la vitesse, l'efficacité mémoire et une faible empreinte dans les builds. Il prend en charge la spécification glTF 2.0 et de nombreuses extensions, et fonctionne sur toutes les plateformes ainsi qu'avec les pipelines de rendu Built-in, Universal (URP) et High Definition (HDRP) (source : Unity glTFast Documentation, en juillet 2026, version 6.17.0).

Voici la procédure d'installation décrite dans la documentation officielle (source : Unity glTFast - Installation, en juillet 2026).

1. Ouvrez votre projet Unity et sélectionnez Window > Package Manager (20 secondes).
2. Cliquez sur le bouton d'ajout (+) dans la barre d'état (10 secondes).
3. Choisissez Add + package by name dans le menu (10 secondes).
4. Saisissez com.unity.cloud.gltfast dans le champ Name (20 secondes). Attention aux fautes de frappe. C'est cet identifiant qui correspond au package officiel, et non le nom hérité de l'ancien dépôt personnel.
5. Cliquez sur Add (1 minute). La dernière version est récupérée automatiquement. Selon votre connexion, cela peut prendre quelques minutes.

Modules optionnels à ajouter selon vos besoins

glTFast couvre davantage de cas lorsqu'il est combiné aux packages intégrés d'Unity et à des packages supplémentaires. La documentation officielle cite les suivants :

• Image Conversion : prise en charge des textures JPEG / PNG
• Unity Web Request Texture : chargement d'images via une URI
• Animation : lecture des animations
• Physics : génération de colliders
• Draco for Unity / KTX for Unity / meshoptimizer decompression for Unity : si vous utilisez les extensions glTF correspondantes (compression des maillages et des textures)

Inutile de tout installer dès le départ. Il suffit d'ajouter le module concerné lorsqu'un symptôme apparaît, par exemple des textures qui ne s'affichent pas ou un GLB compressé qui refuse de s'ouvrir.

Importer un GLB (environ 2 minutes)

Une fois l'installation terminée, le GLB se manipule exactement comme les autres formats 3D.

1. Déplacez ou copiez le fichier GLB dans le dossier Assets du projet (30 secondes). La documentation officielle explique que vous pouvez déplacer ou copier des fichiers glTF dans le dossier Assets de votre projet comme n'importe quel autre format 3D, et qu'Unity glTFast les importe sous forme de prefabs natifs Unity avant de les ajouter à la base de données d'assets (source : Unity glTFast - Editor Import, en juillet 2026).
2. Pour un fichier .gltf, copiez aussi les fichiers associés (30 secondes). La même documentation indique clairement qu'il ne faut pas oublier de copier les buffers associés (.bin) et les fichiers image, et que les noms de fichiers et les chemins relatifs ne doivent pas être modifiés, sous peine de casser les références. Un .glb tient en un seul fichier, ce problème ne se pose donc pas. C'est l'une des raisons pour lesquelles on choisit souvent le GLB pour transmettre des données.
3. Sélectionnez le fichier dans la vue Project et consultez l'Inspector (1 minute). Les paramètres d'importation, ainsi que les éventuels avertissements et erreurs, s'affichent ici. Lorsque le résultat ne correspond pas à ce que vous attendiez, c'est le premier endroit à regarder.
4. Dépliez le fichier dans la vue Project (30 secondes). Les éléments importés apparaissent sous la forme Scenes / Meshes / Materials / AnimationClips / Textures. Si vous voulez réutiliser un maillage ou un matériau précis sur un autre objet, c'est ici que vous le récupérez.
5. Faites-le glisser dans la scène pour le placer (10 secondes). L'opération est la même que pour un prefab classique.

À propos de l'association des extensions

Une fois installé, glTFast s'enregistre comme importeur par défaut des fichiers .gltf et .glb. Autrement dit, après l'installation, ces extensions sont automatiquement lues par glTFast, sans aucune manipulation particulière.

Si vous utilisez déjà un autre importeur glTF et que les deux entrent en conflit, vous pouvez désactiver l'enregistrement de glTFast comme importeur par défaut en ajoutant GLTFAST_FORCE_DEFAULT_IMPORTER_OFF aux symboles de script (scripting define symbols) du projet. Dans un projet qui combine plusieurs assets liés au glTF, si le résultat de l'import n'est pas celui attendu, demandez-vous d'abord quel importeur est réellement à l'œuvre.

Comprendre les sous-assets générés

Les cinq types d'éléments qui apparaissent lorsque vous dépliez un GLB dans la vue Project jouent chacun un rôle différent. Les connaître vous permet de réagir rapidement plus tard, lorsqu'il faudra réutiliser une seule partie ou remplacer uniquement les matériaux.

Si AnimationClips est vide, ce n'est pas un échec de l'import : cela signifie que le GLB d'origine ne contient tout simplement pas d'animation. Un modèle 3D généré à partir d'un seul dessin est un maillage statique, c'est pourquoi cette entrée est généralement vide.

Les matériaux listés dans Materials suivent la spécification de base de glTF. Un matériau glTF se compose de canaux comme la couleur de base, le métallique, la rugosité, l'occlusion ambiante, la normal map et l'émissif ; côté Unity, ces canaux sont attribués aux shaders du projet. Lorsque le rendu vous paraît plus métallique que prévu ou bien trop brillant, ce sont généralement le métallique et la rugosité qu'il faut ajuster.

Connaître aussi les autres options

glTFast n'est pas le seul moyen de manipuler du glTF dans Unity. UnityGLTF, publié par le Khronos Group (en juillet 2026), est un chargeur et exportateur glTF 2.0 d'exécution pour Unity, lui aussi proposé en open source. C'est une option sérieuse si vous accordez de l'importance aux fonctions d'export ou si un projet existant l'utilise déjà.

Il ne s'agit pas de savoir lequel est le meilleur : en pratique, on choisit selon les exigences du projet (extensions à prendre en charge, besoin d'export ou non, ressources existantes). Pour un nouveau projet qui n'a besoin que d'importer, glTFast est le plus simple à mettre en place, puisqu'il s'installe depuis le Package Manager en tant que package officiel d'Unity.

Trois points à vérifier après l'import

Ce n'est pas parce qu'un modèle se charge qu'il est prêt à l'emploi tel quel.

1. Matériaux et pipeline de rendu

C'est l'écueil le plus fréquent. glTFast prend en charge Built-in, URP et HDRP, mais si le pipeline du projet et les shaders des matériaux ne concordent pas, le modèle s'affiche entièrement blanc, entièrement noir ou en magenta (rose). Le magenta est l'affichage par défaut d'Unity lorsqu'il ne trouve pas un shader : si vous voyez cette couleur, soupçonnez d'abord une incompatibilité de pipeline. Vérifiez aussi qu'une lumière est bien placée dans la scène.

2. Échelle et origine

Il arrive qu'un personnage paraisse gigantesque ou minuscule au moment où vous le placez. Cela se produit lorsque les données d'origine n'ont pas été créées en tenant compte des dimensions réelles, et ce n'est pas une erreur. Ajustez la valeur Scale du Transform, ou déterminez la taille relativement au sol ou à des objets existants. Vérifier l'origine dès cette étape (aux pieds ou au centre du corps) facilitera aussi le placement par la suite.

3. Nombre de faces et charge d'affichage

Les modèles générés par IA et les modèles très détaillés peuvent compter beaucoup de faces au regard des standards du temps réel. Plus il y a de faces, plus la charge de rendu et de traitement augmente, et l'impact est d'autant plus fort que vous ciblez le mobile (Qu'est-ce que le nombre de polygones ? Que se passe-t-il quand il est élevé, repères par usage et méthode de comptage). Prenez comme référence le nombre de personnages affichés simultanément et, si nécessaire, réduisez les faces dans un outil comme Blender avant de réimporter.

Tableau de dépannage

Questions fréquentes

Unity propose-t-il nativement l'import glTF / GLB ?

Non. Les formats que le manuel officiel d'Unity présente comme pris en charge nativement sont .fbx, .dae, .dxf et .obj. Pour travailler avec du GLB, ajoutez depuis le Package Manager le package officiel d'Unity glTFast (com.unity.cloud.gltfast). Une fois ajouté, il s'enregistre comme importeur par défaut de ces extensions : vous pouvez ensuite manipuler vos GLB comme n'importe quel asset ordinaire.

Vaut-il mieux convertir en FBX avant l'import, ou importer le GLB tel quel ?

Si vous avez déjà un GLB, le charger avec glTFast sans conversion vous épargne des étapes et limite le risque de perdre des couleurs ou des textures en route. En revanche, si toute votre équipe a standardisé ses échanges sur le FBX, ou si vous échangez des données contenant des animations, il est tout à fait raisonnable de privilégier le FBX. Nous présentons la nature de ce format dans Qu'est-ce qu'un fichier GLB ? Ouverture, usages et conversion expliqués simplement.

Peut-on aussi charger un GLB à l'exécution (en jeu) ?

Oui. glTFast prend en charge non seulement l'import dans l'éditeur, mais aussi le chargement à l'exécution. Cela permet par exemple d'afficher dans votre application des modèles apportés par les utilisateurs. Vous devrez toutefois développer vous-même le chargement asynchrone et la gestion des erreurs : la démarche la plus sûre consiste donc à vérifier d'abord l'affichage avec un import dans l'éditeur, puis à passer à la prise en charge à l'exécution.

En résumé

La procédure pour utiliser un GLB dans Unity se résume en trois étapes : (1) ajouter le package officiel com.unity.cloud.gltfast via le Package Manager, (2) copier le GLB dans Assets, (3) vérifier les avertissements dans l'Inspector et placer le modèle dans la scène. Si Unity ne lit pas le GLB nativement, c'est par conception : une fois un seul package installé, tout le reste relève du travail habituel.

Si vous rencontrez un problème, il vient presque toujours de l'accord entre matériaux et pipeline de rendu. Du magenta oriente vers les shaders, du noir intégral vers l'éclairage, des textures manquantes vers les fichiers associés d'un .gltf : en procédant ainsi, la plupart des problèmes se règlent rapidement. Si vous comptez aller jusqu'à animer le modèle importé, il vous faudra en plus des os et un rig ; consultez donc l'ensemble du processus dans Transformer l'illustration d'un personnage 2D en 3D dans Unity : conversion, import et conditions pour l'animer.

Guides associés

• Importer un GLB dans Godot : aucun plugin nécessaire, il suffit de déposer le fichier