Skip to content

Commit 2074b03

Browse files
TMHSDigitalclaude
andcommitted
feat(showcase): add boulder-cluster (nature)
The third piece in the nature category: a cluster of glacial erratics sunk into a soil mound. Four boulders of clearly different sizes, each an ellipsoid cut by closed-form cleavage planes whose meeting edges are rounded by a weathering bevel (a soft minimum in the radial field), with seeded corner chips and a seeded sum of waves: a 1.7 m speckled granite block; a banded sandstone boulder split in two, its halves 75 mm apart with matching crack faces and bedding bands that run straight across the gap; a 0.95 m granite boulder carrying a 0.6 m sandstone slab resting flat on its top. 26 lichen crusts and 8 moss cushions on the tops and north faces; 32 grass tufts (one in the crack), 36 pebbles and 14 wildflowers in the gaps and round the bases. Eight materials: granite, sandstone, lichen, moss, grass, soil, gravel, flower; Cavity and Strata point attributes drive crevice darkening, edge wear and the bands. Blender: E:\Blender-Developer-Tools\.scratch\5.2\blender-5.2.1-windows-x64\blender.exe reports "Blender 5.2.1 LTS". 4.5 LTS and 5.1 are left to CI (not run locally). Recomputed budgets (5.2.1): - 40244 tris (band 39600-40900); LOD1 0.5000, LOD2 0.2200 - 8 materials: granite 4440, sandstone 3798, lichen 2184, moss 1760, grass 5251, soil 2734, gravel 1944, flower 1400 faces - UVs in 0..1, overlap 0; AABB 4.4442 x 3.2153 x 1.3657 m, zmin 0 - collider 292 tris (ceiling 320); bake FINISHED; glTF 3064548 B - hygiene all 0, zero coplanar cross-shell pairs (drafts measured 14, then 5, then 1: crusts laid on the smooth field sat on the rock mesh's chords, so every crust and cushion point is now snapped to the built rock; bedding ledges fade out on sandstone tops and growth there keeps to tops; crusts are even skins parallel to the faces under them, with thickness and bite staggered 0.5 mm apart) - embedding: every boulder buried in all eight flank sectors, shallowest 0.0686 m (floor 0.030), deepest vertex 0.1488 m (cap 0.30) - slab seated 0.0100 m into its support (band 0.004-0.030); mass centre 0.1571 m inside its 263-vertex footprint (floor 0.03) - split: crack faces 1.00 deg apart (cap 3), gap 0.0775 m (band 0.050-0.100), slide 0.0092 m (cap 0.05), areas 0.747 / 0.729 m2 - growth: 0.9614 of lichen and moss top area faces up or north (floor 0.85) - ground cover: 497 shells, 0 loose (a blade once measured 16 mm off the soil: the two BVH trees split non-planar soil quads on different diagonals; soil cells are now triangulated on the short diagonal) - two default runs print identical measurements Falsifiers (flag -> measured -> exit): - --skip-decimate -> LOD1 ratio 1.0000 -> 9 - --stray-vert -> loose_v 1 -> 15 - --lift-z -> zmin 0.05000 -> 16 - --perch-boulder -> front boulder shallowest sector -0.0151 m -> 17 - --float-slab -> slab deepest vertex -0.0100 m -> 18 - --perch-slab -> centroid 0.1170 m outside its footprint -> 19 - --skew-half -> crack faces 6.647 deg apart -> 20 - --sunny-lichen -> 0.6243 up/north -> 21 - --float-cover -> 475 of 497 cover shells loose -> 22 Tris and AABB identical to the default under every falsifier; every earlier budget green in each run. Render: render_hero.py wrote hero and preview. Framing fill x 0.797, y 0.800, margins >= 0.041. Asset-quality floors pass (edge90 0.037); a violation remaps to exit 23. Asset sheet (docs/gallery/asset-sheets/boulder-cluster.webp): not the least-designed object in the lineup; the hydrant is plainer. Isolated it reads as faceted granite, a split banded block, a stacked slab, lichen, moss, grass, flowers and pebbles. Weak points: moss cushions read a little like felt patches, the grass is thin at sheet scale, and the front of the soil mound is sparse. Contact sheet: luma 0.2394 against calibration 0.2369-0.2428 (in band). Stage 0.2109 against 0.1919-0.2517 (in band). Wedge warmth +0.1097 against -0.1440/+0.1052/+0.0921 (warm, in spread). Saturation 0.2650 against 0.1525-0.2367: above the band (orange sandstone, lichen and turf). Thumbnail legibility good. The first render measured luma 0.2517; relit by lowering key, fill, rim and wedge, and the sandstone was desaturated. Also updated: README, CLAUDE.md and ROADMAP counts and entries, the asset_sheet.py SELECT row, catalog.json, plugin.json and the regenerated gallery. build_gallery, check_site_links (101 pages, 0 failures), check_falsifier_targets, check_exit_code_readme, check_engine_id, check_gallery_images and the count check all pass. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
1 parent b3cff26 commit 2074b03

60 files changed

Lines changed: 7911 additions & 100 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.cursor-plugin/plugin.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,7 @@
183183
"showcase/fallen-log",
184184
"showcase/office-chair",
185185
"showcase/hover-bike",
186-
"showcase/weight-rack"
186+
"showcase/weight-rack",
187+
"showcase/boulder-cluster"
187188
]
188189
}

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ rules/<rule-name>.mdc - Anti-pattern rules, 9 total
2222
templates/<template-name>/ - Starter projects, 3 total
2323
snippets/<snippet-name>.py - Standalone code patterns, 27 total
2424
examples/<name>/ - Runnable smoke-gated examples, 60 total (+ gallery.json)
25-
showcase/<name>/ - Budget-conformance props, 45 pieces, each with a gallery `category` (sibling of examples/; see showcase/README.md § Categories)
25+
showcase/<name>/ - Budget-conformance props, 46 pieces, each with a gallery `category` (sibling of examples/; see showcase/README.md § Categories)
2626
scripts/build_gallery.py - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json
2727
scripts/site/ - Vendored landing-page build (Jinja2); tokens.css is the shared palette
2828
tests/check_site_links.py - Internal link/anchor/alt gate over the built site (docs/)

‎README.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
</p>
1919

2020
<p align="center">
21-
<strong>16 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>3 templates</strong> &nbsp;&bull;&nbsp; <strong>27 snippets</strong> &nbsp;&bull;&nbsp; <strong>60 examples</strong> &nbsp;&bull;&nbsp; <strong>45 showcase pieces</strong>
21+
<strong>16 skills</strong> &nbsp;&bull;&nbsp; <strong>9 rules</strong> &nbsp;&bull;&nbsp; <strong>3 templates</strong> &nbsp;&bull;&nbsp; <strong>27 snippets</strong> &nbsp;&bull;&nbsp; <strong>60 examples</strong> &nbsp;&bull;&nbsp; <strong>46 showcase pieces</strong>
2222
</p>
2323

2424
<p align="center">
@@ -37,7 +37,7 @@
3737

3838
## Overview
3939

40-
This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 60 examples, and 45 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
40+
This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 60 examples, and 46 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
4141

4242
The content is consumed by AI coding agents reading these files directly from a checkout — **there is no MCP server in this repository, and none is required**. Cursor applies `rules/*.mdc` automatically wherever their scope globs match and takes skills by name in chat; Claude Code reads `skills/` and `rules/` from the project workspace, or from this repo kept as a referenced checkout. Any agent that can read files in a workspace can use it the same way. There is no build step for the content — edit the Markdown and Python files directly.
4343

@@ -106,7 +106,7 @@ per-script exit-code model, are in
106106
Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](showcase/README.md).
107107

108108
<details>
109-
<summary><strong>45 showcase pieces</strong> — click to expand the preview grid</summary>
109+
<summary><strong>46 showcase pieces</strong> — click to expand the preview grid</summary>
110110

111111
<p align="center">
112112
<a href="showcase/shipping-crate/"><img src="showcase/shipping-crate/preview.webp" width="24%" alt="Shipping crate: a wooden slat crate stencilled PORT ROYAL and NO 17, with iron corner brackets and an end handle, on a dark studio floor, warm wedge on the back wall" /></a>
@@ -154,6 +154,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
154154
<a href="showcase/office-chair/"><img src="showcase/office-chair/preview.webp" width="24%" alt="Office chair: a tangerine-upholstered mesh-back task chair with a headrest, T-arms, a chrome gas lift and a polished five-star base on twin-wheel casters, on a dark studio floor" /></a>
155155
<a href="showcase/hover-bike/"><img src="showcase/hover-bike/preview.webp" width="24%" alt="Hover bike: a teal sci-fi speeder with pearl racing stripes, a stitched black saddle, clip-on bars and two ducted fans with orange spinners, parked on landing skids, on a dark studio floor" /></a>
156156
<a href="showcase/weight-rack/"><img src="showcase/weight-rack/preview.webp" width="24%" alt="Weight rack: a red half rack holding a barbell loaded with blue and yellow bumpers on J-hooks, plates on storage horns and two hex dumbbells, on a dark studio floor" /></a>
157+
<a href="showcase/boulder-cluster/"><img src="showcase/boulder-cluster/preview.webp" width="24%" alt="Boulder cluster: a speckled granite block, a banded sandstone boulder split in two and a slab resting on a smaller boulder, sunk in a grassy soil mound with pebbles and wildflowers, on a dark studio floor" /></a>
157158
</p>
158159

159160
[`shipping-crate`](showcase/shipping-crate/) — procedural crate through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets. Falsifier `--skip-decimate` exits 9.
@@ -242,6 +243,8 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
242243

243244
[`weight-rack`](showcase/weight-rack/) — the third `sports` piece: procedural home-gym half rack (punched, numbered square uprights on bolted base plates and padded feet, side rails on bolted flanges, a pull-up bar, J-hooks with UHMW-lined saddles and spotter arms on pull pins, four plate-storage horns, an Olympic barbell with a knurled shaft, collars and sleeves loaded with 20 and 15 kg bumpers and 5 kg iron plates behind spring clips, and two hex dumbbells on the floor), whose pads and dumbbell heads on the floor, pull pins coaxial with their holes, bar seated in both saddles and level, plates coaxial and seated along their sleeves, balanced load and single connected rack are recomputed from the mesh, through the same pipeline. Falsifiers `--float-foot` exits 16, `--offset-pin` 17, `--float-bar` 18, `--hook-high` 19, `--gap-plate` 20, `--odd-load` 21, `--loose-horn` 22.
244245

246+
[`boulder-cluster`](showcase/boulder-cluster/) — the third `nature` piece: procedural glacial boulder cluster (four boulders cut from ellipsoids by cleavage planes with weathered bevels: a speckled granite block, a banded sandstone boulder split in two with matching crack faces and bedding, and a sandstone slab resting flat on a smaller granite boulder, with lichen crusts and moss cushions on the tops and north faces, sunk into a soil mound with grass tufts, pebbles and wildflowers), whose boulders sunk into the soil all round, slab seated on its support and balanced over its footprint, split halves matching across the crack, growth facing up or north and ground cover rooted in the soil are recomputed from the mesh, through the same pipeline. Falsifiers `--perch-boulder` exits 17, `--float-slab` 18, `--perch-slab` 19, `--skew-half` 20, `--sunny-lichen` 21, `--float-cover` 22.
247+
245248
</details>
246249

247250
## Examples

‎ROADMAP.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ Not committed; target list for the next content version. (v0.3.0 shipped the smo
157157
- Weathervane as a game-prop showcase piece — arrow and cardinal arms on a spindle: the arrow's pivot bore coaxial with the spindle and the arrow statically balanced (centroid on the pivot axis within a band)
158158
- Showcase pieces above this line are category `village`. Candidates for the other categories (`showcase/README.md` § Categories):
159159
- **Sports:** ~~basketball hoop (pole, backboard, rim, hung net)~~ **SHIPPED** as `showcase/basketball-hoop/` — gooseneck pole on a bolted anchor plate, braced framed board with painted square, regulation rim, twelve-loop net hung on the rim hooks; `--drop-net` exits 18 on the loops threaded through the hooks while the envelope holds, `--tilt-rim` 19 on rim height/size/level, `--skip-decimate` 9 on the LOD1 ratio band; ~~soccer goal (tube frame, netting)~~ **SHIPPED** as `showcase/soccer-goal/` — 5 × 2 m youth goal, oval extrusion mitred and welded at the corners, cast brackets, foot connectors and hubs, sloped supports and a staked steel ground frame, sagging diamond-mesh net on a red head rope through 53 clips, turf patch with a goal line; `--float-bar` exits 16 on every ground bar bedded in the turf, `--short-support` 17 on the supports seated in their sockets, `--unclip-net` 18 on the head rope through every clip, `--wide-mouth` 19 on the clear mouth size, `--taut-net` 20 on the back panel's sag, while the envelope holds; tennis net on posts, ~~weight rack with plates and dumbbells~~ **SHIPPED** as `showcase/weight-rack/` — half rack of punched, numbered uprights on bolted, padded feet, J-hooks with UHMW saddles and spotter arms on pull pins, plate-storage horns, a loaded Olympic barbell (knurled shaft, bumpers with raised numerals, iron change plates, spring clips) and two hex dumbbells; `--float-foot` exits 16 on every pad and dumbbell head on the floor, `--offset-pin` 17 on the pins coaxial with their holes, `--float-bar` 18 on the bar seated in both saddles, `--hook-high` 19 on the bar level, `--gap-plate` 20 on the plates seated along their sleeves, `--odd-load` 21 on the balanced load, `--loose-horn` 22 on one connected rack, while the envelope holds; alternates bowling pins and ball, skateboard
160-
- **Nature:** ~~pine tree (trunk, tiered branch whorls)~~ **SHIPPED** as `showcase/pine-tree/` — buttressed trunk with surface roots, ten seeded whorls of limbs seated in the bark, faceted needled shoots, dead stubs and cones; `--float-branches` exits 17 on the branch seat, `--lean-crown` 19 on trunk plumb, `--bunch-whorls` 20 on whorl spacing, while the envelope holds; boulder cluster, ~~fallen log with fungus~~ **SHIPPED** as `showcase/fallen-log/` — furrowed log on a bowed axis with peeled, galleried sapwood, a hollow saw-cut butt, a splintered top, broken stubs, moss cushions, three tiers of bracket fungi, and a soil mound with toadstools, ferns and fallen leaves; `--hump-ground` exits 17 on the log bedded along its length, `--float-fungi` 18 on the brackets rooted in the bark, `--tilt-ground` 19 on the mass centre over the contact patch, `--sunny-moss` 20 on moss facing up or into the shade, `--float-litter` 21 on the ground cover rooted in the soil, while the envelope holds; tree stump with mushrooms; alternates flowering shrub, cattail reeds
160+
- **Nature:** ~~pine tree (trunk, tiered branch whorls)~~ **SHIPPED** as `showcase/pine-tree/` — buttressed trunk with surface roots, ten seeded whorls of limbs seated in the bark, faceted needled shoots, dead stubs and cones; `--float-branches` exits 17 on the branch seat, `--lean-crown` 19 on trunk plumb, `--bunch-whorls` 20 on whorl spacing, while the envelope holds; ~~boulder cluster~~ **SHIPPED** as `showcase/boulder-cluster/` — a speckled granite block, a banded sandstone boulder split in two with matching crack faces and bedding, and a sandstone slab resting on a smaller granite boulder, cut by cleavage planes with weathered bevels, with lichen crusts and moss cushions, sunk into a soil mound with grass tufts, pebbles and wildflowers; `--perch-boulder` exits 17 on every boulder sunk into the soil, `--float-slab` 18 on the slab seated on its support, `--perch-slab` 19 on its mass centre over its footprint, `--skew-half` 20 on the split halves matching, `--sunny-lichen` 21 on growth facing up or north, `--float-cover` 22 on the ground cover rooted in the soil, while the envelope holds; ~~fallen log with fungus~~ **SHIPPED** as `showcase/fallen-log/` — furrowed log on a bowed axis with peeled, galleried sapwood, a hollow saw-cut butt, a splintered top, broken stubs, moss cushions, three tiers of bracket fungi, and a soil mound with toadstools, ferns and fallen leaves; `--hump-ground` exits 17 on the log bedded along its length, `--float-fungi` 18 on the brackets rooted in the bark, `--tilt-ground` 19 on the mass centre over the contact patch, `--sunny-moss` 20 on moss facing up or into the shade, `--float-litter` 21 on the ground cover rooted in the soil, while the envelope holds; tree stump with mushrooms; alternates flowering shrub, cattail reeds
161161
- **Household:** ~~articulated desk lamp~~ **SHIPPED** as `showcase/desk-lamp/` — stepped cast base, parallelogram arm sections pinned through knuckle bosses, three springs hung on cross bars, domed shade with reflector, lamp, flex and plugged cable; `--offset-pin` exits 17 on the pins coaxial with their eyes, `--unhook-spring` 18 on the spring ends seated on their bars, `--hollow-base` 19 on the mass centre over the base footprint, while the envelope holds; ~~office chair (five-star base, casters)~~ **SHIPPED** as `showcase/office-chair/` — polished five-star base with ribbed spokes and swivelled twin-wheel casters, chrome gas lift in a telescoping cover, tilt mechanism with knob and levers, contoured seat with a piped welt, reclined mesh back with lumbar pad and headrest on an aluminium spine, height-adjustable T-arms; `--float-caster` exits 16 on every wheel on the floor, `--skew-spoke` 17 on the five-star spacing and plumb stems, `--offset-column` 18 on the gas lift coaxial with hub and socket, `--uneven-arms` 19 on mirrored level armrests, `--loose-wheel` 20 on one connected assembly, while the envelope holds; kitchen stool, mini fridge; alternates floor fan, laundry basket
162162
- **Vehicles:** ~~quad drone~~ **SHIPPED** as `showcase/quad-drone/` — two-tone moulded shell with battery, GPS, grilles and visor, four folding arms hinged on pinned clevises, slotted motors with twisted two-blade props, rubber-footed skids, three-axis gimbal camera; `--float-foot` exits 16 on every foot grounded, `--unlock-arm` 17 on the motor axes on an exact X, `--long-blades` 18 on the prop-disc clearance, `--narrow-skids` 19 on the mass centre inside the landing footprint, `--drop-lens` 20 on one connected assembly, while the envelope holds; traffic cone and barrier set, ~~hover bike~~ **SHIPPED** as `showcase/hover-bike/` — sculpted two-tone fuselage with panel seams, intake grilles, tail vents and cooling fins, a stitched pleated saddle, clip-on bars with grips, levers and an emissive instrument cluster, a flyscreen and headlight pod, two exhaust nozzles, two ducted fans (airfoil shrouds, canted stator vanes, handed seven-blade rotors), booms with foot pegs, and two landing skids on struts; `--float-skid` exits 16 on both skids grounded, `--offset-hub` 17 on the hubs coaxial with their shrouds, `--long-blades` 18 on the blade-tip clearance band, `--odd-hull` 19 on the fuselage's mirror symmetry, `--skew-blade` 20 on equal blade spacing, `--narrow-skids` 21 on the mass centre inside the skids' contact polygon, `--pop-lens` 22 on one connected assembly, while the envelope holds; sci-fi cargo loader; alternates sci-fi supply crate
163163
- `persistent` app-handler witness — handlers registered without `@bpy.app.handlers.persistent` are dropped by `wm.read_homefile`/file load while persistent ones survive; assert the registered-handler set before and after a reload (silent loss AI code hits)

‎docs/gallery/anvil/index.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -358,7 +358,7 @@ <h1>anvil</h1>
358358
<p>A procedural blacksmith anvil on a timber stump through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
359359
</header>
360360
<main id="main">
361-
<nav class="pager" aria-label="Showcase pieces"><a rel="prev" href="../wheelbarrow/" aria-label="Previous showcase piece: wheelbarrow"><span aria-hidden="true">&larr;</span> wheelbarrow</a><span class="pager-pos hud">14 of 45 showcase pieces<span class="pager-keys"> &middot; <kbd>&larr;</kbd><kbd>&rarr;</kbd></span></span><a rel="next" href="../water-trough/" aria-label="Next showcase piece: water-trough">water-trough <span aria-hidden="true">&rarr;</span></a></nav>
361+
<nav class="pager" aria-label="Showcase pieces"><a rel="prev" href="../wheelbarrow/" aria-label="Previous showcase piece: wheelbarrow"><span aria-hidden="true">&larr;</span> wheelbarrow</a><span class="pager-pos hud">14 of 46 showcase pieces<span class="pager-keys"> &middot; <kbd>&larr;</kbd><kbd>&rarr;</kbd></span></span><a rel="next" href="../water-trough/" aria-label="Next showcase piece: water-trough">water-trough <span aria-hidden="true">&rarr;</span></a></nav>
362362
<button class="detail-hero" id="heroZoom" type="button" aria-label="View full size: A forged-steel anvil with a hammer-polished face and a flared, squared waist on a hooped timber stump, a cross-peen hammer on the floor and forge light on its flank.">
363363
<img src="../assets/anvil-hero.webp" alt="A forged-steel anvil with a hammer-polished face and a flared, squared waist on a hooped timber stump, a cross-peen hammer on the floor and forge light on its flank." width="1280" height="720" fetchpriority="high" />
364364
</button>
@@ -3716,7 +3716,7 @@ <h3><a href="../wooden-barrel/">wooden-barrel</a></h3>
37163716
</article>
37173717
</div>
37183718
</section>
3719-
<nav class="pager pager-foot" aria-label="Showcase pieces"><a rel="prev" href="../wheelbarrow/" aria-label="Previous showcase piece: wheelbarrow"><span aria-hidden="true">&larr;</span> wheelbarrow</a><span class="pager-pos hud">14 of 45 showcase pieces</span><a rel="next" href="../water-trough/" aria-label="Next showcase piece: water-trough">water-trough <span aria-hidden="true">&rarr;</span></a></nav>
3719+
<nav class="pager pager-foot" aria-label="Showcase pieces"><a rel="prev" href="../wheelbarrow/" aria-label="Previous showcase piece: wheelbarrow"><span aria-hidden="true">&larr;</span> wheelbarrow</a><span class="pager-pos hud">14 of 46 showcase pieces</span><a rel="next" href="../water-trough/" aria-label="Next showcase piece: water-trough">water-trough <span aria-hidden="true">&rarr;</span></a></nav>
37203720
</main>
37213721
<dialog class="lightbox" id="lightbox" aria-label="Full-size render">
37223722
<button class="lightbox-close" type="button" autofocus>Close</button>

0 commit comments

Comments
 (0)