Communitygithub.com

Actifs 3D pour Jeu

Cette compétence génère et intègre des actifs GLB reconnaissables dans un jeu 3D via un workflow complet : sélection de route, génération, suivi des manifestes et intégration avec replis.

Qu'est-ce que Actifs 3D pour Jeu ?

Cette compétence est conçue pour les jeux 3D nécessitant des actifs GLB concrets plutôt que de simples primitives géométriques. Elle gère l'intégralité du processus : choix de la route de génération (Tripo pour la vitesse, Gemini pour le contrôle visuel, ou auto), création de 1 à 3 actifs clés (personnages, collectibles, ennemis, etc.), suivi via un fichier `asset_manifest.json`, et intégration dans le code du jeu avec Three.js. La compétence assure la jouabilité même en cas d'échec de chargement des GLB en utilisant des géométries primitives comme replis. Elle inclut des scripts intégrés, prend en charge les animations (rigging, clips natifs ou procéduraux), et gère les erreurs (API inaccessible, clé manquante, solde Tripo nul) de manière robuste. Le système peut être utilisé via des outils MCP ou en ligne de commande.

Compatible avec~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add 674345386/agent-skills

Demander à votre IA préférée

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

Documentation

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.json contient 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'actifs
  • GAME_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.

  1. Exécuter pwd si vous ne connaissez pas déjà le chemin de l'espace de travail actuel.
  2. 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)"
  1. 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, ou auto.
  • assets : 1 à 3 objets avec id en kebab-case stable, role, name, prompt, et facultativement assetKind.
  • 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é.
  1. Après le retour de la commande, lire asset_manifest.json depuis le cwd. Considérer ce fichier comme la source de vérité.
  2. Intégrer les manifest.assets dans le code du jeu avec GLTFLoader de Three.js.
  3. 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.assets contient rigged, rigType ou animations, inspecter les gltf.animations chargé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 que idle, walk, run, et jump, et appeler mixer.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.md nommée 3D Asset Pipeline ou 3D 素材流水线 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, et GAME_ASSETS_API_TOKEN si nécessaire ; ne demander GAME_ASSETS_API_URL que 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 vers tripo si 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.

Skills associés