CommunityImagegithub.com

forge3d

Créez des modèles 3D qui correspondent précisément à une image de référence ou à une brève description, dans Blender (scripté, sans tête, sans installation) et Blockbench (.bbmodel).

Qu'est-ce que forge3d ?

forge3d est un outil d'IA agentive conçu pour la modélisation 3D à partir de références visuelles ou de descriptions textuelles. Il prend en charge la création de personnages, créatures, accessoires, véhicules et modèles de style Minecraft (voxel ou basse poly). L'outil s'intègre à Blender (mode headless, sans installation) et à Blockbench pour produire des fichiers .blend, .glb, .bbmodel, etc. Le processus suit un pipeline structuré : analyse de la référence, décomposition en parties, construction et révision via des sous-agents, assemblage et export. forge3d mesure automatiquement la référence, génère un blocage (blockout), puis orchestre la construction de chaque pièce par des agents spécialisés, vérifie chaque pièce individuellement et l'ensemble assemblé par rapport à la référence, et ajoute le line art du dessin. L'outil est idéal pour les demandes de modélisation, sculpture, voxélisation, texturation, rendu ou export d'actifs 3D.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/quasar2333/forge3d/tree/main/forge3d

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 forge3d ?

Vous pouvez écrire de bonnes géométries 3D. Ce que vous ne pouvez pas faire seul, c'est mesurer une image, voir ce que votre code a produit, et garder un modèle entier en vue tout en accordant une attention complète à chaque partie. forge3d fournit ces trois éléments : il mesure la référence, montre chaque construction à côté, et divise le modèle en parties qui sont chacune sculptées et vérifiées indépendamment dans un cadre commun. Un modèle construit en dehors de cela n'a rien qui le vérifie par rapport à la référence.

F3D="<dossier de ce SKILL.md>/scripts/f3d.py"
python3 "$F3D" doctor

Utilisez le chemin absolu du lanceur lorsque vous démarrez un nouveau shell. Travaillez dans le dossier de travail actuel. Pour une pièce jointe de bureau, utilisez le chemin sous "Fichiers mentionnés par l'utilisateur" et copiez-le dans le dossier de travail s'il se trouve ailleurs. Mettez les deux chemins de fichiers entre guillemets. Pour une construction sans surveillance, décidez les détails de conception de routine à partir du dessin. Construisez à partir de la référence : ne cherchez pas dans d'autres dossiers des modèles antérieurs à réutiliser, sauf si l'utilisateur en signale un.

Lors de la révision d'un modèle existant, travaillez sur une copie. Reconstruisez l'emplacement demandé par rapport à ses voisins terminés, inspectez-le dans la scène assemblée, et conservez la géométrie approuvée. Une révision de visage peut utiliser les cheveux et le corps existants. Reconstruire chaque emplacement supprimerait le travail approuvé par l'utilisateur.

Blender est déjà là. f3d exécute un Blender privé sans tête (le module bpy, dans ~/.cache/forge3d ; définissez F3D_HOME si un bac à sable interdit ce dossier). N'installez, ne téléchargez et ne cherchez jamais une application Blender. Chaque construction enregistre un .blend qui s'ouvre dans l'application Blender ; python3 "$F3D" python script.py exécute n'importe quel script Python Blender.

Les commandes f3d prennent de 5 à 120 s. Exécutez-les au premier plan et attendez-les en un seul appel (Codex : yield_time_ms de 120000 ou plus), au lieu de les interroger. Conservez les fichiers de travail dans le dossier de travail, pas dans /tmp.

Conventions partout : mètres, Z vers le haut, le sujet se tient sur z = 0 à x = y = 0 et fait face à -Y ; +X est la droite du spectateur en vue de face. Un sujet de référence mesure 1,0 de haut sauf si vous passez --height.

Une image de référence est un dessin de conception, pas un ensemble de photographies. Une feuille de tournage est trois dessins qui s'accordent approximativement et trichent librement : le profil dessine un œil qui est le même œil que la vue de face montre, les arcs et les oreilles font face au spectateur dans chaque vue, une queue se trouve sur le même côté du papier devant et derrière. Elle indique quelles parties existent, leur taille, leur emplacement, leurs couleurs, leurs détails. Construisez cela comme un seul objet 3D cohérent.

Quelle route

  • Un personnage, une créature, tout ce qui est fait de plusieurs choses -> la route des parties ci-dessous.
  • Un objet simple de quelques formes (une tasse, une épée, une caisse, un accessoire basse poly) -> un script avec le kit et python3 "$F3D" build model.py --ref refs ; voir references/modeling.md.
  • Blockbench -> en plus de l'une ou l'autre, voir "Blockbench" ci-dessous.
  • Aucune image de référence, ou une seule vue, et vous pouvez générer des images -> créez d'abord une feuille de tournage (face avant, côté tourné vers la gauche, dos ; orthographique, même échelle, ligne de sol commune, fond blanc uni, lumière plate, pas de texte) ; invite dans references/reference-and-gen3d.md.

La route des parties

Dans l'ordre, sans en sauter aucune : (1) f3d ref, et attendez ; (2) faites l'inventaire ; (3) blockout.py et f3d blockout ; (4) f3d next, encore et encore : il nomme les sous-agents à générer, et cette compétence les demande : constructeurs, puis relecteurs indépendants, puis réparateurs ; (5) model.py, f3d build, livrez. Votre propre travail est la mise en page et les notes ; la construction et le jugement sont le travail des agents.

1. Mesurer la référence

python3 "$F3D" ref sheet.png -o refs (30 à 90 s) découpe le sujet, divise une feuille de tournage en vues, place chaque vue sur une grille de coordonnées et signale si le sujet est dessiné avec des contours à l'encre. Attendez avant d'écrire quoi que ce soit : chaque étape ultérieure est mesurée à partir de ses images, et la géométrie tapée à partir de la feuille brute entre-temps doit être refaite. Ouvrez refs/overview.png et vérifiez les noms des vues ; si c'est faux, relancez avec --views front,right,back (ordre de lecture ; right signifie que le sujet fait face à GAUCHE dans cette image, left signifie qu'il fait face à DROITE, skip ignore une image, par exemple une deuxième pose du dos).

2. Faire l'inventaire

Listez les parties dans votre réponse : chaque chose qui a son propre matériau ou qui se détacherait en un seul morceau. Pour un personnage, typiquement 9 à 14. Un personnage a un corps, et c'est une partie : body est le cou, le torse, les hanches et les jambes jusqu'aux hanches en un seul solide continu, la base sur laquelle tout le reste repose. Les vêtements sont des parties dessus (on="body") : une jupe ou une veste construite sans le corps en dessous est un tube vide. Ensuite, la tête (le visage lui appartient), les cheveux (les cheveux longs ou détaillés sont deux parties : hair_front avec la frange et les mèches latérales, hair_back), chaque vêtement, chaque accessoire, les bras et les mains, les chaussures, la queue. Séparez là où le matériau change, là où une chose se superpose à une autre, là où quelque chose se répète (les paires sont une seule partie). Pour chaque partie, décidez la vérité 3D une fois là où les vues trichent : combien il y en a, où elle se trouve vraiment, dans quelle direction elle regarde vraiment. Lorsque les vêtements couvrent une articulation, nommez l'emplacement qui possède l'anatomie sous-jacente. Par exemple, mettez les bras et les poignets dans l'emplacement du corps ou du bras et le poignet dans l'emplacement de la manche. Les deux cuisses doivent rejoindre le bassin, y compris le côté caché en profil. Lorsqu'un autre emplacement fournit les jambes inférieures ou les bas, attachez-le à l'anatomie avec on= pour que l'outil vérifie les deux côtés indépendamment.

3. Blocage (Blockout)

Écrivez blockout.py : le modèle entier sous forme de formes de substitution grossières et non peintes, chacune au bon endroit, à la bonne taille, chacune attribuée à un emplacement. C'est le contrat qui fait que les pièces construites séparément s'emboîtent. Lisez les positions et les tailles sur refs/<view>_grid.png.

# blockout.py
from forge3d import kit as k
tete = k.sphere(radii=(0.215, 0.20, 0.225), at=(0, 0.005, 0.635))
k.slot("tete", tete, review="face", note="Tête chibi avec petites oreilles. Correspondre aux ouvertures des yeux dessinés, au regard, sourcils et bouche. Façonner la joue, le nez et la mâchoire à partir du profil. Les cheveux couvrent une partie du front.")
jupe = k.cyl(r=0.235, r2=0.085, h=0.20, at=(0, 0, 0.17))
k.slot("jupe", jupe, on="torso", note="Jupe navire en forme de cloche, plissée, avec un bandeau brodé en or près de l'ourlet tout autour et un volant de jupon blanc festonné en dessous.")
noeuds = [k.box(size=(0.07, 0.10, 0.09), at=(sx * 0.275, 0.09, 0.645)) for sx in (-1, 1)]
k.slot("noeuds", noeuds, on="cheveux", note="Paire de nœuds ruban bleu clair avec une perle dorée. Chaque image les dessine face au spectateur ; en 3D, ils se trouvent sur les côtés de la tête, tournés vers l'extérieur et un peu vers l'avant.")
  • Formes : k.sphere(radii=), k.box, k.cyl, k.loft, k.sweep(path, r=) : grossier est correct.
  • on= : le ou les emplacements sur lesquels une partie repose ou est suspendue. Une partie est construite par rapport à la partie finie sur laquelle elle repose, donc ne nommez que ce sur quoi elle repose vraiment et gardez les chaînes courtes.
  • note= : tout ce que le constructeur de la partie saura au-delà des images. Dites ce que c'est, ses matériaux et couleurs, chaque caractéristique qu'elle porte, et la vérité 3D que vous avez décidée là où les vues trichent. Une note vague donne une partie vague.
  • review= attribue une vérification focale lorsque le nom de l'emplacement est ambigu. Utilisez face pour la partie portant l'expression, hair pour les mèches détaillées et joint pour le corps possédant la connexion hanche-jambe. Utilisez detail pour une autre caractéristique priorisée par l'utilisateur. Les parties ordinaires partagent la révision de l'assemblage. Les noms de tête, cheveux et corps habituels sélectionnent déjà leurs vérifications. Attribuez un propriétaire pour le visage.
python3 "$F3D" blockout blockout.py --ref refs     # 10 s -> parts/: plan.json, overview.png, un ordre de travail par emplacement

Ouvrez parts/overview.png et parts/blockout_compare.png. Chaque partie de la référence a besoin d'un emplacement à peu près de la bonne taille au bon endroit (IoU de contour autour de 0,8 suffit). Corrigez et relancez jusqu'à ce que cela tienne.

4. Construction et révision avec f3d next

python3 "$F3D" next        # affiche l'état de chaque partie et les agents exacts à générer maintenant

Cette compétence demande explicitement des sous-agents. Faites ce que f3d next affiche, puis relancez-le, jusqu'à ce qu'il affiche DONE :

  • Pour une construction complexe guidée par référence dans Codex, commencez avec gpt-6.2-astra comme chef. Lorsque le compte propose gpt-6.2-sol et que l'outil de génération accepte un modèle par agent, définissez-le pour les constructeurs de pièces. Gardez le chef sur la planification, l'assemblage et l'inspection finale. Une session dirigée par Sol peut également exécuter l'ensemble du flux de travail. Si le client n'expose pas la sélection de modèle pour un sous-agent, laissez le modèle non défini et utilisez sa valeur par défaut.
  • Répartissez jusqu'à trois tâches indépendantes à la fois. Pour un nouveau constructeur ou relecteur, utilisez spawn_agent, fork_turns: "none", le nom de tâche imprimé, l'effort et le message. Attendez qu'un travailleur signale, puis demandez next pour les tâches prêtes. Donnez à chaque partie un seul propriétaire actif. Envoyez les réparations à son constructeur d'origine avec followup_task lorsque disponible. Le relecteur reste indépendant.
  • Chaque constructeur inspecte l'ajustement et le rendu. Un visage ou des cheveux détaillés reçoivent un examen rapproché indépendant et, après une réparation, une vérification ciblée. Un corps ou un détail spécifié reçoit une vérification indépendante. Les autres pièces partagent la révision de l'assemblage, sauf si leur rapport de construction signale un problème structurel. Conservez les croisements de cheveux dessinés et vérifiez chaque cuisse à la coupe de hanche ajustée, même lorsque le vêtement extérieur la recouvre.
  • f3d review assemble les emplacements finis pour ses images. Il demande des réparations par propriétaire. Son deuxième passage vérifie ces résultats et les régressions de réparation. Construisez la livraison une fois que les pièces se stabilisent. Inspectez tout résultat en suspens à la limite dans la scène finale enregistrée.

Là où aucun outil de sous-agent n'existe : construisez chaque partie vous-même à partir de son brief (references/parts.md ; pour un modèle cuboïde "Construire une partie cuboïde" dans references/blockbench.md), suivez le même planning next et utilisez references/review.md pour les vérifications visuelles.

5. Assembler et livrer

# model.py
from forge3d import kit as k
parties = k.assemble()                 # chaque partie finie dans son emplacement ; formes de blocage grises pour le reste
k.outline()                          # le contour à l'encre du dessin autour de chaque pièce séparée (lorsque f3d ref a signalé du line art)
k.export("out/name.glb")             # aussi .fbx .obj .stl .usdz .bbmodel

python3 "$F3D" build model.py --ref refs (une à deux minutes) vérifie le modèle, rend out/model_sheet.png et out/model_compare.png, et enregistre out/model.blend. Après que f3d next dit DONE, regardez vous-même une fois : python3 "$F3D" view out/model.blend --views az40el10,az-40el10,az140el10,az0el-50 --tile 1024 --cols 2 (le dernier est vu d'en bas). Gérez les résultats de mise en page dans blockout.py, relancez f3d blockout et suivez f3d next pour réajuster les emplacements affectés. À la limite de révision, comparez les résultats listés avec la construction finale enregistrée avant la livraison.

Terminé signifie : f3d next affiche DONE ; une vérification propre ; des vues en trois-quarts dans lesquelles chaque caractéristique dessinée est entière et exactement une fois et rien ne flotte, n'est creux ou enterré ; IoU de contour d'environ 0,85 ou plus dans chaque vue, sauf là où vous avez décidé qu'une vue triche.

Livrez ce qui a été demandé : l'exportation, le .blend, un rendu de présentation (k.stage, k.camera, k.render avec le moteur EEVEE par défaut, voir references/modeling.md). Dites à l'utilisateur les chiffres finaux, montrez l'image de comparaison et une vue en trois-quarts, et dites clairement ce qui est simplifié, ce que les révisions ont laissé ouvert, et quelles différences de vue vous avez laissées intentionnellement.

Pour un personnage avec un visage visible, rendez python3 "$F3D" portrait out/name.blend à partir du fichier final mis en scène. Inspectez l'expression, la profondeur des yeux, les ombres des joues et de la bouche avec les cheveux, matériaux et lumières réels. La feuille comprend des recadrages de référence alignés, de face, de profil et deux gros plans en trois-quarts. Si la scène a plusieurs emplacements de visage, choisissez-en un avec --slot. Lorsque le visage semble trop large, trop étroit ou plat, utilisez portrait out/name.blend --form pour comparer les plans de la mâchoire et de la joue nues. Pour chaque repère non obstrué, passez --span Z LEFT_X RIGHT_X en utilisant ses coordonnées de référence de face mesurées. L'outil signale la largeur du maillage à cet endroit et marque les deux points de référence.

Blockbench

Demandez (ou déduisez) quel type de modèle Blockbench est souhaité ; ce sont des produits différents :

  • Modèle maillé (le plus proche de la référence ; formes lisses avec la texture réelle ; format Generic Model) : terminez le modèle comme ci-dessus, puis k.export("out/name.bbmodel") dans le script, ou python3 "$F3D" bb mesh model.py --ref refs -o out/name.bbmodel. Chaque objet devient un maillage nommé et éditable.
  • Modèle cuboïde conçu (boîtes sur os avec une texture pixel art ; ce dont les mods Minecraft, les entités Bedrock / Java et les animateurs ont besoin). Un sujet de plusieurs parties suit la route des parties avec une ligne supplémentaire dans le blocage, bb.plan(height=80, format="bedrock") : chaque partie est ensuite construite comme des cuboïdes sur des os et bb.assemble() les joint. Un mob ou accessoire simple est un script avec bb.Model.
  • Modèle voxel (statue en blocs de n'importe quel modèle, nombreux cuboïdes, sans armature) : python3 "$F3D" bb voxelize model.py --ref refs --height 48 -o out/name.bbmodel.

Avec seulement "faites-le dans Blockbench", faites le modèle cuboïde : c'est à cela que sert Blockbench, et un sujet mécanique, en blocs ou pixel art lui convient. Faites le modèle maillé à la place uniquement pour un dessin doux et courbe (un personnage chibi, un animal) ou si demandé. Dites lequel vous avez fait et que l'autre est disponible.

Prouvez le fichier dans l'application réelle lorsque Blockbench est installé : python3 "$F3D" bb check out/name.bbmodel l'ouvre dans un Blockbench privé caché (hors ligne, propre profil), signale ce qui a été chargé, enregistre la propre vue de Blockbench, et peut exécuter les exportateurs de Blockbench (--export bedrock:out/name.geo.json).

API, formats et conseils pixel art : references/blockbench.md. Lisez-le avant d'écrire un script Blockbench.

Problèmes courants

  • Une pièce manque dans le

…

[tronqué pour la traduction]

Skills associés