elithril/blender-kiln / plugin
kiln
FlaggedMakes 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.
references/sourcing-strategy.md
View on GitHub# Sourcing Strategy Reference
## Contents
- Preflight — rule 23, before the first search
- Overview
- PolyHaven
- Without the MCP integration — the public API
- Search flow
- Sketchfab
- Search flow
- License awareness
- Search Result Presentation
- Link Opening
- Refinement Loop
- After download — rules 24 and 25
## Preflight — rule 23, before the first search
```
get_addon_status() → "libraries": {"polyhaven": "on" | "off", "sketchfab": …, "polypizza": …}
```
The libraries are **OFF in a default addon install**. On `mcp-for-blender` 2.1.9 and later,
`search_assets` on one that is off answers with the fix — the MCP for Blender panel in the 3D
Viewport sidebar (press N if hidden), and the box to tick: print it verbatim, then offer another
source or the creation path.
Older servers (`get_polyhaven_status()` exists): call `get_polyhaven_status()` /
`get_sketchfab_status()` first. While an integration is off, the addon does not register
`search_polyhaven_assets` / `search_sketchfab_models` at all, so calling them returns
`Unknown command type: <name>` — which looks like a version mismatch and sends the user
hunting for the wrong problem. If `enabled` is false, print the `message` field verbatim.
Never surface `Unknown command type` to the user.
## Overview
Search existing marketplaces before generating. Present ~10 results with links. Iterate until user finds what they need or switches to creation.
## PolyHaven
- Fully free, CC0 (public domain)
- No authentication needed
- Types: HDRIs, textures, 3D models
- MCP tools: `search_assets(source="polyhaven")`, `import_asset(source="polyhaven")` (older servers: `search_polyhaven_assets`, `download_polyhaven_asset`, `set_texture`, `get_polyhaven_categories`)
- Categories: wood, metal, rock, fabric, brick, plaster, terrain, floor, roofing, aerial
### Without the MCP integration — the public API
On the official Blender Lab MCP, or with the integration off, go to PolyHaven's
public API from Bash. No key, CC0 assets. Verified 2026-09-29:
```bash
UA="blender-kiln" # ToS 2.4: a unique User-Agent, always
curl -s -A "$UA" "https://api.polyhaven.com/assets?type=models&categories=furniture" # {id: {name, categories, ...}}
curl -s -A "$UA" "https://api.polyhaven.com/files/WoodenChair_01" # per format, per resolution
```
`files/<id>` → `gltf` → `1k` / `2k` / `4k` → `gltf` gives the `.gltf` URL and an
`include` map of its textures and `.bin`; download every entry into the same
relative layout, then import the `.gltf`. **Download `1k` for a web/glTF target**,
the default — the cap in `references/uv-materials.md` § Texture Resolution per Use
Case. `2k` only for close-ups or a console/PC target. Measured on the same
724-triangle chair: 16.2 MB from 2K maps uncompressed, 1.03 MB from 2K in WebP,
0.48 MB from 1K uncompressed.
**Terms of Service** (`Poly-Haven/Public-API`, `ToS.md`): the assets are CC0 and
need no attribution, but using the *live API* requires a unique User-Agent (2.4)
and a visible credit to Poly Haven for the content (2.5). Write
`Source: Poly Haven (polyhaven.com), via the public API` in the asset log (rule 17).
### Search flow
1. Extract keywords from brief (material, style, era)
2. `search_assets(source="polyhaven", query=…)` (older: `search_polyhaven_assets`) — or the API above when the MCP has no PolyHaven tools
3. Present results with name, type, link
4. Links format: `https://polyhaven.com/a/{asset_name}`
## Sketchfab
- Mix of free and paid models
- REQUIRES API token for downloads (free account)
- Token setup: https://sketchfab.com/settings/password → "API Token"
- MCP tools: `search_assets(source="sketchfab", previews=N)`, `import_asset(source="sketchfab", target_size=…)` (older servers: `search_sketchfab_models`, `get_sketchfab_model_preview`, `download_sketchfab_model`)
### Search flow
1. `search_assets(source="sketchfab", query=…, limit=10)` (older: `search_sketchfab_models` with downloadable=true, count=10)
2. Filter results for free/downloadable only
3. Present results with: name, poly count, link, license
4. Links format: `https://sketchfab.com/3d-models/{slug}-{uid}`
5. `import_asset(source="sketchfab", id=<uid>, target_size=…)` — required there: library models come at arbitrary scale (older: `download_sketchfab_model` with target_size)
### License awareness
- PolyHaven: always CC0, no attribution needed
- Sketchfab licenses vary: CC0, CC-BY, CC-BY-SA, CC-BY-NC, etc.
- ALWAYS log the license in the asset log
- ALERT if license requires attribution (CC-BY, CC-BY-SA)
- NEVER download CC-BY-NC assets for commercial projects without user confirmation
## Search Result Presentation
```
Results for "medieval wooden chair":
1. Old Wooden Chair — 2.3K tris — polyhaven.com/a/old_wooden_chair (CC0)
2. Medieval Chair — 4.1K tris — sketchfab.com/3d-models/xxx (CC-BY 4.0)
3. ...
10. Rustic Stool — 1.8K tris — polyhaven.com/a/rustic_stool (CC0)
Open links? (number, "all", or refine search)
```
## Link Opening
- `auto_open_links=false` by default
- User can: "open 2, 5, 7" → opens specific links
- User can: "open all" → opens all 10 links
- macOS: `open "https://..."` via Bash
- Can toggle auto_open_links mid-session
## Refinement Loop
When results don't match:
- User says "more rustic" / "try oak furniture" / "nothing works"
- Adjust keywords, re-search
- If nothing found after 2-3 iterations → propose switching to creation
## After download — rules 24 and 25
A PolyHaven or Sketchfab import arrives under the source file's own name
(`ClassicNightstand_01`), not the project convention. Two things before anything
downstream reads it:
```
get_scene_info(fields=["size"]) → world bounding box, to verify 1 unit = 1 m (rule 24; older servers: get_object_info(name))
rename → SM_PascalCase + SM_..._Mesh data-block (rule 25)
```
**Scale is usually right, but check it anyway.** PolyHaven reports dimensions in
millimetres in its search results (`568 x 424 x 700` for a nightstand) while the
importer converts to metres, so a correct import measures `0.568 x 0.424 x 0.7`.
Verified against the live API. A raw 568-unit object means the conversion did not
happen.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |