3d-assembly-manual
Installation
SKILL.md
3D assembly manual
Proven on a garden-bed build, then generalised after kitchen and sauna test builds. Copy starter.html: a project-agnostic engine with a four-step shelf example that renders on its own. Edit only the CONFIG block and the PROJECT SCENE block; leave the engine alone.
CONFIG keys (top of the script)
| Key | What |
|---|---|
title, subtitle, date |
Header text; date prefixes the page counter. |
storageKey |
localStorage key for the last page; unique per manual. |
accent / fill |
Dark accent (arrows, plan frame, outline flash, CSS --accent) and pale part fill (this step's parts, thumbnails). |
view |
Default view direction vector. |
plan |
Plan inset {c:[x,z], r}; null derives it from the scene's Box3 (shadow camera always does). |
figure |
Off (null) by default; opt in only when asked, with [x, z, rotY?]: a flat cut-out that faces the view unless rotY is given. Frame the overview preset to take in its raised hand, 7.4 ft up. |
CAM |
Presets {c, r, v?, walls?, cut?}. |
NAMES, INVENTORY |
Part labels keyed like P; inventory groups [[group, [[part, qty]]]]. |
STEPS |
Pages. Besides the copy keys (title text acts meta time tip parts dims notes inventory calendar): detail {p, r, hide?:[regKeys], view?} (the bubble's own pass: hide parts in front, look from another direction), view (direction), walls {h, sides?} (walls on those sides drop to h ft; omit sides = all), cut:[regKeys] (fade to 0.12 for a cutaway), onEnter(t) (special animation; t has lastLand, objs, tween, ease, easeIO, setOpacity, setColor, paint, T, still; return a new end time to delay marks). Step keys override the preset. |
PROJECT SCENE block: context geometry (auto-painted white), wall(side, x0, x1, y0, y1, z0, z1) for rooms, P.* part builders, optional THUMB_ONLY[key] builders (a thicker thumbnail-only variant for thin parts: bands, wires), reg() calls. Groups passed to reg() are re-centred automatically, so parts can be built in absolute coordinates.