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/test_fit_coupon.py

View on GitHub
#!/usr/bin/env python3
"""Check fit_coupon.py writes what it says.

    python3 tools/test_fit_coupon.py      # needs Blender at $BLENDER or the macOS default

- the defaults: exit 0, two STLs, holes 4.2 / 4.4 / 4.6 mm and a fourth at 4.4 with a 0.5 mm
  lead-in (5.4 mm on the bed face), the peg 4.0 mm and 4.5 mm long — each read back from
  the STL, not from the tool's own report;
- both parts are one closed solid, the plate is --depth-mm thick and lies on Z = 0;
- other values (a 6 mm peg, one clearance, no chamfer): one hole, 6.3 mm, no lead-in;
- a negative clearance: refused, exit 1, nothing written;
- --shape round, an 8 mm peg 6 mm deep: holes 8.2 / 8.4 / 8.6 mm across the flats and 8.4
  with the lead-in (9.4 on the bed face), the peg standing on its base, 8.0 mm at its corners
  and 7 mm long — read back from the STLs.
"""
import json, math, os, struct, subprocess, sys, tempfile

BLENDER = os.environ.get("BLENDER", "/Applications/Blender.app/Contents/MacOS/Blender")
TOOL = os.path.join(os.path.dirname(os.path.abspath(__file__)), "fit_coupon.py")


def read(path):
    data = open(path, "rb").read()
    n = struct.unpack("<I", data[80:84])[0]
    return [[struct.unpack("<3f", data[84 + 50 * k + 12 + 12 * i: 84 + 50 * k + 24 + 12 * i]) for i in range(3)]
            for k in range(n)]


def run(out, *extra):
    p = subprocess.run([BLENDER, "-b", "--factory-startup", "--python-exit-code", "1", "--python", TOOL, "--",
                        "--out", out, "--json", f"{out}/r.json", *extra], capture_output=True, text=True)
    r = json.load(open(f"{out}/r.json")) if os.path.exists(f"{out}/r.json") else None
    return p.returncode, r, p.stdout + p.stderr


def closed(tris):
    """Every edge in exactly two triangles, walked once each way: one closed, coherent shell."""
    q = lambda p: tuple(round(c, 4) for c in p)
    half = {}
    for t in tris:
        for i in range(3):
            e = (q(t[i]), q(t[(i + 1) % 3]))
            half[e] = half.get(e, 0) + 1
    return all(v == 1 and half.get((b, a)) == 1 for (a, b), v in half.items())


def hole_side(tris, x, y, z, reach):
    """The diamond hole's side where a plane at height z cuts the plate, round centre (x, y)."""
    best = 0.0
    for t in tris:
        for i in range(3):
            a, b = t[i], t[(i + 1) % 3]
            if (a[2] - z) * (b[2] - z) < 0:
                s = (z - a[2]) / (b[2] - a[2])
                d = abs(a[0] + (b[0] - a[0]) * s - x) + abs(a[1] + (b[1] - a[1]) * s - y)
                if best < d < reach:
                    best = d
    return best * math.sqrt(2)


checks = []
def check(name, ok, got=""):
    checks.append(bool(ok))
    print(f"  {'ok  ' if ok else 'FAIL'} {name}" + ("" if ok else f"   got: {got}"))


with tempfile.TemporaryDirectory() as d:
    # 1. defaults
    rc, r, log = run(f"{d}/a")
    check("defaults: exit 0, a report", rc == 0 and r is not None, (rc, log[-300:]))
    plate = read(f"{d}/a/fit_holes.stl") if rc == 0 else []
    peg = read(f"{d}/a/fit_peg.stl") if rc == 0 else []
    check("plate: one closed shell", plate and closed(plate))
    check("peg: one closed shell", peg and closed(peg))
    zs = [p[2] for t in plate for p in t]
    check("plate: on Z = 0, 3.5 mm thick", zs and abs(min(zs)) < 1e-4 and abs(max(zs) - 3.5) < 1e-4,
          zs and (min(zs), max(zs)))
    if r:
        want = [(4.2, 4.2), (4.4, 4.4), (4.6, 4.6), (4.4, 5.4)]
        for i, (mid, bed) in enumerate(want):
            x, y = r["holes"][i]["centre_mm"]                     # where it is from the report, its size from the STL
            m, b = hole_side(plate, x, y, 1.75, 6), hole_side(plate, x, y, 0.001, 6)
            check(f"hole {i + 1}: {mid} mm through, {bed} mm on the bed face", abs(m - mid) < 2e-3 and abs(b - bed) < 5e-3,
                  (round(m, 4), round(b, 4)))
    tip = [p for t in peg for p in t if p[1] < -1e-4]
    if tip:
        side = (max(p[2] for p in tip) - min(p[2] for p in tip)) / math.sqrt(2)
        check("peg: 4.0 mm, 4.5 mm long, its lower corner above the bed",
              abs(side - 4.0) < 1e-3 and abs(-min(p[1] for p in tip) - 4.5) < 1e-3 and min(p[2] for p in tip) > 1,
              (round(side, 4), min(p[1] for p in tip)))
    else:
        check("peg: sticks out", False)

    # 2. other values
    rc, r, log = run(f"{d}/b", "--peg-mm", "6", "--clear-mm", "0.15", "--chamfer-mm", "0")
    check("6 mm peg, one clearance, no chamfer: one hole of 6.3 mm",
          rc == 0 and len(r["holes"]) == 1 and r["holes"][0]["side_mm"] == 6.3
          and abs(r["holes"][0]["measured_bed_side_mm"] - 6.3) < 1e-3, (rc, r and r["holes"], log[-200:]))

    # 2b. round, standing up
    rc, r, log = run(f"{d}/r", "--shape", "round", "--peg-mm", "8", "--depth-mm", "6")
    check("round: exit 0, a report", rc == 0 and r is not None and r.get("shape") == "round", (rc, log[-300:]))
    if rc == 0:
        plate, peg = read(f"{d}/r/fit_holes.stl"), read(f"{d}/r/fit_peg.stl")
        check("round: plate and peg closed shells", closed(plate) and closed(peg))
        cos = math.cos(math.pi / 64)
        def across(tris, x, y, z):
            best = 0.0
            for t in tris:
                for i in range(3):
                    a, b = t[i], t[(i + 1) % 3]
                    if (a[2] - z) * (b[2] - z) < 0:
                        s_ = (z - a[2]) / (b[2] - a[2])
                        dd = math.hypot(a[0] + (b[0] - a[0]) * s_ - x, a[1] + (b[1] - a[1]) * s_ - y)
                        if best < dd < 6:
                            best = dd
            return 2 * best * cos
        for i, (mid, bed) in enumerate([(8.2, 8.2), (8.4, 8.4), (8.6, 8.6), (8.4, 9.4)]):
            x, y = r["holes"][i]["centre_mm"]
            m, b = across(plate, x, y, 3.0), across(plate, x, y, 0.001)
            check(f"round hole {i + 1}: {mid} mm across the flats, {bed} on the bed face",
                  abs(m - mid) < 2e-3 and abs(b - bed) < 1e-2, (round(m, 4), round(b, 4)))
        top = [p for t in peg for p in t if p[2] > 2.0 + 1e-4]
        dia = 2 * max(math.hypot(p[0], p[1]) for p in top)
        check("round peg: 8.0 mm at its corners, 7 mm above its 2 mm base",
              abs(dia - 8.0) < 2e-3 and abs(max(p[2] for p in top) - 9.0) < 1e-3, (round(dia, 4), max(p[2] for p in top)))

    # 3. refused
    rc, r, log = run(f"{d}/c", "--clear-mm", "-0.1")
    check("negative clearance: exit 1, nothing written", rc == 1 and not os.path.exists(f"{d}/c/fit_holes.stl"),
          (rc, log[-200:]))

print(f"\n{sum(checks)}/{len(checks)}")
sys.exit(0 if all(checks) else 1)
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