@developerz.ai/ts23d 0.1.0 → 0.2.0

package/recipes/boxcar/boxcar.ts

@@ -15,9 +15,11 @@ import {
   lathe,
   type Mesh,
   merge,
+  NATURAL,
   noOverlap,
   place,
   prism,
+  type StripId,
   symmetric,
   text,
   tiled,
@@ -46,10 +48,10 @@ const DOOR_Z0 = 1.15;
 const DOOR_Z1 = 3.64;
 const JOURNAL_Y = 0.925; // axle end = journal box inner face
 
-const steel = hex('#34302b');
-const iron = hex('#1d1c1b');
-const wheelC = hex('#2a2826');
-const walk = hex('#5d4c3b');
+const steel = hex('#a59f97'); // tints iron_cast: dark, sand-cast trucks and gear
+const iron = hex('#a8a29c'); // tints iron_rust: weathered hardware
+const wheelC = hex('#948f8a');
+const walk = NATURAL; // wood_weathered carries its own silver-grey
 
 interface Params {
   /** Large road name left of the door. */
@@ -71,7 +73,7 @@ function bx(
   z0: number,
   z1: number,
   color: Vec3,
-  strip: 'plain' | 'iron' | 'wood' = 'iron',
+  strip: StripId = 'iron_cast',
   bevel = 0,
 ): Mesh {
   const [a, b] = [Math.min(x0, x1), Math.max(x0, x1)];
@@ -88,7 +90,7 @@ function bx(
 }
 
 const rod = (from: Vec3, to: Vec3, w: number, color: Vec3 = iron, segments = 0): Mesh =>
-  beam({ from, to, width: w, color, strip: 'iron', ...(segments ? { segments } : {}) });
+  beam({ from, to, width: w, color, strip: 'iron_rust', ...(segments ? { segments } : {}) });
 
 // ---------------------------------------------------------------- running gear
 /** One wheel's tread disc (exactly 33 in) at lateral y, outer face toward ±y. */
@@ -101,6 +103,7 @@ function tread(lod: Lod, y: number): Mesh {
       axis: 'y',
       at: [0, y, 0],
       color: wheelC,
+      strip: 'iron_cast',
     });
   const s = Math.sign(y);
   const segs = [24, 14, 8][lod] ?? 8;
@@ -114,7 +117,7 @@ function tread(lod: Lod, y: number): Mesh {
     segments: segs,
     axis: 'y',
     color: wheelC,
-    strip: 'iron',
+    strip: 'iron_cast',
   });
 }
 
@@ -130,6 +133,7 @@ function wheelset(lod: Lod): Mesh {
         axis: 'y',
         at: [0, s * (WHEEL_Y + TREAD_W / 2 + 0.025), 0],
         color: wheelC,
+        strip: 'iron_cast',
       });
     const shaft = cylinder({
       radius: 0.075,
@@ -137,6 +141,7 @@ function wheelset(lod: Lod): Mesh {
       segments: 4,
       axis: 'y',
       color: wheelC,
+      strip: 'iron_cast',
     });
     return merge([shaft, hub(1), hub(-1)]);
   }
@@ -148,6 +153,7 @@ function wheelset(lod: Lod): Mesh {
       segments: Math.max(6, segs / 2),
       axis: 'y',
       color: wheelC,
+      strip: 'iron_cast',
     }),
   ];
   for (const s of [1, -1]) {
@@ -163,6 +169,7 @@ function wheelset(lod: Lod): Mesh {
         segments: segs,
         axis: 'y',
         color: wheelC,
+        strip: 'iron_cast',
         caps: false,
       }),
     );
@@ -177,6 +184,7 @@ function wheelset(lod: Lod): Mesh {
           axis: 'y',
           at: [0, yo + s * 0.02, 0],
           color: wheelC,
+          strip: 'iron_cast',
         }),
       );
       for (let k = 0; k < 6; k++) {
@@ -232,7 +240,7 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
           r - 0.09,
           r + 0.12,
           steel,
-          'iron',
+          'iron_cast',
           bevel,
         ),
       );
@@ -250,7 +258,17 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
         ); // lid
     }
     out.push(
-      bx(ax[0] - 0.16, ax[1] + 0.16, y - 0.06, y + 0.06, r + 0.12, zt + 0.07, steel, 'iron', bevel),
+      bx(
+        ax[0] - 0.16,
+        ax[1] + 0.16,
+        y - 0.06,
+        y + 0.06,
+        r + 0.12,
+        zt + 0.07,
+        steel,
+        'iron_cast',
+        bevel,
+      ),
     ); // top member
     if (lod < 2) {
       const p: [number, number][] = [
@@ -275,6 +293,7 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
             segments: coilSegs,
             at: [d, y, zb + 0.125],
             color: iron,
+            strip: 'iron_rust',
           }),
         );
         if (lod === 0)
@@ -286,6 +305,7 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
                 segments: coilSegs,
                 at: [d, y, zb + 0.06 + k * 0.042],
                 color: iron,
+                strip: 'iron_rust',
               }),
             );
       }
@@ -298,7 +318,17 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
   }
   // Bolster on the spring nests, centre plate up to the car's body bolster.
   out.push(
-    bx(-0.15, 0.15, -(JOURNAL_Y + 0.12), JOURNAL_Y + 0.12, zb + 0.21, 0.6, steel, 'iron', bevel),
+    bx(
+      -0.15,
+      0.15,
+      -(JOURNAL_Y + 0.12),
+      JOURNAL_Y + 0.12,
+      zb + 0.21,
+      0.6,
+      steel,
+      'iron_cast',
+      bevel,
+    ),
   );
   out.push(
     cylinder({
@@ -307,6 +337,7 @@ function truckFrame(lod: Lod, bevel: number): Mesh {
       segments: [12, 8, 6][lod] ?? 6,
       at: [0, 0, 0.62],
       color: steel,
+      strip: 'iron_cast',
     }),
   );
   if (lod < 2)
@@ -454,15 +485,29 @@ const usra = defineFamily({
 
     // Underframe: straight centre sill, side sills, end sills, body bolsters, crossbearers, floor.
     const uf: Mesh[] = [
-      bx(-XB - 0.04, XB + 0.04, -0.2, 0.2, 0.72, 1.1, steel, 'iron', bevel),
-      bx(-XB, XB, -SHEATH_Y + 0.02, SHEATH_Y - 0.02, 1.1, FLOOR_Z, walk, 'wood'),
+      bx(-XB - 0.04, XB + 0.04, -0.2, 0.2, 0.72, 1.1, steel, 'iron_cast', bevel),
+      bx(-XB, XB, -SHEATH_Y + 0.02, SHEATH_Y - 0.02, 1.1, FLOOR_Z, walk, 'wood_weathered'),
     ];
     for (const s of [-1, 1])
-      uf.push(bx(-XB, XB, s * SHEATH_Y, s * (FRAME_Y - 0.01), 0.95, 1.18, steel, 'iron', bevel));
+      uf.push(
+        bx(-XB, XB, s * SHEATH_Y, s * (FRAME_Y - 0.01), 0.95, 1.18, steel, 'iron_cast', bevel),
+      );
     for (const d of [-1, 1]) {
-      uf.push(bx(d * XB, d * (XB + 0.05), -FRAME_Y, FRAME_Y, 0.74, 1.18, steel, 'iron', bevel)); // end sill / striker
       uf.push(
-        bx(d * (TC / 2) - 0.2, d * (TC / 2) + 0.2, -1.25, 1.25, 0.64, 1.1, steel, 'iron', bevel),
+        bx(d * XB, d * (XB + 0.05), -FRAME_Y, FRAME_Y, 0.74, 1.18, steel, 'iron_cast', bevel),
+      ); // end sill / striker
+      uf.push(
+        bx(
+          d * (TC / 2) - 0.2,
+          d * (TC / 2) + 0.2,
+          -1.25,
+          1.25,
+          0.64,
+          1.1,
+          steel,
+          'iron_cast',
+          bevel,
+        ),
       ); // body bolster
       if (lod < 2)
         for (const x of [1.6, 3.0])
@@ -482,7 +527,7 @@ const usra = defineFamily({
           u: [0, 0, EAVE_Z - boardsZ0],
           v,
           color: paint,
-          strip: lod === 2 ? 'plain' : 'wood',
+          strip: lod === 2 ? 'plain' : 'wood_painted',
           vMetres: lod === 2 ? BODY_L : 0.6,
         }),
       );
@@ -501,7 +546,9 @@ const usra = defineFamily({
       );
     }
     for (const d of [-1, 1])
-      bodyM.push(bx(d * (XB - 0.05), d * XB, -SHEATH_Y, SHEATH_Y, 1.0, EAVE_Z, paint, 'iron'));
+      bodyM.push(
+        bx(d * (XB - 0.05), d * XB, -SHEATH_Y, SHEATH_Y, 1.0, EAVE_Z, paint, 'steel_painted'),
+      );
     ctx.part('body', merge(bodyM));
 
     // Outside steel framing: posts, diagonal braces leaning toward the door, top plate, end ribs.
@@ -515,11 +562,20 @@ const usra = defineFamily({
       for (const d of [-1, 1]) {
         for (const px of lod === 2 ? [] : posts) {
           const x = d * px;
-          fr.push(bx(x - postW / 2, x + postW / 2, y0, y1, 1.0, EAVE_Z, paint, 'iron'));
+          fr.push(bx(x - postW / 2, x + postW / 2, y0, y1, 1.0, EAVE_Z, paint, 'steel_painted'));
         }
         // Door posts.
         fr.push(
-          bx(d * (DOOR_W / 2 + 0.01), d * (DOOR_W / 2 + 0.1), y0, y1, 1.0, EAVE_Z, paint, 'iron'),
+          bx(
+            d * (DOOR_W / 2 + 0.01),
+            d * (DOOR_W / 2 + 0.1),
+            y0,
+            y1,
+            1.0,
+            EAVE_Z,
+            paint,
+            'steel_painted',
+          ),
         );
         if (lod < 2)
           for (let i = 0; i < 4; i++) {
@@ -533,13 +589,15 @@ const usra = defineFamily({
                 width: 0.075,
                 height: 0.06,
                 color: paint,
-                strip: 'iron',
+                strip: 'steel_painted',
                 up: [0, s, 0],
               }),
             );
           }
       }
-      fr.push(bx(-XB, XB, y0, s * (FRAME_Y + 0.01), EAVE_Z - 0.16, EAVE_Z, paint, 'iron', bevel)); // side plate
+      fr.push(
+        bx(-XB, XB, y0, s * (FRAME_Y + 0.01), EAVE_Z - 0.16, EAVE_Z, paint, 'steel_painted', bevel),
+      ); // side plate
       if (lod === 0) {
         // Rivet heads where braces meet posts and sills.
         const rivet = cylinder({
@@ -569,7 +627,7 @@ const usra = defineFamily({
             1.0,
             EAVE_Z,
             paint,
-            'iron',
+            'steel_painted',
           ),
         );
       if (lod < 2)
@@ -584,7 +642,7 @@ const usra = defineFamily({
               z - 0.05,
               z + 0.05,
               paint,
-              'iron',
+              'steel_painted',
             ),
           );
         }
@@ -606,7 +664,7 @@ const usra = defineFamily({
         depth: BODY_L + 0.1,
         plane: 'yz',
         color: paintDark,
-        strip: 'iron',
+        strip: 'steel_painted',
       }),
     ];
     if (lod === 0) {
@@ -627,12 +685,14 @@ const usra = defineFamily({
     ctx.part('roof', merge(roofM));
 
     const walkM: Mesh[] = [
-      bx(-XB - 0.12, XB + 0.12, -0.255, 0.255, WALK_TOP - 0.045, WALK_TOP, walk, 'wood'),
+      bx(-XB - 0.12, XB + 0.12, -0.255, 0.255, WALK_TOP - 0.045, WALK_TOP, walk, 'wood_weathered'),
     ];
     const saddles = lod === 2 ? 3 : 11;
     for (let i = 0; i < saddles; i++) {
       const x = -XB + 0.3 + ((BODY_L - 0.6) * i) / (saddles - 1);
-      walkM.push(bx(x - 0.05, x + 0.05, -0.2, 0.2, RIDGE_Z - 0.03, WALK_TOP - 0.045, walk, 'wood'));
+      walkM.push(
+        bx(x - 0.05, x + 0.05, -0.2, 0.2, RIDGE_Z - 0.03, WALK_TOP - 0.045, walk, 'wood_weathered'),
+      );
     }
     if (lod < 2)
       for (const d of [-1, 1]) {
@@ -647,7 +707,7 @@ const usra = defineFamily({
             WALK_TOP - 0.045,
             WALK_TOP,
             walk,
-            'wood',
+            'wood_weathered',
           ),
         );
         walkM.push(
@@ -659,7 +719,7 @@ const usra = defineFamily({
             EAVE_Z,
             WALK_TOP - 0.045,
             walk,
-            'wood',
+            'wood_weathered',
           ),
         );
       }
@@ -679,15 +739,26 @@ const usra = defineFamily({
           u: [0, 0, DOOR_Z1 - DOOR_Z0],
           v: [s > 0 ? -DOOR_W : DOOR_W, 0, 0],
           color: paint,
-          strip: lod === 2 ? 'plain' : 'wood',
+          strip: lod === 2 ? 'plain' : 'wood_painted',
         }),
-        bx(-DOOR_W / 2, DOOR_W / 2, y0, y1 - s * 0.003, DOOR_Z0, DOOR_Z1, paintDark, 'plain'),
+        bx(
+          -DOOR_W / 2,
+          DOOR_W / 2,
+          y0,
+          y1 - s * 0.003,
+          DOOR_Z0,
+          DOOR_Z1,
+          paintDark,
+          'wood_painted',
+        ),
       ];
       if (lod < 2) {
         for (const z of [DOOR_Z0, (DOOR_Z0 + DOOR_Z1) / 2 - 0.05, DOOR_Z1 - 0.1])
-          dm.push(bx(-DOOR_W / 2, DOOR_W / 2, y1, y1 + s * 0.015, z, z + 0.1, paint, 'iron')); // steel straps
+          dm.push(
+            bx(-DOOR_W / 2, DOOR_W / 2, y1, y1 + s * 0.015, z, z + 0.1, paint, 'steel_painted'),
+          ); // steel straps
         for (const x of [-DOOR_W / 2, DOOR_W / 2 - 0.08])
-          dm.push(bx(x, x + 0.08, y1, y1 + s * 0.015, DOOR_Z0, DOOR_Z1, paint, 'iron'));
+          dm.push(bx(x, x + 0.08, y1, y1 + s * 0.015, DOOR_Z0, DOOR_Z1, paint, 'steel_painted'));
       }
       if (lod === 0) dm.push(bx(-0.75, -0.65, y1 + s * 0.015, y1 + s * 0.06, 2.0, 2.2, iron)); // handle / latch
       ctx.part(`door_${side}`, dirt(merge(dm)), {
@@ -733,10 +804,20 @@ const usra = defineFamily({
           COUPLER_Z - 0.07,
           COUPLER_Z + 0.07,
           iron,
-          'iron',
+          'iron_rust',
+          bevel,
+        ),
+        bx(
+          d * 6.5,
+          d * 6.7,
+          -0.17,
+          0.12,
+          COUPLER_Z - 0.13,
+          COUPLER_Z + 0.13,
+          iron,
+          'iron_rust',
           bevel,
         ),
-        bx(d * 6.5, d * 6.7, -0.17, 0.12, COUPLER_Z - 0.13, COUPLER_Z + 0.13, iron, 'iron', bevel),
       ];
       if (lod < 2) cm.push(bx(d * 6.6, d * 6.7, 0.12, 0.2, COUPLER_Z - 0.1, COUPLER_Z + 0.1, iron)); // knuckle
       if (lod === 0) {
@@ -810,6 +891,7 @@ const usra = defineFamily({
         ],
         segments: wheelSegs,
         color: iron,
+        strip: 'iron_rust',
         at: [-(XB + 0.13), -0.85, 0],
       }),
     );
@@ -836,6 +918,7 @@ const usra = defineFamily({
           axis: 'x',
           at: [-0.9, 0.55, 0.9],
           color: iron,
+          strip: 'iron_rust',
         }),
         cylinder({
           radius: 0.16,
@@ -844,6 +927,7 @@ const usra = defineFamily({
           axis: 'x',
           at: [0.4, -0.5, 0.92],
           color: iron,
+          strip: 'iron_rust',
         }),
         bx(-0.25, -0.05, 0.2, 0.42, 0.85, 1.1, iron),
         rod([-0.35, 0.55, 1.08], [-0.35, 0.2, 1.08], 0.05, iron),

package/recipes/goblin_head/README.md

@@ -2,20 +2,25 @@
 
 ## Identity
 A sly, scrawny goblin tinker, read from the 3/4 view by: **huge leaf-shaped ears** wider than its
-shoulders, a **long humped nose**, a **wide toothy grin**, **big amber eyes** under a light brow,
-a few **wiry hair tufts** and warts on a bald dome, and a **draped hood** on narrow shoulders.
+shoulders, a **long hooked nose** (one form drawn out to a drooping point, nostrils tucked at its
+base), a **wide grin** of small pointed teeth with the cheeks bunched up beside it, **big amber eyes
+under heavy upper lids**, a **worried creased brow**, a **sharp little chin**, **pale wispy hair**
+straggling off a warty dome, a **skinny corded neck** on **narrow bony shoulders** in a linen shirt,
+leather vest, strap and buckle, a **knotted scarf** and a **hood worn down** on the back — cut as a
+collectible bust on a turned plinth.
 
 ## Design spec (head units: 1 = chin to crown = 0.19 m, ≈ 0.8 × human)
 | Feature | Value (units) | Metres | Note |
 |---|---|---|---|
 | chin → crown | 1.00 | 0.190 | the `height` param |
-| overall bust L × W × H | — | 0.236 × 0.322 × 0.366 | `real`, ±5 %; width is the ears |
+| overall bust L × W × H | — | 0.227 × 0.342 × 0.372 | `real`, ±5 %; width is the ears |
 | cranium width / depth / above eye line | 0.66 / 0.84 / 0.50 | 0.125 / 0.160 / 0.095 | |
-| eyeball radius / spacing | 0.072 / 0.15 | 0.014 / pupils 0.057 apart | eyes 1.4 × human relative size |
-| ears length / width / sweep / lift | 0.62 / 0.30 / 22° / 18° | 0.118 long | two tapered blades + hollow |
-| nose length / bridge / hook | 0.20 / 0.12 / 0.07 | tip ≈ 0.05 past the face | cone from between the eyes |
-| mouth half-width / grin | 0.20 / 0.75 | | corners lifted, teeth rows |
-| neck radius / shoulders | 0.20 / 0.75 | 0.038 / 0.143 | |
+| eyeball radius / spacing / upper lid | 0.08 / 0.155 / 30° | 0.015 / pupils 0.059 apart | eyes 1.5 × human relative size, heavy lids |
+| ears length / width / sweep / lift | 0.66 / 0.30 / 24° / 6° | 0.125 long | two tapered blades + hollow, near level |
+| nose length / bridge / hook / tip | 0.20 / 0.13 / 0.065 / 0.046 | | bridge cone + hump + tip + drooping point cone |
+| mouth half-width / grin | 0.21 / 0.80 | | crescent cut, 3 + 3 pointed teeth a side, tongue |
+| forehead creases / chin | 3 / 0.72 | | creases painted (thinner than a cell) |
+| neck radius / shoulders / mass | 0.14 / 0.52 / 0 | 0.027 / 0.099 | bony: clavicles under the shirt |
 
 ## Palette (sRGB)
 | Role | Hex |
@@ -23,8 +28,9 @@ a few **wiry hair tufts** and warts on a bald dome, and a **draped hood** on nar
 | skin / shade / lips | `#9cb84a` / `#6a8a2c` / `#7a8e36` |
 | eyes: sclera / iris | `#f0e6a0` / `#e0a020` |
 | teeth / mouth | `#e8dcae` / `#3a1010` |
-| hair tufts | `#3a3024` |
-| hood cloth / patch + cord leather | `#6a4a7a` / `#5a3a22` |
+| wispy hair | `#c8c0b0` |
+| linen shirt / vest + strap (×0.65) / scarf / hood / buckle | `#b8a47c` / `#6b4428` / `#9a3a24` / `#4e5e3a` / `#a88a4a` |
+| plinth / cut faces | `#6f6c6c` (linear 0.16, 0.15, 0.15) / ×1.3 |
 
 ## Parts the engine needs
 | Part | Pivot | Motion |
@@ -39,8 +45,11 @@ along the lips, the marionette lines and under the chin. Its cut faces are paint
 when it opens; it laps 0.75 cells over the head so no gap shows.
 
 ## LODs
-Sculpt cell = 2 % / 4.5 % / 14 % of head height. LOD0/1 bake vertex AO across all parts (16/10 rays); LOD2 drops
-warts, wiry tufts and the AO bake, and floors ear thickness at 0.7 cells so ears stay attached.
+Sculpt cell = 2 % / 4.5 % / 14 % of head height (bust 1.6 ×). LOD0/1 bake vertex AO across all
+parts (16/10 rays); every LOD carries the painted tone. LOD1/2 carve the grin as a plain wide line
+(no teeth or tongue: a crescent that thin folds over at coarse cells); LOD2 drops warts, hair and
+the AO bake, floors ear thickness and the nose's radii at about a cell, and makes the plinth one
+drum so the bust stays on the ground.
 
 ## References (stylised anatomy, not likeness)
 | Topic | Link | Used for |
@@ -48,6 +57,9 @@ warts, wiry tufts and the AO bake, and floors ear thickness at 0.7 cells so ears
 | Loomis head: eye line at half height, brow/nose/chin thirds | https://finearttutorials.com/guide/loomis-method/ | human eye line 0.5, nose base 0.32, mouth 0.22 |
 | Proportions of the head (ears between brow and nose base, head ≈ 5 eyes wide) | https://artyfactory.com/portraits/pencil-portraits/proportions-of-a-head.html | ear placement, eye size vs head width |
 | Primary → secondary → tertiary forms (block brow/cheek/jaw first, then cut lids and folds) | https://www.creativebloq.com/how-to/how-to-sculpt-and-pose-a-cartoon-head-in-zbrush | the edit order in `head-face.ts` |
+| Goblin from a base head: enlarge the top of the head, elongate the ears, broaden their base | https://create.roblox.com/docs/art/characters/creating/sculpting | cranium and ear roots |
+| Goblin sculpt breakdown: big nose, cracked grin, ears, sparse hair | https://www.foxrenderfarm.com/share/how-to-create-goblin-in-zbrush | feature priorities |
+| Goblin features: large pointed ears, mischievous grin with visible teeth | https://sketchok.com/other/monsters-and-fantasy-creatures/how-to-draw-a-goblin/ | grin + teeth |
 | Orc: widen head and jawline to break human proportion | https://www.creativebloq.com/3d/how-create-orc-zbrush-61411834 | orc jaw width 0.37 vs human 0.22 |
 | Stylised orc head study (silhouette, form language) | https://blenderartists.org/t/orc-head-study-stylized-characters/1655542 | massing check |
 | Stylised hair: large clumps first, hairline → crown, one primary flow direction | https://gamesartist.co.uk/curly-hair-ls/ · https://www.cgchannel.com/2023/03/tutorial-creating-stylized-hairstyles-using-zbrush | `swept` locks in head-hair.ts |
@@ -58,5 +70,6 @@ hand-painted stylised fantasy" is the idiom (exaggerated primary forms, generous
 vertex colour with baked AO), not a specific source.
 
 ## Known gaps
-Teeth sit deep in the grin and read only up close; no earrings or wrinkles; hood is a smooth roll
-with one patch.
+Teeth are small at this scale and read best in the 3/4 view; the wisps are cone pairs, not hair
+cards; the jaw part's seam shows as a faint line at the mouth corners up close; garment edges are
+vertex-colour soft and the strap/buckle are simple shells.

package/recipes/goblin_head/goblin_head.ts

@@ -1,7 +1,9 @@
 // Stylised goblin bust — an original design in the chunky hand-painted fantasy idiom: huge leaf
-// ears, long humped nose, wide toothy grin, big amber eyes, a few wiry hair tufts, warts, and a
-// draped hood on narrow shoulders. The `head` kind sculpts it (race preset `goblin`, chin to crown
-// 0.19 m); this file is the spec. Design dossier: recipes/goblin_head/README.md.
+// ears, a long hooked nose, a wide grin of small pointed teeth, big amber eyes under heavy lids, a
+// worried creased brow, pale wispy hair, warts; a skinny neck and bony shoulders in a linen shirt,
+// leather vest, strap, knotted scarf and a hood worn down, cut as a collectible bust on a turned
+// plinth. The `head` kind sculpts it (race preset `goblin`, chin to crown 0.19 m); this file is the
+// spec. Design dossier: recipes/goblin_head/README.md.
 
 import { defineAsset, head } from '@developerz.ai/ts23d';
 
@@ -9,22 +11,22 @@ export const goblin_head = defineAsset({
   name: 'goblin_head',
   kind: 'character',
   description:
-    'Stylised goblin bust: huge pointed ears, long humped nose, toothy grin, amber eyes, hood',
+    'Stylised goblin bust on a plinth: huge pointed ears, long hooked nose, toothy grin, heavy-lidded amber eyes, wispy hair, leather vest and scarf',
   tags: ['character', 'fantasy', 'goblin', 'bust', 'sculpt'],
   license: 'CC0-1.0',
   sources: ['recipes/goblin_head/README.md (design dossier: proportions, palette, references)'],
   // Design spec, not a real-world one: overall bust size and eye spacing from the dossier.
   real: {
-    length: 0.236,
-    width: 0.322,
-    height: 0.366,
+    length: 0.227,
+    width: 0.342,
+    height: 0.372,
     measures: [
       {
         label: 'eye spacing (pupil to pupil)',
-        value: 0.057,
+        value: 0.0589,
         axis: 'y',
         between: ['eye_l', 'eye_r'],
-        source: '0.15 × 2 × 0.19 m',
+        source: '0.155 × 2 × 0.19 m',
       },
     ],
   },

package/recipes/human_head/README.md

@@ -5,13 +5,14 @@ A young adventurer, read from the 3/4 view by: **classical proportions pushed sl
 (square jaw, strong brow, thick neck), **defined arched eyebrows**, **swept-back hair** in chunky
 tapered two-tone locks over a rounded hairline, a **clipped beard with chin volume and a drooping
 moustache**, clear blue eyes, a **blue tunic** with a standing leather collar, placket and brass
-buttons, and a **red mantle** over the shoulders pinned with a brass brooch.
+buttons, and a **red mantle** over the shoulders pinned with a brass brooch — cut as a collectible
+bust (U-cut under the chest) on a turned plinth.
 
 ## Design spec (head units: 1 = chin to crown = 0.23 m, adult human)
 | Feature | Value (units) | Metres | Note |
 |---|---|---|---|
 | chin → crown | 1.00 | 0.230 | adult menton–vertex ≈ 0.22–0.24 m |
-| overall bust L × W × H | — | 0.247 × 0.464 × 0.439 | `real`, ±5 % |
+| overall bust L × W × H | — | 0.247 × 0.428 × 0.439 | `real`, ±5 % |
 | cranium width / depth | 0.66 / 0.86 | 0.152 / 0.198 | adult head breadth ≈ 0.15 m, length ≈ 0.19–0.20 m |
 | eye line | 0.50 | — | Loomis: half height |
 | eyeball radius / spacing | 0.052 / 0.135 | 0.012 / pupils 0.062 apart | human eyeball ≈ 24 mm; IPD ≈ 62 mm |
@@ -19,6 +20,7 @@ buttons, and a **red mantle** over the shoulders pinned with a brass brooch.
 | jaw half-width | 0.22 | 0.051 | bigonial ≈ 0.10 m |
 | ears | round, 0.27 long | 0.062 | between brow and nose base |
 | neck radius | 0.27 | 0.062 | heroic: thicker than average |
+| shoulders / mass | 0.95 / 0.5 (default) | 0.219 | pectorals, deltoids, trapezius under the tunic |
 
 ## Palette (sRGB)
 | Role | Hex |
@@ -27,6 +29,7 @@ buttons, and a **red mantle** over the shoulders pinned with a brass brooch.
 | eyes: sclera / iris | `#ece6dc` / `#3d6e9e` |
 | hair + beard (two-tone locks ×1.5) | `#5a3a22` |
 | tunic / mantle / collar, placket / brooch, buttons | `#2e4f8a` / `#7a2420` / `#6b4428` / `#c9a24a` |
+| plinth / cut faces | `#6f6c6c` (linear 0.16, 0.15, 0.15) / ×1.3 |
 
 ## Parts the engine needs
 | Part | Pivot | Motion |
@@ -41,8 +44,9 @@ along the lips, the marionette lines and under the chin. Its cut faces are paint
 when it opens; it laps 0.75 cells over the head so no gap shows.
 
 ## LODs
-Sculpt cell = 2 % / 4.5 % / 14 % of head height. LOD0/1 bake vertex AO across all parts (16/10 rays); LOD2 drops
-warts, wiry tufts and the AO bake, and floors ear thickness at 0.7 cells so ears stay attached.
+Sculpt cell = 2 % / 4.5 % / 14 % of head height (bust 1.6 ×). LOD0/1 bake vertex AO across all
+parts (16/10 rays); every LOD carries the painted tone (cavity, warm top, cool under). LOD2 drops
+the AO bake, floors ear thickness at 0.7 cells and makes the plinth one drum.
 
 ## References (stylised anatomy, not likeness)
 | Topic | Link | Used for |

package/recipes/human_head/human_head.ts

@@ -1,8 +1,9 @@
 // Stylised human hero bust — an original design in the chunky hand-painted fantasy idiom:
 // classical proportions (eye line at half height, brow/nose/chin thirds) pushed slightly heroic —
 // square jaw, strong brow — with short swept hair, a short beard and moustache, a blue tunic,
-// leather collar and cloak roll. The `head` kind sculpts it (race preset `human`, chin to crown
-// 0.23 m); this file is the spec. Design dossier: recipes/human_head/README.md.
+// leather collar and mantle, cut as a collectible bust on a turned plinth. The `head` kind sculpts
+// it (race preset `human`, chin to crown 0.23 m); this file is the spec. Design dossier:
+// recipes/human_head/README.md.
 
 import { defineAsset, head } from '@developerz.ai/ts23d';
 
@@ -17,7 +18,7 @@ export const human_head = defineAsset({
   // Design spec, not a real-world one: overall bust size and eye spacing from the dossier.
   real: {
     length: 0.247,
-    width: 0.464,
+    width: 0.428,
     height: 0.439,
     measures: [
       {

package/recipes/material_swatches/material_swatches.ts

@@ -19,6 +19,7 @@ import {
   type Mesh,
   MeshBuilder,
   merge,
+  NATURAL,
   STRIPS,
   type StripId,
   type Vec3,
@@ -26,7 +27,7 @@ import {
 
 const STONE = hex('#9c968c');
 const INK = hex('#1c1c1c');
-const TINT: Readonly<Record<StripId, Vec3>> = {
+const TINT: Readonly<Partial<Record<StripId, Vec3>>> = {
   plain: hex('#e8e4dc'),
   brick: hex('#9a4a32'),
   stone: hex('#c8bba0'),
@@ -128,7 +129,8 @@ export const material_swatches = defineAsset({
   kind: 'prop',
   description:
     'Every trim-sheet strip and cell on labelled panels: the material generator test card.',
-  budget: { triangles: [16000, 1200, 800] },
+  // 24 strip panels (library v2) + decal and foliage cells.
+  budget: { triangles: [24000, 1200, 800] },
   build(ctx) {
     const stripSpan = STRIPS.length * 2 + (STRIPS.length - 1) * FRONT.gap;
     const cells: readonly CellId[] = [...DECAL_CELLS, ...FOLIAGE_CELLS];
@@ -151,7 +153,7 @@ export const material_swatches = defineAsset({
       const panel = box({
         size: [0.06, 2, h],
         at: [FRONT.x, y, FRONT.height],
-        color: TINT[id],
+        color: TINT[id] ?? NATURAL,
         strip: id,
       });
       ctx.part(`strip_${id}`, panel, id === 'glass' ? { surface: 'glass' } : {});
@@ -167,10 +169,14 @@ export const material_swatches = defineAsset({
           surface: 'cutout',
         });
       } else {
-        const back = box({ size: [0.06, 1, 1], at: [REAR.x, y, REAR.height], color: TINT.plain });
+        const back = box({
+          size: [0.06, 1, 1],
+          at: [REAR.x, y, REAR.height],
+          color: TINT.plain ?? NATURAL,
+        });
         ctx.part(
           `cell_${id}`,
-          merge([back, cellQuad(id, REAR.x + 0.032, y, REAR.height, 1, TINT.plain)]),
+          merge([back, cellQuad(id, REAR.x + 0.032, y, REAR.height, 1, TINT.plain ?? NATURAL)]),
         );
       }
       if (ctx.lod === 0)