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

tools/export_outputs.py

View on GitHub
#!/usr/bin/env python3
"""A model's game and AR outputs, without Claude: kiln's settings, Blender headless, checked.

    python3 tools/export_outputs.py <model folder> game ar [--blender PATH]

From the model's `_original.glb` (the uncompressed export of its source):
- game: game/<name>_game.fbx (tools/glb_to_fbx.py), read back: its size must match the GLB's;
- ar:   ar/<name>_ar.glb — the _original as it is (uncompressed, PNG: Scene Viewer's; its
        finishes and animations kept) — and ar/<name>_ar.usdz (tools/glb_to_usdz.py: vertex
        colours baked, WebP to PNG, Y up, the animation), passed by usdchecker --arkit.

Each file is written beside, then moved into place only once its check passed: a failed
export leaves nothing behind. The model's log gets a line per output. Prints one JSON
object: {"ok": bool, "outputs": {kind: {files, checks}}, "error": str}. Exit 1 on failure.
Studio runs it for "+ Game" and "+ AR"; print stays with Claude (print_check, parts).
"""
from __future__ import annotations

import argparse
import json
import os
import shutil
import subprocess
import sys
import tempfile
import time
from pathlib import Path

HERE = Path(__file__).resolve().parent


def find_blender(given: str | None) -> str | None:
    for c in (given, os.environ.get("BLENDER"), "/Applications/Blender.app/Contents/MacOS/Blender",
              str(Path.home() / "Applications/Blender.app/Contents/MacOS/Blender"), shutil.which("blender")):
        if c and Path(c).exists():
            return c
    return None


def blender_run(blender: str, script: str, *args: str) -> list[str]:
    r = subprocess.run([blender, "-b", "--factory-startup", "--python", str(HERE / script), "--", *args],
                       capture_output=True, text=True, timeout=900)
    lines = [l for l in r.stdout.splitlines() if l.split(" ", 1)[0] in ("DIMS", "FBX", "USDZ", "FAILED", "ARKIT", "ANIM")]
    if r.returncode != 0 or any(l.startswith("FAILED") for l in lines):
        raise RuntimeError(next((l for l in lines if l.startswith("FAILED")), f"{script}: Blender exited {r.returncode}"))
    return lines


def game(blender: str, d: Path, name: str, src: Path, tmp: Path) -> dict:
    out = tmp / f"{name}_game.fbx"
    lines = blender_run(blender, "glb_to_fbx.py", str(src), str(out))
    dims = {l.split()[1]: [float(x) for x in l.split()[2:5]] for l in lines if l.startswith("DIMS")}
    g, f = dims.get("glb"), dims.get("fbx")
    if not g or not f or any(abs(a - b) > max(0.02 * max(g), 1e-3) for a, b in zip(sorted(g), sorted(f))):
        raise RuntimeError(f"the FBX read back is not the model's size: {f} m against {g} m")
    (d / "game").mkdir(exist_ok=True)
    final = d / "game" / out.name
    shutil.move(out, final)
    return {"files": [str(final)], "checks": f"read back {' × '.join(f'{x:.3f}' for x in f)} m, as the GLB"}


def ar(blender: str, d: Path, name: str, src: Path, tmp: Path) -> dict:
    usdz = tmp / f"{name}_ar.usdz"
    lines = blender_run(blender, "glb_to_usdz.py", str(src), str(usdz))
    baked = next((l for l in lines if l.startswith("USDZ")), "")
    check = blender_run(blender, "check_usdz.py", str(usdz))
    fails = [l[len("ARKIT FAIL "):] for l in check if l.startswith("ARKIT FAIL")]
    if fails:
        raise RuntimeError("the USDZ fails the ARKit check: " + "; ".join(fails[:3]))
    anim = next((l for l in check if l.startswith("ANIM")), None)
    (d / "ar").mkdir(exist_ok=True)
    glb = d / "ar" / f"{name}_ar.glb"
    shutil.copy2(src, glb)
    final = d / "ar" / usdz.name
    shutil.move(usdz, final)
    note = "usdchecker --arkit clean" + (f", animated (frames {anim.split()[1]}–{anim.split()[2]})" if anim else "")
    if "baked on 0" not in baked and "baked on" in baked:
        note += ", vertex colours baked"
    return {"files": [str(glb), str(final)], "checks": note}


def main() -> int:
    ap = argparse.ArgumentParser(description=__doc__.splitlines()[0])
    ap.add_argument("folder")
    ap.add_argument("kinds", nargs="+", choices=["game", "ar"])
    ap.add_argument("--blender")
    a = ap.parse_args()
    d = Path(a.folder).resolve()
    name = d.name
    src = d / f"{name}_original.glb"
    out = {"ok": False, "outputs": {}, "error": ""}
    blender = find_blender(a.blender)
    try:
        if not src.is_file():
            raise RuntimeError(f"no {src.name}: export the model's source first")
        if not blender:
            raise RuntimeError("Blender not found (install it, or set $BLENDER)")
        with tempfile.TemporaryDirectory(dir=d, prefix=".export-") as t:
            for k in a.kinds:
                out["outputs"][k] = (game if k == "game" else ar)(blender, d, name, src, Path(t))
        log = d / f"{name}_log.md"
        lines = [f"\n## Outputs (Studio, {time.strftime('%Y-%m-%d')})"]
        for k, r in out["outputs"].items():
            files = ", ".join(str(Path(f).relative_to(d)) for f in r["files"])
            lines.append(f"- {files}: kiln's settings, tools/export_outputs.py from {src.name} — {r['checks']}")
        with log.open("a") as f:
            f.write("\n".join(lines) + "\n")
        out["ok"] = True
    except (RuntimeError, OSError, subprocess.TimeoutExpired) as e:
        out["error"] = str(e)
    print(json.dumps(out))
    return 0 if out["ok"] else 1


if __name__ == "__main__":
    sys.exit(main())
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 CodeCodexVerifiedInstall
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