Asset Forge
Asset Forge turns text into images and into game-ready 3D models on this machine's GPU (ComfyUI underneath; it is started automatically). Nothing is sent to a paid service.
How to call it
Prefer the asset-forge MCP tools when they are available:
list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status.
Otherwise use the command line from the Asset Forge folder; every command prints one JSON object:
python forge.py profiles
python forge.py image <name> "<prompt>" -p icon --project <game folder>
python forge.py asset <name> "<prompt>" -p prop_native_trellis2 --project <game folder>
python forge.py asset <name> --image <picture> -p character_native --project <game folder>
python forge.py check <model.glb>
Exit code 0 = ok, 2 = finished but the mesh failed its check, 1 = error.
Workflow
- Pick a profile with
list_profiles. Image profiles make pictures (concept_prop,concept_character,icon,illustration); asset profiles make 3D models with three presets each (see below). Useprop_native_trellis2for props andcharacter_nativefor characters (about a minute each); omitting the profile gives the prop default.prop_lowpoly/character_lowpolyare the slower UltraTex pipeline, the fallback on cards under 12 GB - use them only if the user asks or the GPU is small. Profiles markedexperimentalhave not been verified on this machine - say so if you use one. - Always pass the game project folder (
project_dir/--project). Itsassetforge.jsonsupplies the art style, the output folder and per-profile settings, so assets stay consistent. If the project has none, offer to create one (forge.py init <dir>). - For 3D, approve the picture first. Call
generate_assetwithimage_only: true(about a minute), look at the image, and only then call it again withoutimage_only(about a minute with the default profiles, 4-8 with UltraTex). The second call reuses the approved image; no prompt is needed. - 3D jobs are asynchronous.
generate_assetreturns a job id; callget_jobwithwait_seconds: 50repeatedly until the status is notqueuedorrunning. Run one asset at a time - there is one GPU. - Look at the result. A finished job returns a rendered preview (front and three-quarter view) and a mesh check. Do not report success without looking at the preview.
Presets
Pass preset to generate_asset (--preset on the command line). Pick by what the
asset is for, and say which one you used.
| Preset | Use it for | Cost |
|---|---|---|
fast | Blocking out, background clutter, distant or mobile assets: the lowest triangle count (about 800 for a prop, 4,000 for a character). | 1-2 minutes |
standard | The default. 3,000-triangle props, 12,000-triangle characters. | about 1 minute (native, measured); 4-5 minutes (UltraTex) |
max | Hero assets the camera gets close to: full shape resolution and the most texture detail (props 8,000 triangles). | longest; not yet measured |
Native fast and all max times are estimates; native standard was measured on six subjects. On cards under 16 GB some settings are capped automatically; the
result lists them under limited_by_vram.
Changing the preset or any parameter for the same name regenerates the model but reuses the concept image; identical settings return the cached result.
Style presets
For a consistent look across a set, pass style_preset (ids in list_profiles ->
styles): realistic_pbr, hand_painted, toon, lowpoly_flat, voxel. Use the same
one for every asset of a game, or set it once in the project's assetforge.json. They are
experimental; say so, and check the preview. The *_native profiles honour the most
style settings; the result's style_ignored lists any the profile could not apply.
Writing prompts
- Describe only the subject: what it is, materials, colours, wear, proportions. The profile adds framing, lighting and background.
- One object per asset. Pairs, or an object plus loose debris, are separate assets.
- Chunky beats delicate. Thin wires, cages, lace, real holes and hair-thin spikes break in the 3D step - ask for thick handles, a solid rod instead of a chain, engraved marks instead of holes.
- Characters: person and outfit only, no held items. Make weapons as props.
When the result says failed_check
The file is written but should not be used as is. problems explains why.
| Problem | Fix |
|---|---|
shattered mesh | Thin parts broke apart. Re-run with force: true and params: {"thin": 0.9}. If it fails again, regenerate the image with thicker, solid parts. |
spiky mesh | Re-run with force: true and a new seed. |
decimation failed / mesh collapsed | Re-run with force: true; if it repeats, raise tris. |
flat sheet | The picture read as flat. Regenerate the image with "bulky, deep, solid" in the prompt. |
force: true together with a prompt regenerates the image too; force: true without
a prompt keeps the image and only redoes the 3D step.
Customising
- Per project: edit
assetforge.json(style, output folder,profiles.<id>.params). - Per call:
params, e.g.{"tris": 5000}.list_profilesshows what each profile accepts. - New profile: a small JSON file in the project's
assetforge_profiles/folder thatextendsan existing one. See the README in the Asset Forge folder. - Models and hardware: the
modelstool reports what each profile needs, what is missing and what suits this GPU. Downloads are large - ask the user before installing.