CommunityBildgithub.com

Asset Forge

Erstelle Spielgrafiken lokal und kostenlos – Konzeptbilder, UI-Symbole, Illustrationen und spielbereite 3D-Modelle (.glb mit PBR-Texturen) aus einer Textbeschreibung oder einem Bild.

Was ist Asset Forge?

Asset Forge ist ein lokales KI-Werkzeug, das Text oder Bilder auf der GPU des Rechners in spielfertige 3D-Modelle und Bilder verwandelt. Es basiert auf ComfyUI, wird automatisch gestartet und sendet keine Daten an kostenpflichtige Dienste. Das Tool unterstützt verschiedene Profile für Images (Konzepte, Symbole) und Assets (3D-Modelle mit PBR-Texturen) und kann über MCP-Tools oder die Kommandozeile gesteuert werden. Es ist ideal für Spieleentwickler, die schnell Prototypen, Hintergrundelemente oder Helden-Assets erstellen möchten, und bietet Anpassungsmöglichkeiten durch Presets und Stilvorlagen. Der Workflow umfasst die Auswahl eines Profils, die Freigabe eines generierten Bildes und die asynchrone Erstellung des 3D-Modells mit automatischer Fehlerprüfung.

Funktioniert mit~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 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 Asset Forge?

Asset Forge verwandelt Text in Bilder und in spielbereite 3D-Modelle auf der GPU dieses Rechners (ComfyUI läuft darunter; es wird automatisch gestartet). Nichts wird an einen kostenpflichtigen Dienst gesendet.

Aufruf

Bevorzugen Sie die asset-forge MCP-Tools, wenn sie verfügbar sind: list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status.

Andernfalls verwenden Sie die Kommandozeile aus dem Asset-Forge-Ordner; jeder Befehl gibt ein JSON-Objekt aus:

python forge.py profiles
python forge.py image  <name> "<prompt>" -p icon --project <Spielordner>
python forge.py asset  <name> "<prompt>" -p prop_native_trellis2 --project <Spielordner>
python forge.py asset  <name> --image <Bild> -p character_native --project <Spielordner>
python forge.py check  <model.glb>

Exit-Code 0 = ok, 2 = fertig, aber das Mesh hat die Prüfung nicht bestanden, 1 = Fehler.

Arbeitsablauf

  1. Wählen Sie ein Profil mit list_profiles. Bildprofile erstellen Bilder (concept_prop, concept_character, icon, illustration); Asset-Profile erstellen 3D-Modelle mit jeweils drei Voreinstellungen (siehe unten). Verwenden Sie prop_native_trellis2 für Requisiten und character_native für Charaktere (jeweils etwa eine Minute); ohne Profilangabe wird die Standard-Requisite verwendet. prop_lowpoly / character_lowpoly sind die langsamere UltraTex-Pipeline, die Alternative für Grafikkarten unter 12 GB – verwenden Sie sie nur, wenn der Nutzer danach fragt oder die GPU klein ist. Profile mit dem Label experimental wurden auf diesem Rechner nicht verifiziert – sagen Sie dies, wenn Sie eines verwenden.
  2. Übergeben Sie immer den Spielprojektordner (project_dir / --project). Dessen assetforge.json liefert den Kunststil, den Ausgabeordner und proflilspezifische Einstellungen, sodass Assets konsistent bleiben. Wenn das Projekt keines hat, bieten Sie an, eines zu erstellen (forge.py init <verz>).
  3. Für 3D das Bild zuerst freigeben. Rufen Sie generate_asset mit image_only: true auf (etwa eine Minute), betrachten Sie das Bild, und rufen Sie es erst dann erneut ohne image_only auf (etwa eine Minute mit den Standardprofilen, 4-8 mit UltraTex). Der zweite Aufruf verwendet das freigegebene Bild erneut; kein Prompt erforderlich.
  4. 3D-Jobs sind asynchron. generate_asset gibt eine Job-ID zurück; rufen Sie get_job mit wait_seconds: 50 wiederholt auf, bis der Status nicht mehr queued oder running ist. Führen Sie jeweils nur ein Asset aus – es gibt eine GPU.
  5. Betrachten Sie das Ergebnis. Ein abgeschlossener Job gibt eine gerenderte Vorschau (Front- und Dreiviertelansicht) und eine Mesh-Prüfung zurück. Melden Sie keinen Erfolg, ohne die Vorschau anzusehen.

Voreinstellungen

Übergeben Sie preset an generate_asset (--preset in der Kommandozeile). Wählen Sie je nach Verwendungszweck und teilen Sie mit, welche Sie verwendet haben.

VoreinstellungVerwendungKosten
fastBlockieren, Hintergrundunschärfe, entfernte oder mobile Assets: die niedrigste Dreiecksanzahl (ca. 800 für eine Requisite, 4.000 für einen Charakter).1-2 Minuten
standardDie Standardeinstellung. 3.000-Dreieck-Requisiten, 12.000-Dreieck-Charaktere.etwa 1 Minute (nativ, gemessen); 4-5 Minuten (UltraTex)
maxHelden-Assets, denen die Kamera nahe kommt: volle Formauflösung und die meiste Texturdetails (Requisiten 8.000 Dreiecke).am längsten; noch nicht gemessen

Native Fast- und alle Max-Zeiten sind Schätzungen; native Standard wurde an sechs Motiven gemessen. Bei Grafikkarten unter 16 GB werden einige Einstellungen automatisch begrenzt; das Ergebnis listet sie unter limited_by_vram.

Das Ändern der Voreinstellung oder eines Parameters für denselben Namen generiert das Modell neu, verwendet aber das Konzeptbild erneut; identische Einstellungen geben das zwischengespeicherte Ergebnis zurück.

Stilvorlagen

Für ein einheitliches Erscheinungsbild über eine Reihe hinweg übergeben Sie style_preset (IDs in list_profiles -> styles): realistic_pbr, hand_painted, toon, lowpoly_flat, voxel. Verwenden Sie die gleiche Vorlage für jedes Asset eines Spiels oder legen Sie sie einmal in der assetforge.json des Projekts fest. Sie sind experimentell; sagen Sie dies und überprüfen Sie die Vorschau. Die *_native-Profile beachten die meisten Stileinstellungen; das Ergebnis listet unter style_ignored, welche das Profil nicht anwenden konnte.

Prompts schreiben

  • Beschreiben Sie nur das Motiv: was es ist, Materialien, Farben, Abnutzung, Proportionen. Das Profil fügt Bildausschnitt, Beleuchtung und Hintergrund hinzu.
  • Ein Objekt pro Asset. Paare oder ein Objekt mit losen Trümmern sind separate Assets.
  • Klobig schlägt zart. Dünne Drähte, Käfige, Spitze, echte Löcher und haarfeine Stacheln brechen im 3D-Schritt – bitten Sie um dicke Griffe, einen massiven Stab statt einer Kette, eingravierte Markierungen statt Löchern.
  • Charaktere: nur Person und Outfit, keine gehaltenen Gegenstände. Stellen Sie Waffen als Requisiten her.

Wenn das Ergebnis failed_check anzeigt

Die Datei wurde geschrieben, sollte aber nicht unverändert verwendet werden. problems erklärt warum.

ProblemLösung
shattered meshDünne Teile sind zerbrochen. Wiederholen Sie mit force: true und params: {"thin": 0.9}. Wenn es erneut fehlschlägt, generieren Sie das Bild mit dickeren, massiven Teilen neu.
spiky meshWiederholen Sie mit force: true und einem neuen seed.
decimation failed / mesh collapsedWiederholen Sie mit force: true; wenn es sich wiederholt, erhöhen Sie tris.
flat sheetDas Bild wurde als flach gelesen. Generieren Sie das Bild mit „massiv, tief, solide“ im Prompt neu.

force: true zusammen mit einem prompt generiert das Bild ebenfalls neu; force: true ohne Prompt behält das Bild bei und wiederholt nur den 3D-Schritt.

Anpassung

  • Pro Projekt: Bearbeiten Sie assetforge.json (Stil, Ausgabeordner, profiles.<id>.params).
  • Pro Aufruf: params, z. B. {"tris": 5000}. list_profiles zeigt, was jedes Profil akzeptiert.
  • Neues Profil: eine kleine JSON-Datei im Ordner assetforge_profiles/ des Projekts, die ein vorhandenes extends. Siehe die README im Asset-Forge-Ordner.
  • Modelle und Hardware: Das Tool models meldet, was jedes Profil benötigt, was fehlt und was zu dieser GPU passt. Downloads sind groß – fragen Sie den Nutzer vor der Installation.

Verwandte Skills