Asset Generator
Assets come from godogen_assets: local generators on this machine's GPU, one command per task, free. Its checkout here is ${GODOGEN_ASSETS}, and its docs are the reference; this page is the TL;DR plus what the game needs on top. Read ${GODOGEN_ASSETS}/README.md once (conventions, a character start to finish, checking results), and a part's README up to How it works before first using its tool.
| Command |
Makes |
README in the checkout |
qwen-image |
PNG from text; rgba: real transparency; edit -i ref.png: image-to-image |
image/ |
gen3d |
textured GLB from an image |
mesh/ |
mia-rig |
Mixamo-rigged humanoid from a GLB |
rig/ |
add-moves, gen-moves |
idle/walk/run/jump onto a rig; custom moves from text prompts |
motion/ |
grip-prop |
a prop made holdable; add-moves --hold puts it in a character's hand |
motion/ |
lipsync |
speaking mouth + lip-synced clip from a voice line |
lipsync/ |
stable-audio |
sound effects, seamless ambience loops |
sfx/ |
qwen-tts |
voice lines from a description, or cloned from a reference line |
voice/ |
A character: qwen-image rgba (T-pose) → gen3d → mia-rig --fingers --anim none → add-moves, with gen-moves for custom moves and lipsync for speech. Props stop after gen3d; one a character holds goes on through grip-prop and add-moves --hold, never by an offset tuned in the engine.
- Always pass
-o into the project; without it, results land in the godogen_assets checkout.
- One GPU job at a time, minutes per call. Run GPU tools as one sequential batch with a long timeout or in the background, never as parallel calls.
- Game budget.
gen3d defaults to ~500k triangles and 2048² textures; pass --faces / --tex (30000 / 1024 for a character).
- Style families. Generate one hero asset, derive the rest with
qwen-image edit -i hero.png, prompting only what changes.
- Small sprites. A 1024px image downscaled to 64px looks muddy: design display sizes ≥128px, prompt bold flat forms, or generate a kit (several objects in one image) and slice it with
python3 ${ASSET_GEN_SKILL_DIR}/tools/grid_slice.py kit.png -o out/ --grid 2x2 --names "a,b,c,d".
- Direction. Generators get left/right and facing wrong; generate one direction and flip at runtime.
- Audio format. Every tool picks it from the
-o extension. Bevy's default features decode only Ogg Vorbis, so write .ogg for Bevy.
- Review before building on it. Look at every PNG. You can't look at a GLB or hear a WAV: render GLBs (
${GODOGEN_ASSETS}/README.md, Checking results) and read audio as a spectrogram (${GODOGEN_ASSETS}/sfx/README.md).
Moves that drive gameplay — root-motion locomotion, attacks, state machines, anything held, ridden or aimed, characters that touch each other: read ${ASSET_GEN_SKILL_DIR}/motion.md.
Blender
Some 3D is better built than generated. A bpy script run headless (blender -b -P make_turret.py, exporting with bpy.ops.export_scene.gltf) is often the better path when:
- the shape must be exact or articulated: a vehicle whose wheels turn, a door on its hinge, a turret that aims, kit pieces that snap together;
- a generated GLB needs work: split into parts, new pivots, decimation, several merged into one;
- the animation is outside the humanoid tools: mechanical parts, a creature of a few bones, keyframed or procedural clips.
Check what it writes like any GLB. Without blender on PATH, asset-blender script.py -- args runs the script in godogen_assets' Blender (its print goes to stderr).
Paid APIs
${ASSET_GEN_SKILL_DIR}/api.md covers Gemini / xAI Grok images, animated sprites from Grok video, Tripo 3D, Gemini TTS and Lyria music. Read it only when an asset needs one:
- godogen_assets isn't on this machine (its checkout above reads
none), or a command answers not installed — that part isn't set up;
- the local tools don't make it: frame-by-frame animated 2D sprites, music, one character voice acting many emotions, vocal barks, two-speaker dialogue, a language
qwen-tts lacks, a rig for a non-humanoid;
- a local result stays wrong after rewording and a few seeds.
Paid calls cost real money: confirm with the user before the first one.
Asset manifest (in README.md)
Track every generated asset in README.md with an in-game Size column — without it, coders consistently scale assets wrong. gen3d models come out 1.0 tall with no real scale, so this column is where their size is decided:
- 3D models: meters, e.g.
4m long, 1.8m tall, 0.3m
- Textures: tile size, e.g.
2m tile
- Backgrounds: pixel size + behavior, e.g.
1920x1080, fullscreen
- Sprites: display pixels, e.g.
128x128 px
- Audio: length + use, e.g.
1.2 s one-shot, 8 bars / 22.6 s loop
| Name |
Description |
Size |
Path |
Cost |
| crate |
wooden supply crate |
0.8m |
${RUNTIME_ASSET_DIR}/glb/crate.glb |
local |
| theme |
village shop music |
8 bars / 22.6 s loop |
${RUNTIME_ASSET_DIR}/audio/shop_loop.ogg |
4¢ |
1---2name: asset-gen3display_name: Asset Generator4short_description: Generate game images, 3D models, animated characters, sound effects, voice and music5default_prompt: "Use ${ASSET_SKILL_COMMAND} to generate images, 3D models, characters, or audio for this game."6allow_implicit_invocation: true7description: |8 Generate game assets, locally and free by default with godogen_assets: images and transparent PNGs (Qwen-Image), textured GLB models (TRELLIS.2), rigged humanoids with generated moves and lip-synced speech, sound effects and voice lines. Paid APIs cover what the local tools can't make — Gemini / xAI Grok images, animated sprites from video, Tripo 3D, Gemini TTS voice acting, Lyria music. Use whenever a game needs generated art or audio.9metadata:10 source: https://skillmd.com/skills/tuyv/asset-gen11---1213# Asset Generator1415Assets come from [godogen_assets](https://github.com/htdt/godogen_assets): local generators on this machine's GPU, one command per task, free. Its checkout here is `${GODOGEN_ASSETS}`, and its docs are the reference; this page is the TL;DR plus what the game needs on top. Read `${GODOGEN_ASSETS}/README.md` once (conventions, a character start to finish, checking results), and a part's README up to `How it works` before first using its tool.1617| Command | Makes | README in the checkout |18|---------|-------|------------------------|19| `qwen-image` | PNG from text; `rgba`: real transparency; `edit -i ref.png`: image-to-image | `image/` |20| `gen3d` | textured GLB from an image | `mesh/` |21| `mia-rig` | Mixamo-rigged humanoid from a GLB | `rig/` |22| `add-moves`, `gen-moves` | idle/walk/run/jump onto a rig; custom moves from text prompts | `motion/` |23| `grip-prop` | a prop made holdable; `add-moves --hold` puts it in a character's hand | `motion/` |24| `lipsync` | speaking mouth + lip-synced clip from a voice line | `lipsync/` |25| `stable-audio` | sound effects, seamless ambience loops | `sfx/` |26| `qwen-tts` | voice lines from a description, or cloned from a reference line | `voice/` |2728A character: `qwen-image rgba` (T-pose) → `gen3d` → `mia-rig --fingers --anim none` → `add-moves`, with `gen-moves` for custom moves and `lipsync` for speech. Props stop after `gen3d`; one a character holds goes on through `grip-prop` and `add-moves --hold`, never by an offset tuned in the engine.2930- **Always pass `-o`** into the project; without it, results land in the godogen_assets checkout.31- **One GPU job at a time, minutes per call.** Run GPU tools as one sequential batch with a long timeout or in the background, never as parallel calls.32- **Game budget.** `gen3d` defaults to ~500k triangles and 2048² textures; pass `--faces` / `--tex` (30000 / 1024 for a character).33- **Style families.** Generate one hero asset, derive the rest with `qwen-image edit -i hero.png`, prompting only what changes.34- **Small sprites.** A 1024px image downscaled to 64px looks muddy: design display sizes ≥128px, prompt bold flat forms, or generate a kit (several objects in one image) and slice it with `python3 ${ASSET_GEN_SKILL_DIR}/tools/grid_slice.py kit.png -o out/ --grid 2x2 --names "a,b,c,d"`.35- **Direction.** Generators get left/right and facing wrong; generate one direction and flip at runtime.36- **Audio format.** Every tool picks it from the `-o` extension. Bevy's default features decode only Ogg Vorbis, so write `.ogg` for Bevy.37- **Review before building on it.** Look at every PNG. You can't look at a GLB or hear a WAV: render GLBs (`${GODOGEN_ASSETS}/README.md`, Checking results) and read audio as a spectrogram (`${GODOGEN_ASSETS}/sfx/README.md`).3839Moves that drive gameplay — root-motion locomotion, attacks, state machines, anything held, ridden or aimed, characters that touch each other: read `${ASSET_GEN_SKILL_DIR}/motion.md`.4041## Blender4243Some 3D is better built than generated. A `bpy` script run headless (`blender -b -P make_turret.py`, exporting with `bpy.ops.export_scene.gltf`) is often the better path when:4445- the shape must be exact or articulated: a vehicle whose wheels turn, a door on its hinge, a turret that aims, kit pieces that snap together;46- a generated GLB needs work: split into parts, new pivots, decimation, several merged into one;47- the animation is outside the humanoid tools: mechanical parts, a creature of a few bones, keyframed or procedural clips.4849Check what it writes like any GLB. Without `blender` on `PATH`, `asset-blender script.py -- args` runs the script in godogen_assets' Blender (its `print` goes to stderr).5051## Paid APIs5253`${ASSET_GEN_SKILL_DIR}/api.md` covers Gemini / xAI Grok images, animated sprites from Grok video, Tripo 3D, Gemini TTS and Lyria music. Read it only when an asset needs one:5455- godogen_assets isn't on this machine (its checkout above reads `none`), or a command answers `not installed` — that part isn't set up;56- the local tools don't make it: frame-by-frame animated 2D sprites, music, one character voice acting many emotions, vocal barks, two-speaker dialogue, a language `qwen-tts` lacks, a rig for a non-humanoid;57- a local result stays wrong after rewording and a few seeds.5859Paid calls cost real money: confirm with the user before the first one.6061## Asset manifest (in README.md)6263Track every generated asset in `README.md` with an **in-game Size** column — without it, coders consistently scale assets wrong. `gen3d` models come out 1.0 tall with no real scale, so this column is where their size is decided:6465- 3D models: meters, e.g. `4m long`, `1.8m tall`, `0.3m`66- Textures: tile size, e.g. `2m tile`67- Backgrounds: pixel size + behavior, e.g. `1920x1080, fullscreen`68- Sprites: display pixels, e.g. `128x128 px`69- Audio: length + use, e.g. `1.2 s one-shot`, `8 bars / 22.6 s loop`7071| Name | Description | Size | Path | Cost |72|------|-------------|------|------|------|73| crate | wooden supply crate | 0.8m | ${RUNTIME_ASSET_DIR}/glb/crate.glb | local |74| theme | village shop music | 8 bars / 22.6 s loop | ${RUNTIME_ASSET_DIR}/audio/shop_loop.ogg | 4¢ |