CommunityImagegithub.com

mobile-game-asset

Construisez des modèles 3D prêts pour le jeu pour les jeux Unity mobiles, avec un style stylisé et un niveau de détail type Valorant, en pilotant Blender via Blender MCP, à partir d'une description textuelle ou d'une image de référence.

Qu'est-ce que mobile-game-asset ?

Cette compétence vous permet de créer des assets 3D optimisés pour les jeux mobiles Unity, en adoptant un style stylisé rappelant le niveau de détail de Valorant. Elle couvre les personnages, créatures, kits d'environnement, accessoires, armes et véhicules, chacun avec son propre pipeline de studio (blockout → topologie → UV → bake → texture stylisée → LODs → rig → FBX → import Unity URP). La compétence utilise Blender MCP pour piloter Blender à partir de descriptions textuelles ou d'images de référence. Elle propose trois niveaux de qualité (Faible/Moyen/Élevé) et garantit que chaque polygone, îlot UV et canal de texture a une fonction précise, éliminant tout élément superflu. Les utilisateurs peuvent déclencher cette compétence en mentionnant la modélisation 3D, Blender MCP, les maillages prêts pour le jeu, les modèles mobiles low-poly, les assets Unity ou un style « Valorant », même sans utiliser le terme « game-ready ». La compétence fournit un pipeline structuré en étapes, avec des fichiers de référence pour chaque catégorie, et privilégie l'efficacité en adaptant la charge de travail à la complexité de l'asset, évitant les scripts superflus et les étapes de bake inutiles pour les assets simples.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/earl-gh/mobile-game-asset/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Asset de Jeu Mobile (Blender MCP → Unity)

Vous pilotez Blender via Blender MCP pour créer un asset prêt à être expédié. La cible est un look stylisé, au niveau de détail de Valorant : formes grandes et lisibles, chanfreins nets, albédo peint, sans bruit. Il est exporté vers Unity 6+ avec URP sur mobile et s'adapte aux réglages Faible/Moyen/Élevé du jeu.

Travaillez comme un artiste lead avec un budget serré. Chaque polygone, îlot UV et canal de texture a une fonction. Tout ce qui n'en a pas est supprimé.

0. Itinéraire

  1. Choisissez la catégorie, puis lisez son fichier. La catégorie détermine les budgets, la topologie, le rig et les règles d'exportation :
CatégorieFichier
Personnage (humanoïde, jouable ou PNJ)references/character.md
Créature (non-humanoïde, animal, monstre)references/creature.md
Environnement (kit modulaire, structures, éléments de terrain)references/environment.md
Accessoire (objets statiques ou à mouvement simple)references/prop.md
Arme & équipement (tenu, porté, déployable)references/weapon.md
Véhicule (roues, chenilles, hover, volant)references/vehicle.md

Choisissez selon le rôle dans le gameplay, pas selon l'apparence : la même forme est un accessoire si c'est un élément de décor, une arme ou un équipement si le joueur la tient ou la porte, et un véhicule si le joueur la conduit.

  1. Lisez references/unity.md avant l'étape d'exportation. Il couvre la correspondance des niveaux de qualité et les paramètres d'importation.

Adapter la charge de travail (principe de la queue de cheval)

Les étapes de la section 2 sont un plafond, pas un quota. Les tests ont passé environ 1 100 lignes de script sur une boîte de 200 triangles, et c'est un échec : cela enterre la seule décision qui compte. Adaptez le pipeline à l'asset :

  • Une étape dont la vérification de sortie est déjà satisfaite est sautée ou fusionnée avec sa voisine, et la mention « Ignoré » du brief le précise. Les fusions typiques pour les petits assets hard-surface : passe forme + maillage de jeu + normales en un seul script, et pas de bake du tout quand le détail est uniquement texturé (utilisez une feuille de trim, un atlas ou une bande de palette au lieu d'un bake unique). Les assets héroïques, organiques et vus de près ne sont jamais uniquement texturés : ils ont toujours le bake de détail, car le sauter les rend plats et comme des jouets.
  • Visez le moins de scripts possible tout en gardant chaque étape vérifiable. Partagez les helpers dans un seul module au lieu de les redériver à chaque étape.
  • Jamais ignoré : l'échelle et le pivot, les normales et la vérification des UV, scripts/validate.py, l'exportation.
  • Les chiffres dans les fichiers de catégorie (tris, densité texel, os, lots) sont des budgets de départ, pas des spécifications. Ajustez-les en fonction des appareils profilés du projet et notez ce que vous avez changé, mais ne coupez jamais le LOD0 pour les téléphones bas de gamme : les niveaux de qualité (LOD1/LOD2, limite de mip) les servent, et le LOD0 sert le réglage Élevé. Choisissez d'abord la taille de texture et laissez la surface unique de l'asset décider du px/m, en le gardant cohérent sur tout l'asset. La cohérence est plus importante que d'atteindre un chiffre prescrit.

1. Réception → Brief d'Asset

Partez de l'une ou l'autre entrée. La sortie est la même : un court Brief d'Asset. Affichez-le avant de construire.

À partir du texte : extrayez le rôle (qui le voit, à quelle distance, à quelle fréquence), la taille en mètres, les mots-clés de silhouette, une liste de matériaux, une palette de 3 à 5 couleurs avec une accentuation, et l'Inventaire des Pièces. Comblez les lacunes avec des hypothèses adaptées au genre et énoncez-les. Ne demandez que lorsque la catégorie ou le rôle dans le gameplay est ambigu, car cela change tout en aval.

À partir d'une image : lisez-la dans cet ordre :

  1. Proportions. Mesurez en unités que l'image vous donne (l'élément le plus fiable, répété ou de taille connue dans l'image : têtes, roues, mains, portes). Notez les ratios.
  2. Hiérarchie des formes. Formes primaires (la silhouette), formes secondaires (panneaux, plaques d'armure, grands plis), formes tertiaires (boulons, coutures, piqûres). Le détail tertiaire va dans la texture, pas dans la géométrie.
  3. Zones de matériaux. Chaque zone reçoit un hexadécimal de couleur de base, une bande de rugosité (mat/satin/brillant) et un métal oui/non.
  4. Cachées. Indiquez ce que vous supposez du dos et du dessous.
  5. Pièces. Lisez l'image pour l'Inventaire des Pièces : ce qui semble articulé, coulissant, flexible, lumineux ou attachable.
  6. Dans Blender, chargez l'image comme une référence vide (empty_display_type='IMAGE') alignée sur la vue ortho correspondante. Comparez les captures d'écran de la vue avec elle à la fin de chaque étape.

Modèle de Brief d'Asset (gardez-le aussi court) :

Asset : <PREFIXE>_<Nom>   Catégorie : <cat>   Rôle/caméra : <p. ex. 1P héroïque, 3P à 5–30 m>
Taille : <boîte englobante en m>   Pivot : <où et pourquoi>
Budget (tris)  LOD0 <n> | LOD1 <n> | LOD2 <n>      Texture : <résolution> × <jeux>   Matériaux : <n>
Densité texel : <px/m>   Os : <n ou aucun>
Formes : primaire <...> / secondaire <...> / tertiaire→texture <...>
Pièces : <l'Inventaire des Pièces ci-dessous>
Palette : <liste hex, accentuation marquée>   Hypothèses : <liste>

Inventaire des Pièces. Tout ce qui est spécifique à l'objet vient d'ici. Les fichiers de catégorie donnent des règles, jamais des listes de pièces, alors dérivez les pièces de cette description ou image et de rien d'autre. Listez chaque pièce qui nécessite l'un de ces éléments :

  • Bouge (charnières, glissières, rotations, oscillations) : l'axe, la position du pivot et la plage.
  • Se déforme (se plie, s'étire, oscille) : sa chaîne d'os ou sa région de déformation.
  • S'attache (quelque chose est tenu par elle, monté sur elle, ou en émane) : la position et l'orientation de la prise.
  • Change d'apparence (émissive, recolorable, interchangeable par dégâts) : la zone de matériau.
  • Ouvre ou cache la géométrie (cavités et intérieurs vus seulement en utilisation) : ce qui est visible quand.

Les pièces qui n'ont besoin d'aucun de ces éléments sont des maillages simples. Les pivots, os, prises et hiérarchies que vous construisez dans les étapes suivantes proviennent directement de cette liste, nommés <fonction>_<position> en mots simples qui correspondent au brief.

2. Pipeline

Chaque fichier de catégorie ajoute ses propres étapes et remplacements. Le squelette ci-dessous est le même pour chaque catégorie.

#ÉtapeVérification de sortie (à vérifier avant de passer à la suivante)
1Blockout. Formes primaires uniquement, à l'échelle réelle (1 BU = 1 m), avec le pivot placé.La silhouette se lit à la distance de la caméra du jeu dans une capture d'écran. La taille correspond au brief.
2Passe forme. Formes secondaires, puis chanfreins.Chaque arête que vous pouvez voir a une largeur de biseau intentionnelle. Pas de bruit.
3Maillage de jeu. Le low poly final : quads plus triangles intentionnels, boucles de support uniquement là où elles servent la silhouette ou la déformation.Nombre de tris dans le budget LOD0. Zéro n-gons et géométrie non-manifold.
4Normales. Marquez les arêtes vives aux angles durs, ajoutez un modificateur Weighted Normal (Keep Sharp), et divisez les UV à chaque arête vive.Pas de gradients de lissage sur les faces planes dans une capture d'écran matcap.
5UV. Coutures sur les arêtes vives et les bordures cachées, dépliez, redressez les coques rectilignes, gardez la densité texel cohérente, emballez (voir ci-dessous).Densité texel dans ±10% de la cible. 8 px de marge à 2048, 4 px à 1024.
6Bake. Dupliquez le maillage de jeu comme source de bake et ajoutez le détail qui manque au maillage de jeu (biseaux, découpes ; Subdivision uniquement pour les formes organiques), puis utilisez le mode « Selected to Active » de Cycles avec une cage. Bakez la normale et l'AO, plus un masque de bord (voir la recette de texture).Pas de rayons manqués ou d'obliquité dans la capture d'écran.
7Texture. Une surface en couches pilotée par les maps bake (references/surface.md) ; la recette ci-dessous n'est que le sol. Emballez la texture de masque.Se lit à 25% d'échelle, tient sur un carton gris, et montre une variation tonale à la distance du jeu.
8LODs. Créez-les en supprimant des boucles et en effondrant les détails cachés. Chaque LOD conserve la silhouette et les coutures UV.Chaque LOD dans le budget. Pas de ruptures UV. Les pops visibles de LOD sont petits.
9Rig / prises (si nécessaire).Squelette de déformation uniquement, ≤ 4 poids par sommet, normalisés.
10Exportation. Exécutez scripts/export_unity.py.scripts/validate.py réussit.

Assets organiques : construisez haut, puis retopologie (personnages, créatures, tout ce qui est charnu)

Les studios ne modélisent pas directement le maillage de jeu pour les formes organiques, et vous ne devriez pas non plus. Les résultats précédents « enfantins » viennent d'avoir sauté cette étape :

  1. Source haute précision d'abord. Volumes de base lisses : un modificateur Skin sur le squelette de proportions avec des rayons gradués (lourd à l'épaule et à la hanche, s'amincissant aux extrémités), Subdivision 2, ombre lisse. Modélisez la tête comme son propre volume (crâne, museau ou visage, mâchoire, sourcils et oreilles ou équivalents demandés par le brief), pas comme un tube effilé. Fusionnez les volumes (modificateur Remesh, mode voxel), puis ajoutez le détail à trois échelles de references/surface.md. Les tubes à rayon constant le long de splines avec un ombrage plat sont le principal signe de jouet : ne les utilisez pas pour les corps.
  2. Retopologie vers le maillage de jeu. Utilisez bpy.ops.object.quadriflow_remesh (sous un temp_override pour une vue 3D) pour atteindre l'objectif de faces LOD0, ou recourez au modificateur Remesh suivi d'un Decimate planaire. Puis corrigez les boucles aux articulations et à la tête avec des modifications écrites à la main. La source haute précision reste la source de bake.
  3. Ombrage lisse avec la carte de normales bake pour les assets organiques ; l'ombrage plat ou dur est réservé aux parties hard-surface.
  4. LOD0 n'est pas réduit pour le matériel faible. « Fonctionne sur les téléphones bas de gamme » est satisfait par le système de niveaux (LOD1 et LOD2, limite de mip de texture, poids de peau), jamais en réduisant LOD0 en dessous du budget de la catégorie. Un passage précédent a réduit LOD0 à un tiers du budget et avait l'air jouet à cause de cela.
  5. Passe beauté avant la remise. Rendez les vues héroïques avec le vrai matériau dans Cycles (le CPU est suffisant) ou EEVEE, car Workbench cache les cartes de normales et le brillant, puis vérifiez les signes de jouet : membres de largeur constante, tête en tube sans mâchoire ni sourcils, couleur plate ou uniforme, facettes dures sur la peau organique, pièces qui flottent ou ne se connectent pas. Corrigez et re-rendez au moins trois fois, en consacrant l'effort à la tête et aux extrémités.

Ce que « pas générique » signifie ici

Les outils par défaut produisent des résultats amateurs lorsque vous les utilisez tels quels. Utilisez plutôt la version studio :

  • UVs. Pas Smart UV Project. Marquez les coutures sur les arêtes vives et les bordures cachées, dépliez avec Angle Based, exécutez Follow Active Quads sur les bandes rectilignes, puis emballez avec bpy.ops.uv.pack_islands(shape_method='CONCAVE', rotate=True, margin_method='FRACTION', margin=padding_px/texture_px). Donnez plus de densité texel aux faces visibles héroïques uniquement si le brief le dit. Miroir ou chevauchement des coques uniquement pour les parties symétriques et jamais sur les surfaces de tuilage, et décalez la copie chevauchante de +1 U pendant le bake.
  • Réduction. Pas un Decimate aveugle. Supprimez des boucles entières, fusionnez les faces cachées et dissolvez les faces planes (limit=1°). Utilisez Decimate (collapse) uniquement sur les parties organiques, avec use_symmetry et les coutures UV protégées par un poids de groupe de sommets.
  • Biseaux. Pas un modificateur Bevel avec les réglages par défaut. Utilisez une largeur définie par classe de taille (par exemple 1 cm sur les armes, 2–4 cm sur les accessoires, 5–10 cm sur l'architecture), harden_normals=True, limit_method='WEIGHT' piloté par bevel_weight_edge, et 1–2 segments sur le maillage de jeu.
  • Ombrage. Pas Auto Smooth. Marquez délibérément les arêtes vives, ajoutez un modificateur Weighted Normal (Keep Sharp, Face Influence), et appliquez-le avant l'exportation.
  • Subdivision. Jamais sur le maillage de jeu. Sur une source de bake, utilisez-la uniquement pour les formes organiques : elle arrondit les faces planes hard-surface, donc les sources de bake hard-surface reçoivent des biseaux avec des boucles de support à la place.
  • Texturing. Pas un Principled BSDF standard avec un sélecteur de couleur. Construisez la pile de nœuds stylisés procéduraux et bakez-la dans les jeux de texture (étape 7).

Recette de texture stylisée (étape 7)

C'est le sol, pas la finition. Les zones plates, un gradient et un AO doux seuls se lisent comme un jouet, donc pour tout asset organique, héroïque ou vu de près, superposez references/surface.md par-dessus. Construisez la base comme un seul matériau dans Blender, puis bakez-la en images :

  1. Couleurs de zone. Couleur de base plate par zone de matériau. Pilotez les zones avec la couleur de sommet ou une carte d'ID bake. Gardez les valeurs dans la gamme moyenne, sans noir ou blanc pur.
  2. Gradient. Z dans l'espace objet, multiplié : environ 0,85 en bas jusqu'à 1,05 en haut. Cela donne une sensation de « lumière peinte d'en haut ».
  3. AO. L'AO bake, multiplié à 30–50% de force. C'est suffisant pour ancrer les formes sans les rendre sales.
  4. Rehaut de bord. Blender n'a pas de bake de courbure, donc fabriquez le masque de bord convexe de l'une des deux manières : un bake Emission de Geometry → Pointiness sur la source de bake (nécessite une densité de géométrie suffisante le long des biseaux), ou déduisez-le de la carte de normales bake. Passez le masque dans un ColorRamp à 0,55–0,6 et utilisez-le pour éclaircir l'albédo de 10–20%. Cela donne le look net de chanfrein peint.
  5. Rugosité. En larges bandes par zone (mat 0,8, satin 0,5, brillant 0,25), avec les bords légèrement plus brillants.
  6. Bakez en albédo (bake Emission de la pile de couleurs, pour que l'éclairage ne s'infiltre pas), normale (tangente, OpenGL Y+ correspond à Unity), et la texture de masque.
  7. Emballez avec scripts/pack_mask.py : R = métallique, G = AO, A = lissage. C'est une texture assignée aux deux emplacements URP Lit Metallic et Occlusion, ce qui économise une récupération de texture et un peu de mémoire.

3. Piloter Blender MCP

  • Une étape par appel de code. Nommez les objets, matériaux et images de manière déterministe, et rendez chaque appel idempotent : supprimez ou remplacez ce qui existe déjà, ne le dupliquez pas. Imprimez les statistiques à la fin de chaque appel (tris, objets, matériaux, îlots UV) pour pouvoir vérifier sans deviner.
  • Regardez après chaque étape. Prenez une capture d'écran de la vue (une matcap pour les étapes de forme, un aperçu matériau pour les textures) et comparez-la au brief ou à la référence. Corrigez le problème avant de passer à la suite, car les erreurs s'accumulent en aval.
  • Préférez bmesh et l'API de données à bpy.ops. Les opérateurs échouent sans le bon contexte via MCP. Quand vous en avez besoin, enveloppez-le dans with bpy.context.temp_override(...).
  • Protégez le travail. Après chaque étape, sauvegardez une nouvelle version : bpy.ops.wm.save_as_mainfile(filepath=".../<Asset>_v###.blend", copy=True). Ne remplacez jamais le fichier ouvert de l'utilisateur sans demander.
  • Exécutez les scripts fournis en lisant le fichier et en envoyant son contenu à l'outil d'exécution de code, avec les paramètres définis en haut.
  • Pas de Blender MCP connecté ? Écrivez le brief dans <Asset>_brief.md et un script par étape (<Asset>_stage01_blockout.py et ainsi de suite) pour que l'utilisateur...

…[tronqué pour la traduction]

Skills associés