CommunityImagegithub.com

asset-forge

Generate game art locally and for free - concept images, UI icons, illustrations, and game-ready 3D models (.glb with PBR textures) from a text prompt or a picture. Use whenever the user asks to create, generate, regenerate or fix a game asset, 3D model, prop, character model, icon or concept image, or to check a .glb.

What is asset-forge?

asset-forge is a Claude Code agent skill that generate game art locally and for free - concept images, UI icons, illustrations, and game-ready 3D models (.glb with PBR textures) from a text prompt or a picture. Use whenever the user asks to create, generate, regenerate or fix a game asset, 3D model, prop, character model, icon or concept image, or to check a .glb.

Works with~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 Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

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

  1. 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). Use prop_native_trellis2 for props and character_native for characters (about a minute each); omitting the profile gives the prop default. prop_lowpoly / character_lowpoly are the slower UltraTex pipeline, the fallback on cards under 12 GB - use them only if the user asks or the GPU is small. Profiles marked experimental have not been verified on this machine - say so if you use one.
  2. Always pass the game project folder (project_dir / --project). Its assetforge.json supplies 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>).
  3. For 3D, approve the picture first. Call generate_asset with image_only: true (about a minute), look at the image, and only then call it again without image_only (about a minute with the default profiles, 4-8 with UltraTex). The second call reuses the approved image; no prompt is needed.
  4. 3D jobs are asynchronous. generate_asset returns a job id; call get_job with wait_seconds: 50 repeatedly until the status is not queued or running. Run one asset at a time - there is one GPU.
  5. 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.

PresetUse it forCost
fastBlocking out, background clutter, distant or mobile assets: the lowest triangle count (about 800 for a prop, 4,000 for a character).1-2 minutes
standardThe default. 3,000-triangle props, 12,000-triangle characters.about 1 minute (native, measured); 4-5 minutes (UltraTex)
maxHero 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.

ProblemFix
shattered meshThin 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 meshRe-run with force: true and a new seed.
decimation failed / mesh collapsedRe-run with force: true; if it repeats, raise tris.
flat sheetThe 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_profiles shows what each profile accepts.
  • New profile: a small JSON file in the project's assetforge_profiles/ folder that extends an existing one. See the README in the Asset Forge folder.
  • Models and hardware: the models tool reports what each profile needs, what is missing and what suits this GPU. Downloads are large - ask the user before installing.

Related Skills