Skip to content

elithril/blender-kiln / plugin

Makes and fixes 3D assets in Blender, for games, the web and AR. Use when the user wants a 3D model, prop, character or GLB/glTF/FBX/USDZ file made — from a text brief, a reference image, a free marketplace (PolyHaven, Sketchfab) or AI generation — AND when they bring an existing 3D file to fix: too heavy or too many polygons (optimize, compress, LODs), broken normals, scale or origin, materials lost on glTF export, conversion between GLB, FBX and USDZ, texturing, rigging for animation, animating it (walk and idle cycles, text-to-motion, looping clips, articulated props), or inspection. Drives Blender through a Blender MCP server (ahujasid's or the official Blender Lab one). Batch mode produces many consistent assets unattended. Kiln Studio (`/kiln studio`) opens the project's models in the browser, where the user reviews them and pins notes for Claude to act on.

FileKindSize
.claude-plugin/plugin.jsonconfig1.2 KB
.mcp.jsonconfig236 B
LICENSEother1.0 KB
NOTICEother2.5 KB
SKILL.mdskill md29.0 KB
references/ai-generation.mdmarkdown21.0 KB
references/animation.mdmarkdown21.6 KB
references/batch-mode.mdmarkdown19.5 KB
references/blender-mcp.mdmarkdown9.4 KB
references/characters.mdmarkdown52.8 KB
references/cli-tools.mdmarkdown6.5 KB
references/commands.mdmarkdown10.7 KB
references/export-targets.mdmarkdown14.3 KB
references/log-format.mdmarkdown2.2 KB
references/naming-conventions.mdmarkdown5.8 KB
references/photo-projection.mdmarkdown6.3 KB
references/pipeline-brief.mdmarkdown4.2 KB
references/pipeline-import-cleanup.mdmarkdown6.3 KB
references/pipeline-optimize-export.mdmarkdown6.4 KB
references/pipeline-rig-animate.mdmarkdown5.8 KB
references/pipeline-source.mdmarkdown9.7 KB
references/print.mdmarkdown41.5 KB
references/reference-fidelity.mdmarkdown31.8 KB
references/review-rounds.mdmarkdown10.4 KB
references/setup-install.mdmarkdown2.8 KB
references/setup.mdmarkdown9.2 KB
references/sourcing-strategy.mdmarkdown6.1 KB
references/studio.mdmarkdown38.9 KB
references/texturing-strategy.mdmarkdown14.4 KB
references/topology-rules.mdmarkdown3.9 KB
references/uv-materials.mdmarkdown6.8 KB
references/validation-checklist.mdmarkdown10.5 KB
studio/approval_hook.pyscript14.2 KB
studio/blender_live.pyscript2.3 KB
studio/checks.pyscript38.1 KB
studio/estimate.pyscript4.2 KB
studio/example/barrel/barrel_final.glbbinary111.9 KB
studio/example/barrel/barrel_log.mdmarkdown445 B
studio/handoff.pyscript17.8 KB
studio/mcp_server.pyscript32.7 KB
studio/phoneshare.pyscript17.1 KB
studio/server.pyscript47.9 KB
studio/setup_status.pyscript7.5 KB
studio/static/app.jsscript241.4 KB
studio/static/apple-touch-icon.pngbinary20.6 KB
studio/static/fonts/OFL-JetBrainsMono.txtmarkdown4.3 KB
studio/static/fonts/OFL-Sora.txtmarkdown4.3 KB
studio/static/fonts/jetbrains-mono-latin-ext.woff2binary11.3 KB
studio/static/fonts/jetbrains-mono-latin.woff2binary30.6 KB
studio/static/fonts/sora-latin-ext.woff2binary11.8 KB
studio/static/fonts/sora-latin.woff2binary24.6 KB
studio/static/i18n.jsscript6.2 KB
studio/static/i18n/fr.jsonconfig101.2 KB
studio/static/icon-32.pngbinary2.6 KB
studio/static/icon-64.pngbinary6.6 KB
studio/static/icon-96.pngbinary12.8 KB
studio/static/index.htmlother39.5 KB
studio/static/style.cssother114.5 KB
studio/static/tutorial.jsscript49.0 KB
studio/static/tutorial/barrel_after.glbbinary117.3 KB
studio/static/tutorial/barrel_before.glbbinary111.9 KB
studio/static/tutorial/fixtures.jsonconfig13.5 KB
studio/static/tutorial/lantern_1_blockout.glbbinary83.1 KB
studio/static/tutorial/lantern_2_details.glbbinary101.8 KB
studio/static/tutorial/lantern_3_materials.glbbinary102.0 KB
studio/static/tutorial/lantern_4_final.glbbinary141.1 KB
studio/static/tutorial/make_tutorial.pyscript4.9 KB
studio/static/viewer.jsscript41.4 KB
studio/studio.pyscript29.2 KB
studio/studiolib.pyscript77.8 KB
studio/test_studio.pyscript90.2 KB
studio/test_worker.pyscript31.5 KB
studio/worker.pyscript56.8 KB
studio/worker_blender.pyscript2.7 KB
tools/autorig.pyscript44.1 KB
tools/bind_rigid_parts.pyscript3.6 KB
tools/blender_mcp_start.pyscript1.5 KB
tools/check_usdz.pyscript1004 B
tools/cutout.swiftscript2.0 KB
tools/export_outputs.pyscript5.2 KB
tools/fidelity_check.pyscript39.0 KB
tools/fit_coupon.pyscript11.3 KB
tools/fixtures/skintokens_raw_child.glbbinary88.8 KB
tools/fixtures/skintokens_skeletons.jsonconfig6.5 KB
tools/flatten.pyscript14.9 KB
tools/glb_to_fbx.pyscript2.1 KB
tools/glb_to_usdz.pyscript6.2 KB
tools/motion_loop.pyscript5.9 KB
tools/motion_measure.pyscript15.2 KB
tools/motions/LICENSE-image-to-3dlab.txtmarkdown11.1 KB
tools/motions/cheer.npzbinary48.4 KB
tools/motions/cheer_b.npzbinary48.1 KB
tools/motions/dance.npzbinary78.2 KB
tools/motions/dance_b.npzbinary78.9 KB
tools/motions/death.npzbinary45.9 KB
tools/motions/death_b.npzbinary46.5 KB
tools/motions/fight_stance.npzbinary60.3 KB
tools/motions/fight_stance_b.npzbinary61.3 KB
tools/motions/flying_kick.npzbinary39.7 KB
tools/motions/flying_kick_b.npzbinary39.9 KB
tools/motions/hit_react.npzbinary31.9 KB
tools/motions/hit_react_b.npzbinary31.8 KB
tools/motions/idle.npzbinary51.8 KB
tools/motions/idle_b.npzbinary57.7 KB
tools/motions/jump.npzbinary39.8 KB
tools/motions/jump_b.npzbinary39.9 KB
tools/motions/kata.npzbinary77.4 KB
tools/motions/kata_b.npzbinary75.3 KB
tools/motions/kick.npzbinary32.4 KB
tools/motions/kick_b.npzbinary32.5 KB
tools/motions/presets.jsonconfig9.6 KB
tools/motions/punch.npzbinary32.0 KB
tools/motions/punch_b.npzbinary32.1 KB
tools/motions/punch_combo.npzbinary47.4 KB
tools/motions/punch_combo_b.npzbinary47.5 KB
tools/motions/roll.npzbinary46.7 KB
tools/motions/roll_b.npzbinary47.5 KB
tools/motions/roundhouse.npzbinary39.7 KB
tools/motions/roundhouse_b.npzbinary39.9 KB
tools/motions/run.npzbinary47.2 KB
tools/motions/run_b.npzbinary47.7 KB
tools/motions/sit.npzbinary47.2 KB
tools/motions/sit_b.npzbinary47.2 KB
tools/motions/sneak.npzbinary61.6 KB
tools/motions/sneak_b.npzbinary61.8 KB
tools/motions/strafe_left.npzbinary45.9 KB
tools/motions/strafe_left_b.npzbinary47.1 KB
tools/motions/sword_swing.npzbinary39.7 KB
tools/motions/sword_swing_b.npzbinary39.4 KB
tools/motions/walk.npzbinary62.8 KB
tools/motions/walk_b.npzbinary62.6 KB
tools/motions/walk_woman.npzbinary62.9 KB
tools/motions/wave.npzbinary46.3 KB
tools/motions/wave_b.npzbinary46.3 KB
tools/open_blender.pyscript5.0 KB
tools/photo_project.pyscript37.8 KB
tools/presets.pyscript16.3 KB
tools/print_check.pyscript47.2 KB
tools/quadruped.pyscript19.4 KB
tools/retarget.pyscript46.9 KB
tools/review_renders.pyscript13.8 KB
tools/review_sheet.pyscript11.0 KB
tools/skintokens-requirements.txtmarkdown2.4 KB
tools/skintokens.patchother9.2 KB
tools/template_profile.pyscript5.8 KB
tools/test_autorig.pyscript15.9 KB
tools/test_fidelity_check.pyscript20.7 KB
tools/test_fit_coupon.pyscript6.4 KB
tools/test_flatten.pyscript15.0 KB
tools/test_open_blender.pyscript1.3 KB
tools/test_photo_project.pyscript12.6 KB
tools/test_presets.pyscript17.6 KB
tools/test_print_check.pyscript33.1 KB
tools/test_review_renders.pyscript11.4 KB
tools/test_review_sheet.pyscript4.0 KB
tools/test_template_profile.pyscript3.6 KB
tools/test_uv_check.pyscript5.0 KB
tools/test_verify_docs.pyexecutablescript7.9 KB
tools/unimate.patchother3.5 KB
tools/unimate.pyscript17.5 KB
tools/uv_check.pyscript8.4 KB
tools/verify_blender.pyexecutablescript29.2 KB
tools/verify_docs.pyexecutablescript16.6 KB

references/naming-conventions.md

View on GitHub
# Naming Conventions Reference

> PascalCase + prefixes in Blender, kebab-case for web files.

---

## Contents
- Objects in Blender
- Materials
- Textures
- Collections in Blender
- Exported Files
- Output Folder Structure
- GLTF Name Mapping
- Applying Conventions via Python

## Objects in Blender

**Format:** `{Prefix}_{DescriptiveName}`

| Prefix | Type | Example |
|---|---|---|
| `SM_` | Static Mesh | `SM_WoodenChair`, `SM_Rock_Large` |
| `SK_` | Skeletal Mesh | `SK_CharacterHero` |
| `A_` | Animation | `A_Character_Run` |

**Parts:** `SM_WoodenChair_Leg_01`, `SM_WoodenChair_Seat`
**Variants:** `SM_WoodenChair_01`, `SM_WoodenChair_02`
**LODs:** `SM_WoodenChair_LOD0`, `SM_WoodenChair_LOD1`

**Rules:**
- PascalCase always
- No spaces, no special characters, no accents
- Object name and mesh data-block must match: `SM_WoodenChair` / `SM_WoodenChair_Mesh`

---

## Materials

**Format:** `M_{MaterialType}_{Variant}`

```
M_Wood_Oak
M_Wood_Oak_Weathered
M_Metal_RustedSteel
M_Fabric_Leather_Brown
M_Stone_Cobblestone
```

---

## Textures

**Format:** `T_{AssetName}_{MapSuffix}`

| Suffix | Map type |
|---|---|
| `_D` or `_BaseColor` | Albedo / Diffuse |
| `_N` | Normal Map |
| `_R` | Roughness |
| `_M` | Metallic |
| `_AO` | Ambient Occlusion |
| `_ORM` | Packed: Occlusion / Roughness / Metallic |
| `_E` | Emissive |
| `_H` | Height / Displacement |

```
T_Wood_Oak_D.png
T_Wood_Oak_N.png
T_Wood_Oak_ORM.png
```

**Texture rules:**
- Always power of 2 (256, 512, 1024, 2048, 4096)
- Non-color data (Normal, Roughness, Metallic, AO) → set colorspace to "Non-Color" in Blender

---

## Collections in Blender

```
Props_Medieval
Characters_NPC
Environment_Forest
Lighting_Studio
```

---

## Exported Files

| Target | Convention | Example |
|---|---|---|
| glTF / web | kebab-case | `wooden-chair.glb` |
| FBX / game engine | PascalCase + prefix | `SM_WoodenChair.fbx` |
| USDZ / AR | kebab-case | `wooden-chair.usdz` |
| STL / print | kebab-case, `_{part}` per printed part — the part's name in the brief's language is fine; files go straight into the output folder the user gave | `dutch-windmill_body.stl`, `christmas-tree_etoile.stl` |
| Print reference | the parts before the union, one per printed part | `dutch-windmill_body_parts.blend` |
| Print test piece | in `test/`, `test_{what}.stl` — a coupon, a ring cut to try a mechanism | `test/test_lid-ring.stl` |

---

## Output Folder Structure

```
generated-assets/
└── wooden-chair/                    (kebab-case)
    ├── wooden-chair_original.glb
    ├── wooden-chair_clean.glb
    ├── wooden-chair_textured.glb
    ├── wooden-chair_optimized.glb
    ├── wooden-chair_preview.glb     (a copy of _original.glb: opens in macOS Quick Look)
    ├── wooden-chair.blend
    ├── wooden-chair_log.md
    ├── web/    wooden-chair_final.glb                         (output: a website)
    ├── game/   wooden-chair_game.fbx                          (output: Unity, Unreal)
    ├── ar/     wooden-chair_ar.usdz, wooden-chair_ar.glb      (output: iPhone and Vision Pro, Android)
    └── print/  wooden-chair_print.3mf, wooden-chair_print_seat.stl, …   (output: 3D printing)
```

**Outputs** — one model, a folder per use; the source (the stages, the `.blend`, the log,
the preview) stays at the root. A folder is made when its output is asked for, never empty.
Kiln Studio's Outputs bar finds them by these names and offers to prepare the missing ones
(a `_final.glb` at the root, from before, still counts as the web output):

| Output | Files | How |
|---|---|---|
| Web | `web/{name}_final.glb` | the web target (Draco, WebP) |
| Game | `game/{name}_game.fbx` | `references/export-targets.md` § FBX, from the same scene |
| AR | `ar/{name}_ar.usdz` + `ar/{name}_ar.glb` | `bpy.ops.wm.usd_export(filepath=…usdz)` and the glTF exporter (no Draco: Android's viewer has none), from the same scene |
| 3D print | `print/{name}_print.3mf` + `print/{name}_print_{part}.stl` | print mode (`references/print.md`), then the 3MF below |

The 3MF gathers the checked STLs, as on the bed, in millimetres — PrusaSlicer's command line,
**run from the print folder** (a path in `-o` or no `--dont-arrange`: no file, and still
exit 0):

```bash
cd generated-assets/wooden-chair/print
/Applications/PrusaSlicer.app/Contents/MacOS/PrusaSlicer -m --dont-arrange --export-3mf \
    -o wooden-chair_print.3mf wooden-chair_print_seat.stl wooden-chair_print_legs.stl
```

No PrusaSlicer: the STLs alone, and the report says the 3MF is missing.

---

## GLTF Name Mapping

Blender names are **transformed** on GLTF export. Important for runtime code that references meshes by name.

| Transformation | Blender | GLTF |
|---|---|---|
| Spaces → underscores | `RINGS ball L` | `RINGS_ball_L` |
| Dots → removed | `Sphere.003` | `Sphere003` |
| Combined | `RINGS L.001` | `RINGS_L001` |
| Trailing space | `RINGS S ` | `RINGS_S_` |

**Rule:** Always verify names in the exported GLB (via `gltf-transform inspect`), not in Blender, when runtime code references meshes.

**Verification script:**
```python
import bpy
for obj in bpy.data.objects:
    gltf_name = obj.name.replace(" ", "_").replace(".", "")
    if gltf_name != obj.name:
        print(f"⚠️ '{obj.name}' → '{gltf_name}' in GLTF")
```

---

## Applying Conventions via Python

```python
import bpy

def apply_naming(obj, asset_name, prefix="SM"):
    """Rename object and mesh data to convention."""
    obj.name = f"{prefix}_{asset_name}"
    if obj.data:
        obj.data.name = f"{prefix}_{asset_name}_Mesh"
    
    # Rename materials
    for i, slot in enumerate(obj.material_slots):
        if slot.material and not slot.material.name.startswith("M_"):
            slot.material.name = f"M_{slot.material.name}"

# Example
obj = bpy.context.active_object
apply_naming(obj, "WoodenChair")
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall