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
- 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 Sieprop_native_trellis2für Requisiten undcharacter_nativefür Charaktere (jeweils etwa eine Minute); ohne Profilangabe wird die Standard-Requisite verwendet.prop_lowpoly/character_lowpolysind 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 Labelexperimentalwurden auf diesem Rechner nicht verifiziert – sagen Sie dies, wenn Sie eines verwenden. - Übergeben Sie immer den Spielprojektordner (
project_dir/--project). Dessenassetforge.jsonliefert 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>). - Für 3D das Bild zuerst freigeben. Rufen Sie
generate_assetmitimage_only: trueauf (etwa eine Minute), betrachten Sie das Bild, und rufen Sie es erst dann erneut ohneimage_onlyauf (etwa eine Minute mit den Standardprofilen, 4-8 mit UltraTex). Der zweite Aufruf verwendet das freigegebene Bild erneut; kein Prompt erforderlich. - 3D-Jobs sind asynchron.
generate_assetgibt eine Job-ID zurück; rufen Sieget_jobmitwait_seconds: 50wiederholt auf, bis der Status nicht mehrqueuedoderrunningist. Führen Sie jeweils nur ein Asset aus – es gibt eine GPU. - 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.
| Voreinstellung | Verwendung | Kosten |
|---|---|---|
fast | Blockieren, Hintergrundunschärfe, entfernte oder mobile Assets: die niedrigste Dreiecksanzahl (ca. 800 für eine Requisite, 4.000 für einen Charakter). | 1-2 Minuten |
standard | Die Standardeinstellung. 3.000-Dreieck-Requisiten, 12.000-Dreieck-Charaktere. | etwa 1 Minute (nativ, gemessen); 4-5 Minuten (UltraTex) |
max | Helden-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.
| Problem | Lösung |
|---|---|
shattered mesh | Dü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 mesh | Wiederholen Sie mit force: true und einem neuen seed. |
decimation failed / mesh collapsed | Wiederholen Sie mit force: true; wenn es sich wiederholt, erhöhen Sie tris. |
flat sheet | Das 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_profileszeigt, was jedes Profil akzeptiert. - Neues Profil: eine kleine JSON-Datei im Ordner
assetforge_profiles/des Projekts, die ein vorhandenesextends. Siehe die README im Asset-Forge-Ordner. - Modelle und Hardware: Das Tool
modelsmeldet, was jedes Profil benötigt, was fehlt und was zu dieser GPU passt. Downloads sind groß – fragen Sie den Nutzer vor der Installation.