blender-workflow-recipes
End-to-end Blender 5.3 playbooks chaining the blender-* skills with QA gates - game props (mid-poly, high-to-low), game characters (sculpt/AI mesh to rigged, animated export), Roblox props/accessories/avatars, AI or downloaded asset cleanup, procedural environments, web/AR assets
Install
npx skills add https://github.com/EL4CTEO/blender-skills/tree/main/skills/blender-workflow-recipes
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install el4cteo-blender-skills@llmmart
git clone https://github.com/EL4CTEO/blender-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole el4cteo/blender-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Workflow Recipes
S = the skills folder. Every .py runs headless via python S/blender-core/scripts/run_in_blender.py --blend F.blend S/<skill>/scripts/<x>.py -- ..., or live via MCP import + run() (see blender-core). Gate = stop and fix before continuing. Save after every stage (--save).
1. Game prop, mid-poly (fast, no bake)
- Blockout at real scale (
blender-hardsurface-modeling). Gate:ob.dimensionsvs reference. - UV the blockout before beveling (the Bevel/Boolean modifiers carry UVs):
uv_pack.py --objects SM_X --method seams --seams-from-sharp 60→texel_density.py --res 2048 --set 512 apply_stack.py --objects SM_X --preset midpoly [--cutters ...](keep it live;--apply --triangulateonly on the export copy)- Materials:
build_pbr_material.py --preset ...or tiling/trim textures. - Gate:
qa_check.py --objects SM_X --profile gamepasses, pluslook(angles, material + wireframe). mesh_stats.py --budget <platform>→make_lods.py --objects SM_X --renameexport_asset.py --preset <engine> --objects SM_X_LOD0 SM_X_LOD1 ...Gate: re-import dims / GLB summary.
2. Game prop, high → low baked (hero quality)
- High poly: hardsurface
--preset subdor sculpt (sculpt_ops.py), namedX_high. - Low:
auto_retopo.py --objects X_high --tris N --method planar|decimate|quadriflow, or manual. Rename itSM_X. uv_pack.py --objects SM_X --method seams --seams-from-sharp 60 --margin-px 16- Gate:
qa_check.pyonSM_X(game) andX_high(render profile, no inverted parts). bake_maps.py --low SM_X --high X_high --maps normal ao curvature id --pack-orm [--directx for Unreal]build_pbr_material.py --name M_X --textures //textures --objects SM_X. Wear/grime:smart_material.py --curvature-map //textures/T_X_CURV.png --ao-map //textures/T_X_AO.png --wear 0.4 --grime 0.4, then self-bake (bake_maps.py --low SM_X --maps basecolor roughness metallic) (blender-texturing).- Gate:
lookin material shading (no seams/waviness), then steps 6–7 of recipe 1.
3. Game character (sculpt or AI mesh → animated export)
- Source mesh (sculpt /
generate_3d/ scan) at real height, facing -Y, feet on Z=0. Runqa_check.py --profile render. auto_retopo.py --method quadriflow --tris 20000(or manual retopo for heroes, keeping the edge flow rules).uv_pack.py --method min_stretch.bake_maps.py --low Body --high Body_src --maps normal ao basecolor(basecolor via emission override if the source has colors/materials).rigify_build.py --add basic_human --fit Body→ place joints (look xray) →--metarig META_Body --generatebind_mesh.py --armature RIG_Body --meshes Body→stress_poses.py --armature RIG_Body→look(mode="frames"). Gate: no collapse at the elbows/knees/shoulders. Fix weights.rigify_build.py --rig RIG_Body --game-skeleton→rig_check.py --armature GAME_RIG_Body --profile unity|unreal6b. Clothes and hair:garment.py --body Body --group Torso --name Shirt --hide-body --morphs(blender-clothing),groom.py --surface Head --mask Scalp→--cards Hairfor engines (blender-hair-grooming). Gate:garment.py --checkin every stress pose.- Animate on RIG_Body, or retarget mocap:
retarget.py --source Mocap --target RIG_Body --show-map→ run (blender-animation). Thenbake_action.py --source RIG_Body --target GAME_RIG_Body [--root-motion xy --hips spine]andloop_check.py --fixon cycles. export_asset.py --preset unity_skeletal|unreal_skeletal --objects GAME_RIG_Body(meshes are included as children). Gate: GLB/FBX summary shows skins + all clips. Engine scale check.
4. Roblox
- MeshPart prop: recipe 1 with
--profile robloxin QA (≤20k tris, watertight, no n-gons, single UV 0–1), separate grayscale maps (no ORM),export_asset.py --preset roblox(FBX) orroblox_gltf. Textures 1024² (PBR). - Rigid accessory: ≤4k tris, an attachment point empty matching an R15
_Attname,--preset roblox. - Layered clothing: start from Roblox's official cage templates. Build
<Name>_InnerCage/_OuterCage(never change cage vertex count/order/UVs), skin to R15 bones, ≤4 influences, no weights on Root. Validate in Studio's Accessory Fitting Tool. - Avatar body: 15
_Geoparts, R15 skeleton, attachments, outer cages, 10,742 tri budget. Readblender-export-pipelines/references/roblox.mdfirst. - Upload: Studio
AssetService:CreateAssetAsyncfor batches.
5. Cleaning AI-generated / downloaded assets
- Import (
import_asset/generate_3d/ file). Scale to real size (world_bounding_box), origin to the bottom, ground at z=0,transform_apply. scene_audit.py --fix purge scale→qa_check.py --profile game. Typical findings: non-manifold, duplicate verts, inverted islands, floating debris, z-fighting shells.- Fix:
make_lods.py --cleanup(merge/degenerate/loose), recalc normals, delete floating debris (orremeshviasculpt_ops.pyfor garbage topology), thenauto_retopo.py --method decimateto budget. - Re-UV if the UVs are fragmented (
uv_pack.py) and re-bake from the original (bake_maps.py --high original). - Gate: QA passes +
look. Never ship generated meshes unreviewed.
6. Procedural environment
terrain.py --size 400 --res 513 --type ridged --erosion 30 --material(or--heightmap), then onescatter.pylayer per biome element (trees by slope/height, rocks aligned, grass masked) (blender-environment-kits). Custom scatter logic:gn_builder.py(recipes inblender-geometry-nodes/references/recipes.md). Modular buildings:kit_check.py --grid 0.5 --fixon every kit piece.- Assets to scatter: optimized props with LODs (recipe 1). Keep instances (don't realize) for engines that support instancing (
export_gpu_instances). - Gate:
mesh_stats.pyon the evaluated result, pluslookfrom the gameplay camera height.
7. Web / AR asset
Recipe 1 or 2 with budgets --budget web (≤30k tris, 1–2 materials, 2k textures) → export_asset.py --preset web (meshopt + WebP) → optional gltf-transform optimize --texture-compress ktx2. USDZ for iOS AR: --preset usd --out x.usdz. Gate: GLB summary (size < 5 MB) and Khronos PBR Neutral look-dev match.
8. Product shot / turntable
- Materials with measured values (
build_pbr_material.py --preset), and QA for z-fighting/floating parts (very visible in close-ups). - Set the render resolution, then
turntable.py --objects Product --rig studio --backdrop --frames 120 --lens 85 render_batch.py --preset preview --frames 1→ review →--preset product --frames 1-120 --format PNG→ encode, or--format MP4.- Gate: no fireflies or clipped highlights (AgX / Khronos PBR Neutral), and the product sits on the backdrop (contact shadow).
9. Mood / weather shot (rainy night, snowy morning, foggy dawn)
- Scene at real scale with a camera. QA the hero assets first (wet reflections and snow expose z-fighting and gaps).
scene_mood.py --time night --fog-visibility 250(or--mood cyberpunk|horror|underwater|desert). Add practical lights (street, windows, neon) at real color temperatures.- Weather:
precipitation.py --type rain --intensity heavy --ground <ground/roofs>→surface_weather.py --objects <surfaces> --wetness 0.7 --puddles 0.4 --ripples 1 --streaks 0.5→lightning.py --flashes 2. Snow:--type snow+--snow 0.8 --snow-depth 0.06. - Gate:
render_batch.py --preset preview --frames <mid>,<flash>at the final aspect ratio. Rain must read (backlit), puddles must reflect a light, the night must keep contrast. Then render the full loop (frame range = the precipitation loop).
Files (blender-skills)
-
SKILL.md 8 KB
--- name: blender-workflow-recipes description: End-to-end Blender 5.3 playbooks chaining the blender-* skills with QA gates - game props (mid-poly, high-to-low), game characters (sculpt/AI mesh to rigged, animated export), Roblox props/accessories/avatars, AI or downloaded asset cleanup, procedural environments, web/AR assets, product turntables, mood/weather shots (night, rain, snow, fog). Use for complete multi-stage asset requests. license: MIT metadata: author: blender-agent-skills version: "1.2.0" --- # Workflow Recipes `S` = the skills folder. Every `.py` runs headless via `python S/blender-core/scripts/run_in_blender.py --blend F.blend S/<skill>/scripts/<x>.py -- ...`, or live via MCP import + `run()` (see `blender-core`). **Gate** = stop and fix before continuing. Save after every stage (`--save`). ## 1. Game prop, mid-poly (fast, no bake) 1. Blockout at real scale (`blender-hardsurface-modeling`). Gate: `ob.dimensions` vs reference. 2. UV the blockout **before** beveling (the Bevel/Boolean modifiers carry UVs): `uv_pack.py --objects SM_X --method seams --seams-from-sharp 60` → `texel_density.py --res 2048 --set 512` 3. `apply_stack.py --objects SM_X --preset midpoly [--cutters ...]` (keep it live; `--apply --triangulate` only on the export copy) 4. Materials: `build_pbr_material.py --preset ...` or tiling/trim textures. 5. Gate: `qa_check.py --objects SM_X --profile game` passes, plus `look` (angles, material + wireframe). 6. `mesh_stats.py --budget <platform>` → `make_lods.py --objects SM_X --rename` 7. `export_asset.py --preset <engine> --objects SM_X_LOD0 SM_X_LOD1 ...` Gate: re-import dims / GLB summary. ## 2. Game prop, high → low baked (hero quality) 1. High poly: hardsurface `--preset subd` or sculpt (`sculpt_ops.py`), named `X_high`. 2. Low: `auto_retopo.py --objects X_high --tris N --method planar|decimate|quadriflow`, or manual. Rename it `SM_X`. 3. `uv_pack.py --objects SM_X --method seams --seams-from-sharp 60 --margin-px 16` 4. Gate: `qa_check.py` on `SM_X` (game) **and** `X_high` (render profile, no inverted parts). 5. `bake_maps.py --low SM_X --high X_high --maps normal ao curvature id --pack-orm [--directx for Unreal]` 6. `build_pbr_material.py --name M_X --textures //textures --objects SM_X`. Wear/grime: `smart_material.py --curvature-map //textures/T_X_CURV.png --ao-map //textures/T_X_AO.png --wear 0.4 --grime 0.4`, then self-bake (`bake_maps.py --low SM_X --maps basecolor roughness metallic`) (`blender-texturing`). 7. Gate: `look` in material shading (no seams/waviness), then steps 6–7 of recipe 1. ## 3. Game character (sculpt or AI mesh → animated export) 1. Source mesh (sculpt / `generate_3d` / scan) at real height, facing -Y, feet on Z=0. Run `qa_check.py --profile render`. 2. `auto_retopo.py --method quadriflow --tris 20000` (or manual retopo for heroes, keeping the edge flow rules). `uv_pack.py --method min_stretch`. 3. `bake_maps.py --low Body --high Body_src --maps normal ao basecolor` (basecolor via emission override if the source has colors/materials). 4. `rigify_build.py --add basic_human --fit Body` → place joints (look xray) → `--metarig META_Body --generate` 5. `bind_mesh.py --armature RIG_Body --meshes Body` → `stress_poses.py --armature RIG_Body` → `look(mode="frames")`. Gate: no collapse at the elbows/knees/shoulders. Fix weights. 6. `rigify_build.py --rig RIG_Body --game-skeleton` → `rig_check.py --armature GAME_RIG_Body --profile unity|unreal` 6b. Clothes and hair: `garment.py --body Body --group Torso --name Shirt --hide-body --morphs` (`blender-clothing`), `groom.py --surface Head --mask Scalp` → `--cards Hair` for engines (`blender-hair-grooming`). Gate: `garment.py --check` in every stress pose. 7. Animate on RIG_Body, or retarget mocap: `retarget.py --source Mocap --target RIG_Body --show-map` → run (`blender-animation`). Then `bake_action.py --source RIG_Body --target GAME_RIG_Body [--root-motion xy --hips spine]` and `loop_check.py --fix` on cycles. 8. `export_asset.py --preset unity_skeletal|unreal_skeletal --objects GAME_RIG_Body` (meshes are included as children). Gate: GLB/FBX summary shows skins + all clips. Engine scale check. ## 4. Roblox - **MeshPart prop**: recipe 1 with `--profile roblox` in QA (≤20k tris, watertight, no n-gons, single UV 0–1), separate grayscale maps (no ORM), `export_asset.py --preset roblox` (FBX) or `roblox_gltf`. Textures 1024² (PBR). - **Rigid accessory**: ≤4k tris, an attachment point empty matching an R15 `_Att` name, `--preset roblox`. - **Layered clothing**: start from Roblox's official cage templates. Build `<Name>_InnerCage`/`_OuterCage` (never change cage vertex count/order/UVs), skin to R15 bones, ≤4 influences, no weights on Root. Validate in Studio's Accessory Fitting Tool. - **Avatar body**: 15 `_Geo` parts, R15 skeleton, attachments, outer cages, 10,742 tri budget. Read `blender-export-pipelines/references/roblox.md` first. - Upload: Studio `AssetService:CreateAssetAsync` for batches. ## 5. Cleaning AI-generated / downloaded assets 1. Import (`import_asset` / `generate_3d` / file). Scale to real size (`world_bounding_box`), origin to the bottom, ground at z=0, `transform_apply`. 2. `scene_audit.py --fix purge scale` → `qa_check.py --profile game`. Typical findings: non-manifold, duplicate verts, inverted islands, floating debris, z-fighting shells. 3. Fix: `make_lods.py --cleanup` (merge/degenerate/loose), recalc normals, delete floating debris (or `remesh` via `sculpt_ops.py` for garbage topology), then `auto_retopo.py --method decimate` to budget. 4. Re-UV if the UVs are fragmented (`uv_pack.py`) and re-bake from the original (`bake_maps.py --high original`). 5. Gate: QA passes + `look`. Never ship generated meshes unreviewed. ## 6. Procedural environment 1. `terrain.py --size 400 --res 513 --type ridged --erosion 30 --material` (or `--heightmap`), then one `scatter.py` layer per biome element (trees by slope/height, rocks aligned, grass masked) (`blender-environment-kits`). Custom scatter logic: `gn_builder.py` (recipes in `blender-geometry-nodes/references/recipes.md`). Modular buildings: `kit_check.py --grid 0.5 --fix` on every kit piece. 2. Assets to scatter: optimized props with LODs (recipe 1). Keep instances (don't realize) for engines that support instancing (`export_gpu_instances`). 3. Gate: `mesh_stats.py` on the evaluated result, plus `look` from the gameplay camera height. ## 7. Web / AR asset Recipe 1 or 2 with budgets `--budget web` (≤30k tris, 1–2 materials, 2k textures) → `export_asset.py --preset web` (meshopt + WebP) → optional `gltf-transform optimize --texture-compress ktx2`. USDZ for iOS AR: `--preset usd --out x.usdz`. Gate: GLB summary (size < 5 MB) and Khronos PBR Neutral look-dev match. ## 8. Product shot / turntable 1. Materials with measured values (`build_pbr_material.py --preset`), and QA for z-fighting/floating parts (very visible in close-ups). 2. Set the render resolution, then `turntable.py --objects Product --rig studio --backdrop --frames 120 --lens 85` 3. `render_batch.py --preset preview --frames 1` → review → `--preset product --frames 1-120 --format PNG` → encode, or `--format MP4`. 4. Gate: no fireflies or clipped highlights (AgX / Khronos PBR Neutral), and the product sits on the backdrop (contact shadow). ## 9. Mood / weather shot (rainy night, snowy morning, foggy dawn) 1. Scene at real scale with a camera. QA the hero assets first (wet reflections and snow expose z-fighting and gaps). 2. `scene_mood.py --time night --fog-visibility 250` (or `--mood cyberpunk|horror|underwater|desert`). Add practical lights (street, windows, neon) at real color temperatures. 3. Weather: `precipitation.py --type rain --intensity heavy --ground <ground/roofs>` → `surface_weather.py --objects <surfaces> --wetness 0.7 --puddles 0.4 --ripples 1 --streaks 0.5` → `lightning.py --flashes 2`. Snow: `--type snow` + `--snow 0.8 --snow-depth 0.06`. 4. Gate: `render_batch.py --preset preview --frames <mid>,<flash>` at the final aspect ratio. Rain must read (backlit), puddles must reflect a light, the night must keep contrast. Then render the full loop (frame range = the precipitation loop).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.