CommunityBildgithub.com

forge3d

Erstelle 3D-Modelle, die einem Referenzbild oder einem kurzen Wunsch stark ähneln, in Blender (skriptgesteuert, headless, ohne Installation) und Blockbench (.bbmodel). Misst die Referenz, legt das Modell als Blockout von Slots an, lässt jedes Teil einzeln formen (durch Sub-Agenten, wenn verfügbar), prüft jedes Teil und das zusammengesetzte Modell gegen die Referenz und fügt die Strichzeichnung hinzu. Verwende es für Anfragen zum Modellieren, Skulpturieren, Voxelisieren, Texturieren, Rendern oder Exportieren eines 3D-Assets wie einer Figur, Kreatur, eines Requisits, Fahrzeugs oder Minecraft-Stil-Modells.

Was ist forge3d?

forge3d ist ein KI-Agenten-Skill zum Erstellen präziser 3D-Modelle aus Referenzbildern oder textuellen Beschreibungen. Es unterstützt Blender (headless, skriptgesteuert) und Blockbench (.bbmodel) und ist damit ideal für die Erstellung von Charakteren, Kreaturen, Requisiten, Fahrzeugen und Minecraft-artigen Modellen. Der Skill automatisiert den gesamten Workflow: Er vermisst die Referenz, erstellt ein grobes Blockout aus Slots, delegiert die Formung jedes Teils an Sub-Agenten (z. B. in Codex) oder erledigt es selbst, prüft jedes Teil und die Montage gegen die Referenz und fügt die Linienkunst hinzu. Er läuft in der Konsole (keine GUI) und ist für Codex, Cursor und Claude Code optimiert. Der Hauptvorteil liegt in der strukturierten Aufteilung in Teile, der automatischen Prüfung und der Fähigkeit, auch ohne Sub-Agenten-Tool – über dedizierte Python-Skripte und visuelle Kontrollen – zu arbeiten. Er stellt sicher, dass jedes Teil einzeln geformt und geprüft wird, was zu einer hohen Genauigkeit und Konsistenz mit der Referenz führt.

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

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht forge3d?

Du kannst gute 3D-Geometrie schreiben. Was du allein nicht kannst, ist ein Bild zu vermessen, zu sehen, was dein Code erzeugt hat, und ein ganzes Modell im Blick zu behalten, während du jedem Teil volle Aufmerksamkeit schenkst. forge3d liefert diese drei Fähigkeiten: es misst die Referenz, zeigt jeden Bau daneben und teilt das Modell in Teile auf, die jeweils einzeln in einem gemeinsamen Rahmen geformt und geprüft werden. Ein Modell, das außerhalb davon gebaut wird, hat nichts, das es gegen die Referenz prüft.

F3D="<Ordner dieser SKILL.md>/scripts/f3d.py"
python3 "$F3D" doctor

Verwende den absoluten Launcher-Pfad, wenn du eine neue Shell startest. Arbeite im aktuellen Arbeitsverzeichnis. Für einen Desktop-Anhang verwende den Pfad unter "Vom Benutzer erwähnte Dateien" und kopiere ihn in das Arbeitsverzeichnis, falls er sich woanders befindet. Setze beide Dateipfade in Anführungszeichen. Entscheide bei einem unbeaufsichtigten Bau über routinemäßige Designdetails anhand der Zeichnung. Baue anhand der Referenz: Suche nicht in anderen Ordnern nach früheren Modellen davon, um sie wiederzuverwenden, es sei denn, der Benutzer zeigt auf eines.

Wenn du ein vorhandenes Modell überarbeitest, arbeite an einer Kopie. Baue den angeforderten Slot gegen seine fertigen Nachbarn, inspiziere ihn in der montierten Szene und behalte die genehmigte Geometrie bei. Eine Gesichtsüberarbeitung kann die vorhandenen Haare und den Körper durchgängig verwenden. Jeden Slot neu aufzubauen würde die genehmigte Arbeit des Benutzers verwerfen.

Blender ist bereits hier. f3d führt einen privaten Headless-Blender aus (das bpy-Modul in ~/.cache/forge3d; setze F3D_HOME, wenn eine Sandbox diesen Ordner verbietet). Installiere, lade oder suche niemals nach einer Blender-App. Jeder Bau speichert eine .blend-Datei, die in der Blender-App geöffnet wird; python3 "$F3D" python script.py führt jedes Blender-Python-Skript aus.

f3d-Befehle dauern 5 bis 120 s. Führe sie im Vordergrund aus und warte auf sie in einem einzigen Aufruf (Codex: yield_time_ms von 120000 oder mehr), anstatt zu polen. Behalte die Arbeitsdateien im Arbeitsverzeichnis, nicht in /tmp.

Konventionen überall: Meter, Z nach oben, das Subjekt steht auf z = 0 bei x = y = 0 und schaut in Richtung -Y; +X ist die rechte Seite des Betrachters in der Vorderansicht. Ein Referenzsubjekt ist 1,0 groß, es sei denn, du übergibst --height.

Ein Referenzbild ist eine Designzeichnung, kein Satz von Fotografien. Ein Drehblatt besteht aus drei Zeichnungen, die grob übereinstimmen und frei schummeln: Das Profil zeichnet ein Auge, das dasselbe Auge ist, das die Vorderansicht zeigt, Bögen und Ohren blicken in jeder Ansicht zum Betrachter, ein Schwanz sitzt auf derselben Seite des Papiers vorne und hinten. Es sagt, welche Teile es gibt, wie groß, wo, welche Farben, welche Details. Baue das als ein konsistentes 3D-Objekt.

Welcher Weg

  • Eine Figur, eine Kreatur, alles, was aus mehreren Dingen besteht -> den Teile-Weg unten.
  • Ein einfaches Objekt aus wenigen Formen (ein Becher, ein Schwert, eine Kiste, ein Low-Poly-Requisit) -> ein Skript mit dem Kit und python3 "$F3D" build model.py --ref refs; siehe references/modeling.md.
  • Blockbench -> zusätzlich zu einem der beiden Wege, siehe "Blockbench" unten.
  • Kein Referenzbild oder nur eine Ansicht, und du kannst Bilder generieren -> erstelle zuerst ein Drehblatt (Vorderseite, Seite nach links zeigend, Rückseite; orthografisch, gleicher Maßstab, gemeinsame Grundlinie, einfarbig weißer Hintergrund, flaches Licht, kein Text); Prompt in references/reference-and-gen3d.md.

Der Teile-Weg

In der Reihenfolge, ohne einen zu überspringen: (1) f3d ref und warte darauf; (2) Bestandsaufnahme machen; (3) blockout.py und f3d blockout; (4) f3d next, immer wieder: es benennt die zu startenden Sub-Agenten, und dieser Skill fordert sie an: Bauherren, dann unabhängige Prüfer, dann Reparateure; (5) model.py, f3d build, ausliefern. Deine eigene Arbeit sind das Layout und die Notizen; Bauen und Beurteilen sind die Arbeit der Agenten.

1. Referenz messen

python3 "$F3D" ref sheet.png -o refs (30 bis 90 s) schneidet das Subjekt aus, teilt ein Drehblatt in Ansichten auf, legt jede Ansicht auf ein Koordinatengitter und meldet, ob das Subjekt mit Tintenumrissen gezeichnet ist. Warte darauf, bevor du etwas schreibst: Jeder spätere Schritt wird anhand seiner Bilder gemessen, und gleichzeitig aus der Rohzeichnung eingegebene Geometrie muss wiederholt werden. Öffne refs/overview.png und überprüfe die Ansichtsnamen; falls falsch, führe erneut aus mit --views front,right,back (Lesereihenfolge; right bedeutet, dass das Subjekt in diesem Bild nach LINKS schaut, left bedeutet, dass es nach RECHTS schaut, skip ignoriert ein Bild, z. B. eine zweite Pose des Rückens).

2. Bestandsaufnahme machen

Liste die Teile in deiner Antwort auf: jedes Ding, das sein eigenes Material ist oder in einem Stück abgehen würde. Bei einer Figur typischerweise 9 bis 14. Eine Figur hat einen Körper, und er ist ein Teil: body ist der Hals, Rumpf, Hüften und die Beine bis in die Hüften als ein durchgehender Festkörper, die Basis, auf der alles andere sitzt. Kleidung sind Teile darauf (on="body"): Ein Rock oder eine Jacke, die ohne den darunterliegenden Körper gebaut wurde, ist eine leere Röhre. Dann Kopf (das Gesicht gehört dazu), Haare (lange oder detaillierte Haare sind zwei Teile: hair_front mit Pony und Seitensträhnen, hair_back), jedes Kleidungsstück, jedes Accessoire, Arme und Hände, Schuhe, Schwanz. Teile, wo sich das Material ändert, wo eine Sache über einer anderen liegt, wo sich etwas wiederholt (Paare sind ein Teil). Entscheide für jedes Teil die 3D-Wahrheit einmal dort, wo die Ansichten schummeln: Wie viele es davon gibt, wo es wirklich sitzt, in welche Richtung es wirklich zeigt. Wenn Kleidung ein Gelenk bedeckt, benenne den Slot, der die darunterliegende Anatomie besitzt. Zum Beispiel die Arme und Handgelenke in den Körper- oder Arm-Slot und die Manschette in den Ärmel-Slot legen. Beide Oberschenkel müssen mit dem Becken verbunden sein, einschließlich der im Profil verdeckten Seite. Wenn ein anderer Slot die Unterschenkel oder Strümpfe liefert, hänge es mit on= an die Anatomie an, damit das Werkzeug beide Seiten unabhängig prüft.

3. Blockout

Schreibe blockout.py: das gesamte Modell als grobe, unbemalte Platzhalterformen, jede an der richtigen Stelle in der richtigen Größe, jede einem Slot zugewiesen. Dies ist der Vertrag, der dafür sorgt, dass separat gebaute Teile zusammenpassen. Lies Positionen und Größen von refs/<view>_grid.png ab.

# blockout.py
from forge3d import kit as k
head = k.sphere(radii=(0.215, 0.20, 0.225), at=(0, 0.005, 0.635))
k.slot("head", head, review="face", note="Chibi-Kopf mit kleinen Ohren. Passe die gezeichneten Augenöffnungen, den Blick, die Augenbrauen und den Mund an. Forme die Wange, Nase und Kiefer aus dem Profil. Die Haare bedecken einen Teil der Stirn.")
skirt = k.cyl(r=0.235, r2=0.085, h=0.20, at=(0, 0, 0.17))
k.slot("skirt", skirt, on="torso", note="Glockenförmiger marineblauer Rock, plissiert, mit einem goldbestickten Band in der Nähe des Saums rundherum und einer weißen, gezackten Petticoat-Rüsche darunter.")
bows = [k.box(size=(0.07, 0.10, 0.09), at=(sx * 0.275, 0.09, 0.645)) for sx in (-1, 1)]
k.slot("bows", bows, on="hair", note="Paar hellblaue Schleifen aus Band mit einer goldenen Perle. Jedes Bild zeichnet sie dem Betrachter zugewandt; in 3D sitzen sie an den Seiten des Kopfes, nach außen und ein wenig nach vorne zeigend.")
  • Formen: k.sphere(radii=), k.box, k.cyl, k.loft, k.sweep(path, r=): grob ist richtig.
  • on=: der/die Slot(s), auf dem/denen ein Teil liegt oder von dem/denen es herabhängt. Ein Teil wird gegen das fertige Teil gebaut, auf dem es sitzt, also nenne nur, worauf es wirklich ruht, und halte die Ketten kurz.
  • note=: alles, was der Bauherr des Teils über die Bilder hinaus wissen wird. Sage, was es ist, seine Materialien und Farben, jedes Merkmal, das es trägt, und die 3D-Wahrheit, die du dort entschieden hast, wo die Ansichten schummeln. Eine vage Notiz ergibt ein vages Teil.
  • review= weist eine fokussierte Prüfung zu, wenn der Slot-Name mehrdeutig ist. Verwende face für das Teil, das den Gesichtsausdruck trägt, hair für detaillierte Locken und joint für den Körper, der die Hüft-Bein-Verbindung besitzt. Verwende detail für ein anderes vom Benutzer priorisiertes Merkmal. Gewöhnliche Teile teilen sich die Montageprüfung. Die üblichen Kopf-, Haar- und Körpernamen wählen bereits ihre Prüfungen aus. Weise einen Eigentümer für das Gesicht zu.
python3 "$F3D" blockout blockout.py --ref refs     # 10 s -> parts/: plan.json, overview.png, ein Arbeitsauftrag pro Slot

Öffne parts/overview.png und parts/blockout_compare.png. Jeder Teil der Referenz benötigt einen Slot von etwa der richtigen Größe an der richtigen Stelle (Kontur-IoU um 0,8 ist ausreichend). Korrigiere und führe erneut aus, bis das hält.

4. Bauen und prüfen mit f3d next

python3 "$F3D" next        # gibt den Zustand jedes Teils und die genauen Agenten aus, die jetzt gestartet werden sollen

Dieser Skill fordert explizit Sub-Agenten an. Tue, was f3d next ausgibt, und führe es dann erneut aus, bis es DONE ausgibt:

  • Für einen komplexen, referenzgesteuerten Bau in Codex, beginne mit gpt-6.2-astra als Leiter. Wenn das Konto gpt-6.2-sol anbietet und das Start-Tool ein Agenten-modellspezifisches Modell akzeptiert, setze es für die Teile-Bauherren. Behalte den Leiter für Planung, Montage und Endkontrolle. Eine Sol-geführte Sitzung kann auch den gesamten Arbeitsablauf ausführen. Wenn der Client die Modellauswahl für einen Sub-Agenten nicht bereitstellt, lasse das Modell nicht gesetzt und verwende seine Standardeinstellung.
  • Verteile bis zu drei unabhängige Jobs gleichzeitig. Verwende für einen neuen Bauherren oder Prüfer spawn_agent, fork_turns: "none", den gedruckten Tasknamen, Aufwand und Nachricht. Warte darauf, dass ein Arbeiter berichtet, und frage dann next nach bereiten Jobs. Gib jedem Teil einen aktiven Besitzer. Sende Reparaturen an seinen ursprünglichen Bauherren mit followup_task, wenn verfügbar. Der Prüfer bleibt unabhängig.
  • Jeder Bauherr inspiziert die Passform und den Render. Ein Gesicht oder detaillierte Haare erhalten einen unabhängigen genauen Blick und, nach einer Reparatur, eine fokussierte Überprüfung. Ein Körper oder ein bestimmtes Detail erhält eine unabhängige Prüfung. Andere Teile teilen sich die Montageprüfung, es sei denn, ihr Baubericht meldet ein strukturelles Problem. Behalte die gezeichneten Haar Kreuzungen und überprüfe jeden Oberschenkel am angepassten Hüftschnitt, auch wenn das äußere Kleidungsstück es bedeckt.
  • f3d review montiert die fertigen Slots für seine Bilder. Es fordert Reparaturen nach Besitzer an. Sein zweiter Durchlauf überprüft diese Ergebnisse und Reparatur-Regressionen. Baue die Lieferung, sobald sich die Teile beruhigt haben. Überprüfe alle ausstehenden Ergebnisse an der Obergrenze in der endgültig gespeicherten Szene.

Nur wo kein Sub-Agenten-Tool existiert: Baue jedes Teil selbst aus seiner Aufgabenbeschreibung (references/parts.md; für ein quaderförmiges Modell "Bauen eines quaderförmigen Teils" in references/blockbench.md), folge demselben next-Zeitplan und verwende references/review.md für die visuellen Prüfungen.

5. Montieren und ausliefern

# model.py
from forge3d import kit as k
parts = k.assemble()                 # jedes fertige Teil in seinem Slot; graue Blockout-Formen für den Rest
k.outline()                          # die Tintenlinie der Zeichnung um jedes einzelne Stück (wenn f3d ref Linienkunst gemeldet hat)
k.export("out/name.glb")             # auch .fbx .obj .stl .usdz .bbmodel

python3 "$F3D" build model.py --ref refs (eine bis zwei Minuten) lintet das Modell, rendert out/model_sheet.png und out/model_compare.png und speichert out/model.blend. Nachdem f3d next DONE sagt, schaue selbst einmal hin: python3 "$F3D" view out/model.blend --views az40el10,az-40el10,az140el10,az0el-50 --tile 1024 --cols 2 (die letzte ist von unten). Behandle Layout-Ergebnisse in blockout.py, führe f3d blockout erneut aus und folge f3d next, um die betroffenen Slots anzupassen. Vergleiche an der Prüfgrenze die aufgeführten Ergebnisse mit dem endgültig gespeicherten Bau vor der Auslieferung.

Fertig bedeutet: f3d next gibt DONE aus; ein sauberer Lint; Dreiviertelansichten, in denen jedes gezeichnete Merkmal ganz und genau einmal vorhanden ist und nichts schwebt, hohl oder vergraben ist; Kontur-IoU von ungefähr 0,85 oder mehr in jeder Ansicht, außer wo du entschieden hast, dass eine Ansicht schummelt.

Liefere aus, was gefordert wurde: den Export, die .blend, einen Präsentationsrender (k.stage, k.camera, k.render mit der standardmäßigen EEVEE-Engine, siehe references/modeling.md). Teile dem Benutzer die endgültigen Zahlen mit, zeige das Vergleichsbild und eine Dreiviertelansicht und sage klar, was vereinfacht ist, was die Prüfungen offen gelassen haben und welche Ansichtsunterschiede du absichtlich belassen hast.

Für eine Figur mit einem sichtbaren Gesicht, rendere python3 "$F3D" portrait out/name.blend aus der endgültig inszenierten Datei. Überprüfe den Gesichtsausdruck, die Augentiefe, die Wangen- und Mundschatten mit den tatsächlichen Haaren, Materialien und Lichtern. Das Blatt enthält ausgerichtete Referenzausschnitte, Vorder-, Profil- und beide Dreiviertel-Nahaufnahmen. Wenn die Szene mehrere Gesichtsslots hat, wähle einen mit --slot. Wenn das Gesicht zu breit, schmal oder flach aussieht, verwende portrait out/name.blend --form, um die nackten Kiefer- und Wangenebenen zu vergleichen. Übergib für jedes nicht verdeckte Merkmal --span Z LEFT_X RIGHT_X unter Verwendung seiner gemessenen Frontreferenzkoordinaten. Das Werkzeug meldet die Netzbreite dort und markiert die beiden Referenzendpunkte.

Blockbench

Frage (oder schließe daraus), welche Art von Blockbench-Modell gewünscht wird; es sind verschiedene Produkte:

  • Mesh-Modell (der Referenz am nächsten; glatte Formen mit der echten Textur; Generic Model Format): Schließe das Modell wie oben ab, dann verwende k.export("out/name.bbmodel") im Skript oder python3 "$F3D" bb mesh model.py --ref refs -o out/name.bbmodel. Jedes Objekt wird zu einem benannten, bearbeitbaren Mesh.
  • Entworfene quaderförmige Modelle (Boxen auf Bones mit einer Pixel-Art-Textur; was Minecraft-Mods, Bedrock/Java-Entitäten und Animatoren brauchen). Ein Subjekt aus mehreren Teilen geht den Teile-Weg mit einer zusätzlichen Zeile im Blockout, bb.plan(height=80, format="bedrock"): Jedes Teil wird dann als Quader auf Bones gebaut und bb.assemble() fügt sie zusammen. Ein einfacher Mob oder ein Requisit ist ein Skript mit bb.Model.
  • Voxel-Modell (blockartige Statue eines beliebigen Modells, viele Quader, kein Rig): python3 "$F3D" bb voxelize model.py --ref refs --height 48 -o out/name.bbmodel.

Wenn nur "Mach es in Blockbench" gesagt wird, baue das quaderförmige Modell: Dafür ist Blockbench gemacht, und ein mechanisches, blockartiges oder Pixel-Art-Subjekt passt dazu. Baue stattdessen das Mesh-Modell nur für eine weiche, geschwungene Zeichnung (eine Chibi-Figur, ein Tier) oder wenn danach gefragt wird. Sage, welches du gemacht hast und dass das andere verfügbar ist.

Überprüfe die Datei in der echten App, wenn Blockbench installiert ist: python3 "$F3D" bb check out/name.bbmodel öffnet es in einem privaten versteckten Blockbench (offline, eigenes Profil), meldet, was geladen wurde, speichert Blockbenchs eigene Ansicht davon und kann Blockbenchs Exporteure ausführen (--export bedrock:out/name.geo.json).

API, Formate und Pixel-Art-Anleitung: references/blockbench.md. Lese dies, bevor du ein Blockbench-Skript schreibst.

Dinge, die schiefgehen können

  • Ein Teil fehlt im

…

[für die Übersetzung abgeschnitten]

Verwandte Skills