CommunityImagegithub.com

Asset Forge

Générez des assets de jeu localement et gratuitement – images conceptuelles, icônes UI, illustrations et modèles 3D prêts pour le jeu (.glb avec textures PBR) à partir d'un prompt textuel ou d'une image. À utiliser lorsque l'utilisateur demande de créer, générer, régénérer ou réparer un asset de jeu, un modèle 3D, un accessoire, un modèle de personnage, une icône ou une image conceptuelle, ou de vérifier un fichier .glb.

Qu'est-ce que Asset Forge ?

Asset Forge transforme du texte en images et en modèles 3D prêts pour le jeu en utilisant le GPU de la machine (ComfyUI en arrière-plan, démarré automatiquement). Aucune donnée n'est envoyée à un service payant. Il offre une sélection de profils pour la génération d'images (concepts, icônes) et de modèles 3D (accessoires, personnages) avec trois niveaux de présélection (fast, standard, max) qui contrôlent le nombre de triangles et le niveau de détail. Les assets 3D sont générés de manière asynchrone ; il faut d'abord approuver l'image conceptuelle, puis lancer la génération 3D, et enfin vérifier le résultat via une prévisualisation et un contrôle de maillage. Asset Forge prend également en charge des profils de style (réaliste PBR, peint à la main, toon, lowpoly plat, voxel) et permet une personnalisation fine par projet via un fichier assetforge.json, ou par appel via des paramètres supplémentaires. Les problèmes de maillage sont diagnostiqués et des solutions sont proposées pour éviter les échecs.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-3d-mcp/tree/main/skills/asset-forge

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

Que fait Asset Forge ?

Asset Forge transforme du texte en images et en modèles 3D prêts pour le jeu sur le GPU de cette machine (ComfyUI en arrière-plan ; il est démarré automatiquement). Rien n'est envoyé à un service payant.

Comment l'appeler

Privilégiez les outils MCP asset-forge lorsqu'ils sont disponibles : list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status.

Sinon, utilisez la ligne de commande depuis le dossier Asset Forge ; chaque commande affiche un objet JSON :

python forge.py profiles
python forge.py image  <nom> "<prompt>" -p icône --projet <dossier du jeu>
python forge.py asset  <nom> "<prompt>" -p accessoire_natif_trellis2 --projet <dossier du jeu>
python forge.py asset  <nom> --image <image> -p personnage_natif --projet <dossier du jeu>
python forge.py check  <modèle.glb>

Code de sortie 0 = ok, 2 = terminé mais le maillage a échoué à son contrôle, 1 = erreur.

Workflow

  1. Choisissez un profil avec list_profiles. Les profils d'image créent des images (concept_accessoire, concept_personnage, icône, illustration) ; les profils d'asset créent des modèles 3D avec trois préréglages chacun (voir ci-dessous). Utilisez accessoire_natif_trellis2 pour les accessoires et personnage_natif pour les personnages (environ une minute chacun) ; omettre le profil donne le défaut pour accessoire. accessoire_lowpoly / personnage_lowpoly sont la pipeline UltraTex plus lente, le repli sur les cartes de moins de 12 Go – utilisez-les uniquement si l'utilisateur le demande ou si le GPU est petit. Les profils marqués expérimental n'ont pas été vérifiés sur cette machine – mentionnez-le si vous en utilisez un.
  2. Passez toujours le dossier du projet de jeu (project_dir / --projet). Son assetforge.json fournit le style artistique, le dossier de sortie et les paramètres par profil, de sorte que les assets restent cohérents. Si le projet n'en a pas, proposez d'en créer un (forge.py init <dossier>).
  3. Pour la 3D, approuvez d'abord l'image. Appelez generate_asset avec image_only: true (environ une minute), regardez l'image, puis appelez-le à nouveau sans image_only (environ une minute avec les profils par défaut, 4-8 avec UltraTex). Le deuxième appel réutilise l'image approuvée ; aucun prompt n'est nécessaire.
  4. Les tâches 3D sont asynchrones. generate_asset renvoie un identifiant de tâche ; appelez get_job avec wait_seconds: 50 de manière répétée jusqu'à ce que le statut ne soit plus queued ou running. Exécutez un asset à la fois – il n'y a qu'un seul GPU.
  5. Regardez le résultat. Une tâche terminée renvoie un aperçu rendu (vue de face et trois-quarts) et un contrôle de maillage. Ne signalez pas de succès sans avoir regardé l'aperçu.

Préréglages

Passez preset à generate_asset (--preset en ligne de commande). Choisissez en fonction de l'utilisation de l'asset, et dites lequel vous avez utilisé.

PréréglageUtilisationCoût
fastBlocage, encombrement de fond, assets distants ou mobiles : le nombre de triangles le plus bas (environ 800 pour un accessoire, 4 000 pour un personnage).1-2 minutes
standardLe défaut. 3 000 triangles pour les accessoires, 12 000 triangles pour les personnages.environ 1 minute (natif, mesuré) ; 4-5 minutes (UltraTex)
maxAssets héroïques que la caméra approche de près : résolution de forme complète et le plus de détails de texture (accessoires 8 000 triangles).le plus long ; pas encore mesuré

Les temps natifs rapides et tous les temps max sont des estimations ; le natif standard a été mesuré sur six sujets. Sur les cartes de moins de 16 Go, certains paramètres sont plafonnés automatiquement ; le résultat les liste sous limited_by_vram.

Changer le préréglage ou tout paramètre pour le même nom régénère le modèle mais réutilise l'image conceptuelle ; des paramètres identiques renvoient le résultat mis en cache.

Préréglages de style

Pour un aspect cohérent dans un ensemble, passez style_preset (ids dans list_profiles -> styles) : realistic_pbr, hand_painted, toon, lowpoly_flat, voxel. Utilisez le même pour chaque asset d'un jeu, ou définissez-le une fois dans le assetforge.json du projet. Ils sont expérimentaux ; mentionnez-le, et vérifiez l'aperçu. Les profils *_natif respectent le plus de paramètres de style ; le style_ignored du résultat liste ceux que le profil n'a pas pu appliquer.

Rédiger des prompts

  • Décrivez uniquement le sujet : ce qu'il est, matériaux, couleurs, usure, proportions. Le profil ajoute le cadrage, l'éclairage et l'arrière-plan.
  • Un objet par asset. Les paires, ou un objet plus des débris épars, sont des assets séparés.
  • Massif bat délicat. Les fils fins, cages, dentelles, vrais trous et pointes fines comme des cheveux se cassent lors de l'étape 3D – demandez des poignées épaisses, une tige solide au lieu d'une chaîne, des marques gravées au lieu de trous.
  • Personnages : personne et tenue uniquement, pas d'objets tenus. Fabriquez les armes comme accessoires.

Quand le résultat indique failed_check

Le fichier est écrit mais ne doit pas être utilisé tel quel. problems explique pourquoi.

ProblèmeCorrectif
maillage éclatéDes parties fines se sont brisées. Relancez avec force: true et params: {"thin": 0.9}. Si cela échoue à nouveau, régénérez l'image avec des parties plus épaisses et solides.
maillage pointuRelancez avec force: true et une nouvelle seed.
décimation échouée / maillage effondréRelancez avec force: true ; si cela se reproduit, augmentez tris.
feuille plateL'image a été lue comme plate. Régénérez l'image avec "massif, profond, solide" dans le prompt.

force: true accompagné d'un prompt régénère également l'image ; force: true sans prompt conserve l'image et refait uniquement l'étape 3D.

Personnalisation

  • Par projet : modifiez assetforge.json (style, dossier de sortie, profiles.<id>.params).
  • Par appel : params, par ex. {"tris": 5000}. list_profiles montre ce que chaque profil accepte.
  • Nouveau profil : un petit fichier JSON dans le dossier assetforge_profiles/ du projet qui extends un profil existant. Voir le README dans le dossier Asset Forge.
  • Modèles et matériel : l'outil models indique ce dont chaque profil a besoin, ce qui manque et ce qui convient à ce GPU. Les téléchargements sont volumineux – demandez à l'utilisateur avant d'installer.

Skills associés