Un .unitypackage est une archive compressée qui range chaque asset dans un dossier nommé par un identifiant, accompagné de son chemin d'origine et de ses métadonnées Unity. Pour en voir le contenu, la voie officielle consiste à l'importer dans un projet Unity. Mais si vous voulez seulement savoir ce que contient un pack, quels modèles il propose et à quoi ils ressemblent texturés, il existe un chemin beaucoup plus direct.
Vous avez sans doute déjà vécu la scène : un pack acheté sur l'Unity Asset Store, un kit gratuit téléchargé pour un prototype, et l'envie de vérifier en deux minutes s'il colle au style de votre jeu. Ouvrir Unity, créer un projet de test, importer, attendre, puis nettoyer : c'est beaucoup pour un simple coup d'œil.
La documentation d'Unity définit les asset packages comme des ensembles de fichiers et de données issus de projets Unity, compressés et stockés dans un seul fichier à l'extension .unitypackage. C'est l'un des formats de distribution acceptés par l'Unity Asset Store. En plus des fichiers eux-mêmes, un package transporte des métadonnées : réglages d'import et liens vers d'autres assets.
Unity ne publie pas de spécification formelle de ce format, mais sa structure est bien connue. Il s'agit d'une archive tar compressée en gzip. À l'intérieur, chaque asset occupe son propre dossier, nommé par une suite de 32 caractères hexadécimaux, le GUID de l'asset. Ce dossier contient :
| Fichier | Rôle |
|---|---|
asset | Le contenu réel : le FBX, la texture PNG, le matériau, le prefab… |
asset.meta | Les métadonnées Unity de l'asset, dont son identifiant et ses réglages d'import |
pathname | Une ligne qui indique où l'asset doit atterrir, par exemple Assets/Props/Tonneau.fbx |
preview.png | Parfois, une vignette de l'asset |
Les dossiers du projet sont eux aussi présents sous forme d'entrées, mais sans fichier asset : ils ne portent que des métadonnées.
Le point important est le fichier .meta. Selon la documentation d'Unity, il contient l'identifiant unique de l'asset, qu'Unity utilise en interne pour y faire référence. Un matériau ne pointe donc pas vers « Tonneau_BaseColor.png », mais vers le GUID de cette texture. Si le .meta d'une texture disparaît, les matériaux qui l'utilisent perdent leur référence.
Décompresser l'archive ne suffit pas. Vous obtenez un dossier par asset, chacun nommé par un GUID illisible, et même en renommant chaque fichier asset d'après son pathname, il manque encore l'essentiel : l'assemblage.
Dans un pack Unity, l'objet que vous voulez voir est souvent un prefab. Unity le décrit comme un GameObject enregistré avec tous ses composants, leurs valeurs et ses GameObjects enfants, sous forme d'asset réutilisable. Les prefabs peuvent aussi s'imbriquer les uns dans les autres pour former des hiérarchies complexes. Une lanterne peut ainsi être composée d'un socle, d'un verre et d'une poignée, chacun placé à sa position, chacun avec son matériau.
La chaîne complète ressemble à ceci :
Lanterne.prefab → maillage (GUID du FBX + identifiant du sous-maillage)
→ matériau (GUID du .mat)
Lanterne.mat → textures (GUID de chaque image) + teinte
asset.meta → GUID ↔ chemin réel du fichierOuvrir le FBX seul dans un logiciel 3D peut donc donner un modèle gris ou mal texturé : dans un pack Unity, l'information « quelle texture va sur quel maillage » est portée par le prefab et le matériau, pas forcément par le FBX. C'est pour cela qu'on finit par importer le pack dans un projet. La documentation d'Unity décrit la marche à suivre : ouvrir un projet, passer par Assets > Import Asset Package, choisir les éléments dans la fenêtre d'import, puis Unity place le contenu dans le dossier Assets du projet.
Eyemesh lit le .unitypackage directement, sans Unity et sans projet. Deux façons de commencer :
.unitypackage apparaît alors dans la barre latérale. Sélectionnez-en un : Eyemesh affiche son nom, sa taille et un bouton « Ouvrir ». La décompression s'accompagne d'une barre de progression en pourcentage.Une fois ouvert, le package s'affiche en vue d'ensemble : tous ses modèles réunis dans une seule grille de vignettes, quelle que soit la profondeur de l'arborescence d'origine. La barre latérale reprend les dossiers reconstitués d'après les fichiers pathname, si vous préférez descendre dans Assets/Props/ ou Assets/Characters/. Un bouton vous ramène à la vue d'ensemble à tout moment.
Astuce pour vos achats de l'Unity Asset Store : la documentation d'Unity indique que, sur macOS, les packages téléchargés sont mis en cache dans ~/Library/Unity/Asset Store-5.x, avec un sous-dossier par vendeur. Eyemesh repère les packages jusque dans les sous-dossiers. Dans le Finder, Aller > Aller au dossier vous y mène, et il suffit de glisser ce dossier sur Eyemesh pour parcourir tous vos packs au même endroit.
L'extraction est conservée entre les sessions. Rouvrir un gros pack la deuxième fois est donc quasi immédiat. La taille de ce cache se règle dans les réglages (2 Go par défaut), les packages les moins récemment ouverts étant supprimés en premier, et un bouton « Vider le cache Unity » le remet à zéro. Un .unitypackage rangé à l'intérieur d'un autre s'ouvre de la même façon.
C'est ici que tout se joue. Eyemesh suit la même chaîne qu'Unity : prefab, puis matériau, puis texture, en résolvant chaque GUID grâce aux fichiers .meta lus pendant l'extraction.
_Color d'un matériau est appliquée à la texture de base, ce qui distingue par exemple une porte « marron » d'une porte « grise » construites sur la même image.Eyemesh fait aussi un peu de ménage pour vous. Les FBX bruts déjà utilisés par un prefab sont masqués de la grille, puisque le prefab en montre la version texturée. Les prefabs qui ne contiennent que des effets de particules, sans géométrie, sont écartés eux aussi. La grille montre donc ce qui compte : un asset, une vignette.
Avec le contenu sous les yeux, vous décidez en connaissance de cause. Quelques réflexes rapides :
Le pack retenu, vous l'importez dans Unity en sachant exactement ce que vous voulez en tirer, au lieu de remplir un projet de test. C'est d'ailleurs la logique de l'étape d'inventaire décrite dans notre guide pour organiser sa bibliothèque d'assets 3D de jeu vidéo : regarder avant de ranger, et avant d'importer.
Un prefab trouvé dans un package peut sortir de l'archive sous une forme autonome.
Pensez à noter la provenance du pack au moment où vous en tirez un modèle : la méthode est dans suivre les licences de vos assets. Tous les détails de la prise en charge sont sur la page packages Unity.
Vous pouvez le décompresser, puisque c'est une archive tar compressée en gzip. Vous obtiendrez un dossier par asset, nommé par son GUID, avec les fichiers asset, asset.meta et pathname. Il faut ensuite reconstruire l'arborescence d'après les pathname, et le plus important reste à faire : relier prefabs, matériaux et textures. C'est exactement ce travail qu'Eyemesh fait automatiquement.
Parce que l'association entre maillage et texture est décrite par les fichiers Unity du pack : le prefab désigne un matériau, le matériau désigne des textures, le tout par GUID. Le FBX seul ne porte pas forcément cette information. En ouvrant le prefab plutôt que le FBX, vous retrouvez le modèle tel que le vendeur l'a monté.
Selon la version de macOS, Aperçu et QuickLook affichent une partie des formats 3D (USDZ, OBJ, STL, glTF…) ; le FBX et le .unitypackage n'en font pas partie. Pour les autres formats 3D de votre bibliothèque, l'extension QuickLook d'Eyemesh ajoute l'aperçu à la barre d'espace dans le Finder.
Sur macOS, la documentation d'Unity indique le dossier ~/Library/Unity/Asset Store-5.x, avec un sous-dossier par vendeur. Ce cache concerne les asset packages au format .unitypackage. Ouvrez ce dossier dans Eyemesh pour voir tous vos achats en vignettes.
Non. Eyemesh extrait une copie dans son propre cache et lit cette copie. Le .unitypackage d'origine reste tel que vous l'avez téléchargé, prêt à être importé dans Unity.
Ouvrez votre premier .unitypackage dans Eyemesh et parcourez ses prefabs assemblés et texturés, sans Unity ni projet de test. Essai gratuit de 7 jours.
Télécharger sur le Mac App Store · Voir toutes les fonctionnalités