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
- 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). Utilisezaccessoire_natif_trellis2pour les accessoires etpersonnage_natifpour les personnages (environ une minute chacun) ; omettre le profil donne le défaut pour accessoire.accessoire_lowpoly/personnage_lowpolysont 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ésexpérimentaln'ont pas été vérifiés sur cette machine – mentionnez-le si vous en utilisez un. - Passez toujours le dossier du projet de jeu (
project_dir/--projet). Sonassetforge.jsonfournit 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>). - Pour la 3D, approuvez d'abord l'image. Appelez
generate_assetavecimage_only: true(environ une minute), regardez l'image, puis appelez-le à nouveau sansimage_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. - Les tâches 3D sont asynchrones.
generate_assetrenvoie un identifiant de tâche ; appelezget_jobavecwait_seconds: 50de manière répétée jusqu'à ce que le statut ne soit plusqueuedourunning. Exécutez un asset à la fois – il n'y a qu'un seul GPU. - 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églage | Utilisation | Coût |
|---|---|---|
fast | Blocage, 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 |
standard | Le défaut. 3 000 triangles pour les accessoires, 12 000 triangles pour les personnages. | environ 1 minute (natif, mesuré) ; 4-5 minutes (UltraTex) |
max | Assets 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ème | Correctif |
|---|---|
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 pointu | Relancez avec force: true et une nouvelle seed. |
décimation échouée / maillage effondré | Relancez avec force: true ; si cela se reproduit, augmentez tris. |
feuille plate | L'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_profilesmontre ce que chaque profil accepte. - Nouveau profil : un petit fichier JSON dans le dossier
assetforge_profiles/du projet quiextendsun profil existant. Voir le README dans le dossier Asset Forge. - Modèles et matériel : l'outil
modelsindique 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.