Que fait Actifs 3D pour Jeu ?
Utilisez cette compétence lorsqu'un jeu 3D a besoin d'actifs GLB concrets et reconnaissables plutôt que de simples géométries primitives. La compétence prend en charge l'ensemble du workflow : choisir la route, générer un petit ensemble d'actifs ciblés, écrire/lire asset_manifest.json, et intégrer les GLB dans le jeu avec des replis.
Comportement requis
- Si le prompt du jeu contient des entités explicites ou implicites, telles qu'un joueur, personnage, ennemi, objet à collectionner, véhicule, arme, obstacle, boss, mascotte, accessoire clé ou objet d'environnement, la génération GLB est une étape requise lorsque l'outil est disponible.
- Générer seulement 1 à 3 actifs clés par défaut. Prioriser d'abord le joueur/personnage principal, puis l'ennemi critique, l'objet à collectionner, le véhicule, le danger ou l'accessoire clé. Ne pas générer de remplissage décoratif.
- Utiliser les géométries primitives Three.js uniquement comme espace réservé temporaire pendant que les actifs sont en attente et comme repli d'exécution si un GLB ne peut pas être chargé.
- Ne pas régénérer les actifs existants sauf si l'utilisateur le demande explicitement. Si
asset_manifest.jsoncontient déjà des actifs chargeables, le réutiliser. - Éviter les personnages protégés par le droit d'auteur, les noms de marque, les logos et les ressemblances avec des célébrités. Réécrire en designs originaux.
Choix de route
Utiliser tripo pour la route rapide : prompt textuel direct vers Tripo3D text-to-model. C'est le meilleur choix pour les accessoires génériques, les ennemis, les objets à collectionner, les véhicules, les obstacles et les itérations rapides.
Utiliser gemini_reference lorsque le contrôle visuel est important : Gemini crée d'abord une image de référence sur fond blanc pur, puis Tripo image-to-model crée le GLB. Privilégier cette route lorsque l'utilisateur mentionne Gemini, Nano Banana, T-pose, fond blanc, image de référence, image-to-model, fiche de personnage, cohérence de style, ou lorsque la silhouette d'un personnage clé doit être contrôlée.
Utiliser auto uniquement lorsque vous êtes à l'aise avec le serveur qui choisit à partir du prompt. En cas de doute, choisissez la route vous-même et passez-la explicitement.
Environnement
Le client de génération est fourni avec cette compétence dans scripts/game-assets-mcp.mjs (Node >= 20, zéro dépendance). Il communique avec l'API d'actifs distante par défaut à l'adresse http://54.81.110.182:3001.
GAME_ASSETS_API_URL— surcharge facultative de l'URL de base de l'API d'actifsGAME_ASSETS_API_TOKEN— jeton d'accès par utilisateur
Si le jeton est manquant et que le service nécessite une authentification, demander à l'utilisateur de définir GAME_ASSETS_API_TOKEN avant de générer. Ne demander GAME_ASSETS_API_URL que lorsque l'utilisateur doit surcharger le service par défaut. Ne jamais demander les clés API Tripo ou Gemini ; elles résident sur le serveur.
Workflow des outils
Si les outils MCP nommés mcp__game_assets__* sont disponibles dans votre session, les privilégier. Sinon, exécuter le client fourni via Bash. Les deux exposent les deux mêmes opérations.
- Exécuter
pwdsi vous ne connaissez pas déjà le chemin de l'espace de travail actuel. - Si vous prévoyez 3 actifs ou plus, ou s'il s'agit de la première génération d'actifs dans le fil de discussion, vérifier l'état de préparation (
<skill-dir>est le répertoire de cette compétence) :
node <skill-dir>/scripts/game-assets-mcp.mjs readiness --cwd "$(pwd)"
- Générer 1 à 3 actifs (max 4 par lot). Passer les paramètres sous forme d'un seul objet JSON :
node <skill-dir>/scripts/game-assets-mcp.mjs generate --cwd "$(pwd)" --params '{
"gamePrompt": "...",
"route": "tripo",
"assets": [{ "id": "...", "role": "player", "name": "...", "prompt": "..." }]
}'
route:tripo,gemini_reference, ouauto.assets: 1 à 3 objets aveciden kebab-case stable,role,name,prompt, et facultativementassetKind.force: uniquement lorsque l'utilisateur a explicitement demandé de régénérer les actifs.- La commande bloque pendant l'interrogation du travail distant (généralement 1 à 3 minutes par lot) et affiche un résultat JSON ; le code de sortie 1 signifie que le lot a échoué.
- Après le retour de la commande, lire
asset_manifest.jsondepuis lecwd. Considérer ce fichier comme la source de vérité. - Intégrer les
manifest.assetsdans le code du jeu avecGLTFLoaderde Three.js. - Conserver un repli primitif local pour chaque actif généré. Le jeu doit rester jouable lorsqu'un GLB ne peut pas être chargé.
Exemple de JSON --params :
{
"cwd": "/absolute/path/to/project",
"gamePrompt": "3D runner with an astronaut cat collecting crystals and dodging patrol robots",
"route": "gemini_reference",
"assets": [
{
"id": "astronaut-cat",
"role": "player",
"name": "Astronaut Cat",
"assetKind": "character",
"prompt": "original low-poly astronaut cat hero, round helmet, compact readable silhouette, blue and white suit, friendly arcade game character"
},
{
"id": "energy-crystal",
"role": "collectible",
"name": "Energy Crystal",
"assetKind": "prop",
"prompt": "bright cyan faceted energy crystal pickup, clean silhouette, game collectible"
}
]
}
Règles d'intégration à l'exécution
- Normaliser chaque GLB chargé avec
THREE.Box3().setFromObject(): redimensionner à la taille cible, centrer horizontalement, placer le bas ày = 0, et appliquer un décalage d'orientation stable. - Séparer les visuels des hitbox de gameplay. La collision doit utiliser des dimensions de gameplay stables, et non les limites brutes du modèle ou les origines du maillage.
- Si
manifest.assetscontientrigged,rigTypeouanimations, inspecter lesgltf.animationschargées avant de prétendre qu'une animation native existe. - Lorsque des clips natifs existent, créer un
THREE.AnimationMixer, mapper les clips par sous-chaînes insensibles à la casse telles queidle,walk,run, etjump, et appelermixer.update(delta)à chaque image. - Si aucun clip natif n'existe, utiliser un balancement/inclinaison/rotation de groupe entier ou des clips procéduraux explicitement étiquetés comme animation de repli.
- Ajouter une courte section
README.mdnommée3D Asset Pipelineou3D 素材流水线décrivant quels actifs ont été générés, quelle route a été utilisée et quelle source d'animation d'exécution est utilisée.
Gestion des échecs
- API d'actifs inaccessible (readiness signale
unreachable) : expliquer que la génération de modèles distants est indisponible, demander à l'utilisateur de vérifier le service d'actifs par défaut, l'accès réseau, etGAME_ASSETS_API_TOKENsi nécessaire ; ne demanderGAME_ASSETS_API_URLque lors de la surcharge du service par défaut. Conserver les replis primitifs et continuer le jeu jouable. - Clé Gemini manquante sur le serveur pour la route
gemini_reference: basculer verstriposi acceptable, ou informer l'utilisateur que l'opérateur du serveur doit configurer la clé Gemini. - Solde Tripo nul : ne pas réessayer en boucle. Conserver les replis et enregistrer l'étape ignorée dans le README.
- Succès partiel : utiliser les actifs générés qui ont réussi et la géométrie de repli pour le reste.