Skip to content

Crucible 0.22.0

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Nov 16:42
3396255
  • Breaking: the 67js names kept since the rename are gone: the 67js-mcp and 67js-addon-check commands, the Renderer67 export, SIXTYSEVENJS_* environment variables and the 67js.scene, 67js.asset, 67js.pack and 67js-pack.json formats; use the Crucible names (#2724)
  • Breaking: the package module files are now build/crucible.module.js and build/crucible.standalone.js (was 67.module.js and 67.standalone.js), and the site serves /releases/<version>/crucible.module.js; imports of @codepawlhq/crucible itself are unchanged (#2724)
  • A grid sequence reuses one texel buffer for every frame it uploads, so a changing frame costs about 3 ms less at 1080p (#1045)
  • A grid volume sequence changes frames about 6 times faster: the half float decode table is built once and a grid with no temperature uploads no emission texels, which brings a 90 frame JangaFX explosion to a median of 21 to 29 ms a frame at 1080p on an RTX 3060 (#1045)
  • A scene file now gives a dense scan levels of detail by default (renderer.denseLods, about 2.7x faster GPU frames on the Monster scan, a slight change in far detail); set "denseLods": false to keep every triangle (#1163).
  • The native film temporal blend keeps history on depth steps such as leaf edges under depth of field, clamped to the colour range of the pixel's 3x3 neighbourhood (edgeClampDeviations, edgeHistoryFrames), which cuts flicker on foliage (#1214)
  • Light probes, object reflection probes and the irradiance grid now take up to 1,024 parts instead of 256, so a house-sized scene built through MCP keeps its baked light and reflections (#1218).
  • A light bake whose explicit samples, bounces and texelsPerUnit are over the 24 million path step limit now shrinks to fit it, as a preset does, and reports what ran in bake.used and bake.reduction, instead of failing; a scene too large even at the lowest settings is refused with the texels or path steps it needs. A test pins that every bake.irradianceGrid node count the recipe accepts fits the node cap.
  • A closed room with a window renders closer to the path tracer: its surfaces now get the sky light they bounce on to each other, so the window probe is 1.3 times darker than the tracer instead of 2.6 times (#1334)
  • A closed room with a window now gets the sky light its surfaces bounce on to each other, tinted by the room's albedo and fading toward corners, so its walls no longer render near black or blue-grey, and a path traced job's exposure advice says a daylit interior traces about 1 to 2 stops brighter than the raster frame at the same exposure, with the measured table in the path tracer guide (#1334).
  • denoise: true and the final quality tier use OIDN when @codepawlhq/crucible-denoise-oidn and its binary are installed, and otherwise the wavelet filter with denoiserNote saying so; denoise: "wavelet" still means wavelet (#1335)
  • A local volume with castShadow no longer dims the glow of emissive surfaces under it: the frame draws the emission into the render pass target first and the post pass dims only the light the surface receives, and the bloom of a glowing part is no longer diluted by the blur of a local volume over it nor dimmed by its surface shadow, only by its transmittance; a render that draws another frame inside it no longer breaks the reversed depth state of the outer frame; A shader feature asked for while its program is still linking is no longer recorded as built, so the draw that comes back rebuilds the program; before, the emission mask of a volume shadow could draw the lit image instead of the emission and exempt a whole lit floor from the volume's shadow. A float emission pass keeps emission above 1 (#1360)
  • A reflection probe placed by hand now sees the buildings around it lit by the environment map, so glass in front of a building reflects the building and not a black silhouette (Part of #1385).
  • Grid volumes take flameTemperature: { ignition, maximum }, Blender's flame remap (flame > 0.01 ? ignition + flame * (maximum - ignition) : 0), so the blackbody comes from the flame channel at 1500 to 3000 K whatever the smoke density, and the add-explosion fireball uses it: the smoke edge glows orange as it does in Cycles. Volumes without the field render as before. add-explosion no longer raises effects.bloom to 0.5 (the scene keeps its own bloom), which made the fireball glow where Cycles has no glare. The Glaze, CPU, WebGPU and native paths and the fire light share the remap.
  • createGaussianSplats takes outline: { color, width } (width 1 to 4 pixels, needs alphaCut) to draw a dark pixel outline round the silhouette of hard-disc splats, for the pixel-art look (#1744)
  • The path tracer reads ambientIntensity as environment map strength, so a recipe with ambient 0 and dim lamps stays dark in Cook; fillIntensity and world: true are named as rasterizer only in the render report (Part of #1833).
  • A native video frame after the first reads only the scene table bytes that changed since the frame before, so a scene with moving particles no longer moves its static meshes from the page every frame; the video is the same bytes (JS67_NATIVE_EXPORT_DELTA=off reads every table whole).
  • The CPU tracer writes the albedo guide with Cook's definition: the sum of the lobe weights with their Fresnel terms at a surface (it was the base colour), and the Fresnel blend for glass (it was 1), so the CPU albedo sum of the 200-copy scene falls from 35042 to 2542 against Cook's 2489 and the wavelet and OIDN denoisers read the same guide from both tracers; a ray that escapes still writes 1, where Cook writes the clamped sky, because that guide raised OIDN's error on outdoor scenes (#1941).
  • A recipe rect area light takes portal: true, a window Cook samples the sky through; the raster view draws no light from it and scene_inspect names it (#1948).
  • A film or stills job whose first frame compiled kernels now says so in its render report, also in the concise result, and the render estimate no longer counts that one-time compile (#1949).
  • A native render reports its kernel compile apart from trace time: gpuTraceSeconds is the trace, and a compile over one second adds a kernelCompileNote.
  • A material graph has a vertexGroup node: the weight of a mesh vertex group, drawn into UV space per mesh and baked like any other node, so the rasterizer and both path tracers read it (#1957)
  • Render jobs take settings.mattes to write one ID matte PNG per part or material, and src/pass-compositing.js adds Z combine and alpha-over of pass pixels (#1962)
  • Say in the environment tool schema, docs/agent-look.md and the look reference that ambientIntensity also scales the HDRI diffuse light and reflections, so an HDRI-only scene keeps it above 0 (#1983).
  • Fix: the effects tool schema no longer says ambient occlusion defaults to 0.7; it is 0 (off), as scene_capabilities ambientOcclusion and the runtime already say (#1984).
  • Add a Recipes section to the site: an index and three pages (HDRI lighting against a flat key light, ACES against AgX on a warm lamp, a dolly zoom from FOV 75 to FOV 20), each with a before and after picture or clip, a few plain lines and the copyable scene recipe that drew it, also downloadable from /recipes/<name>.json.
  • The home page draws Crucible's quality tier and size bars in the Molten accent, so its numbers stand out from the other engines (#1986)
  • The three-bridge guide and README say to install @codepawlhq/crucible-three-bridge from npm, now that 0.1.0 is published.
  • scene_create accepts camera, light and morph driver targets in motion.drivers, the ones docs/agent-motion.md documents, instead of failing with recipe.motion.drivers.0.target: Invalid input (#1995)
  • motion.tracks is optional in the MCP schema, so a motion made only of drivers no longer needs tracks: []; a motion with neither tracks nor drivers still fails and says to pass one (#1995)
  • Smooth the kettle body on the HDRI recipe page with a denser profile, and dim the lamp shade on the view transform page so the AgX shade stays orange; the page text now says what the pictures show (the bulb turns yellow under ACES and warm white under AgX).
  • The WebGPU path tracer now draws mesh local volumes (environment.localVolumes with shape "mesh" and fit "mesh"): the closed mesh and its BVH ride in the volume buffer and the ray is marched over its inside segments as the CPU tracer does, with a mean FLIP of 0.0020 to the CPU frame on an L-shaped room; before, backend "webgpu" threw and named "cpu". Backend "native" still refuses them (#2004).
  • A light takes maxBounces and the sun environment.sunMaxBounces, a per-light bounce limit like a Cycles light's max_bounces that the native cycles kernel honours; the Blender add-on writes it for lights limited below the scene (#2015)
  • The WebGL (gpu) and WebGPU path tracers draw the rasterizer's flat background colour for camera rays that escape the scene, straight or refracted through glass, when environment.world is false, while every other ray still sees the environment map; only the native Cook kernel still draws the map there and says so in ignored (part of #2016)
  • The CPU path tracer draws the rasterizer's flat background colour for camera rays that escape the scene when environment.world is false, and keeps lighting with the environment map; the other tracers still draw the map there and say so in ignored (part of #2016)
  • A render job that loses its preview browser now fails with a message that names the frame, the size, the passes and --memory instead of "Preview recovery failed after render job", and the server keeps answering (#2018).
  • effects.bloom.strength 0 now means bloom off through one check, isBloomActive, that the renderer asks everywhere (targets, pass, composite, shader step); a strength 0 frame is byte for byte the frame without bloom (#2025)
  • Add a standard view transform (Blender Standard: sRGB encoding, no tone curve, clipped) beside aces, agx and neutral, in the rasterizer, the path tracer and the recipe, MCP and capabilities text (#2026)
  • Icon jobs gain style: "sketch", which inks the outline and hatches the shadow with pencil lines that still read at 64 px; angles: 4|8 draws a turnaround sheet per item, and breakdown: true writes a shaded, outline, hatching, final strip per item (#2031)
  • scene_render_submit takes kind: "icons": render up to 256 GLBs as matching transparent icons (clean or toon, fit or relative scale), with an atlas and icons.json, in one job (#2031)
  • Water: waterRamp paints a sea in 3 to 5 flat tones picked by wave height, facing and the sun, with a crest tint, off by default; its colours are display colours, so a hex stop shows as that hex (#2033)
  • Water: material.contactFoam { width, hardness, noise, drift, color } draws a hard white line, a fixed number of screen pixels wide, where blended water meets a hull, rock or shore, from the depth of the scene behind it. Off by default. (#2034)
  • Water: contact foam skips pixels where the scene behind the water is more than half a metre from the surface (far water, the horizon, sky and shores behind open water), which drew a full-width white band along the far edge of the sea. (#2034)
  • Water: contactFoam.drift (0 to 1, 0 default) makes the rim tear into segments that slide with time; 0 keeps the static rim. (#2034)
  • Water: contactFoam.rim (true default) set to false draws no contact line, for water that meets hulls and shores with no foam edge; the sea's crest foam stays. (#2034)
  • Ocean: foam is where the surface folds (Jacobian), sized to the wind's whitecap share (Monahan and O'Muircheartaigh 1980), coverage (-1 to 1, the foam strength knob) on the ocean edit biases it (0 is physical), foamMemory (0 by default, opt-in, 8 extra wave evaluations per vertex) makes foam fade behind crests, a water material takes foamEdge (soft lace or hard painted shape) and foamWidth, and the docs' open-sea recipe now selects the sheet's edges with { "open": true } so the sea has enough vertices to carry foam (#2035)
  • Water: foamVeins { amount, scale } on a water material adds a net of thin foam veins that trails out behind the crests, thinning and breaking into patches over the sea instead of stopping on one line; off by default, and with it off the water renders byte for byte as before. (#2035)
  • Particles: a groupThreshold surface emitter falls back to the strongest corner when a faint corner leaves no area above the threshold to draw in (#2035)
  • Water: a water sheet no longer casts a sun shadow unless castShadow: true, which removes the dark polygon blocks a sea drew on itself (the shader already dims the sun through the water) (#2035)
  • material.waterGlint adds a hard-edged sun glint and star or dot sparkles to water, off by default; sparkles are four-point stars unless shape says dot (#2036)
  • Water materials take caustics { scale, speed, intensity, depthFade }: a moving, sun-projected net of light on every surface below the water level, shadowed like the sun and fading with depth; off unless given (#2037).
  • environment.sky { type: "gradient", stops, horizonGlow } paints a picked-colour sky with an optional horizon glow band that also lights the scene and shows in water reflections, compensated for the view transform so stops and glow display as their hex and blended in OKLab; the physical sky render is unchanged (#2038)
  • Scenes can build anime cumulus: a cloud geometry (seed, puffs, width, height, flatBase) makes one closed mesh of round puffs that toon-shades into clean lobes (#2039)
  • The cloud geometry grows towers from levels (lobes on the surface of the level before), with upBias, unionSoftness and normals taken from the field gradient (#2039).
  • A material can set toonColors, one linear colour per toon step, so each light step carries its own tint (warm light, cool shadow); materials without it render as before (#2039).
  • An ocean edit with spray: true writes a spray vertex group and surface velocity vector, and a mesh particle emitter takes velocityFrom: "spray" (with velocityScale, and groupThreshold to keep to the strongest crests), so droplets leave crests that are rising with the sea's velocity (#2040).
  • A material snippet on water can define waterHook to run after lighting with the normal, view, foam, time and light, so a few lines of GLSL draw flat tones and hard foam (#2041)
  • Fixed Safari failing to link the instanced main shader ("Too many attributes (gl_InstanceID)"): the instance normal matrix and colour now share three attribute slots, and a test fails when a main vertex shader variant goes over 16 slots (#2042)
  • An unrecognized key in a tool call now names the valid key to use, such as translation for position, and says where lights and sizes live (#2048)
  • An invalid environment.hdri or environment.look now lists the built-in names and the catalog option instead of only the 64-hex pattern (#2049)
  • A scene tool refused while a render job runs now names that job, its frame count and the tool to call next (#2050)
  • A scene_look motionTime on a scene with nothing to animate now reports motionTime: got <your value>, and the stills duration error leads with the fix and a rounded value (#2051)
  • A stills or video job of a recipe whose only moving content is motion tracks (with keyframes at different times), particles, physics or cloth now plays the motion clock from 0 when settings.motion is left out, instead of rendering frozen frames.
  • scene_look and scene_review add a motion-not-set hint when the scene has such moving content and no motionTime was given.
  • scene_inspect and scene_look warn with particle-node-transform-ignored when a particle system node is translated but emitter.position is unset, and the fix names the position to set.
  • A pose that samples particles, cloth or an ocean ranks its new parts against the others, so a blast's dust and rubble on a floor draw without z-fighting or coplanar-overlap warnings.
  • scene_capabilities topic schemas, scene or runtime now answers with the topics that group holds instead of "Unknown topic", and the index no longer reads as if schemas were a topic (#2055)
  • scene_render_result takes images: false to return the output paths without attaching every PNG, and its description says the PNGs are attached (#2056)
  • A terrain whose holes remove every cell is refused at scene_create with the fix named, a hole that removes no cell returns a terrain-hole-removes-no-cell warning with the cell size and the smallest working radius, and scene_export_glb names the node whose mesh has no triangles (#2071).
  • scene_asset_catalog now lists the good files and puts a GLB with a missing sibling image under skipped with the same reason and fix, instead of failing for the whole folder; reading that file by name keeps its error (#2072).
  • glTF files with TANGENT morph target deltas (such as Khronos AnimatedMorphCube) now load: the TANGENT deltas are ignored with a warning, and other unsupported morph semantics are refused with a message that says to re-export the GLB without them (#2073)
  • Fix: tube, lathe, extrude and torus input errors now name the field (geometries[1].path[2], radius, profile, contour, arc, tubeRadius), the value received and a working example; the tube radius and closed checks are two messages, a repeated point names its index and a self-crossing contour names the two segment indices (#2074)
  • An unnamed animation clip is called animation_<index> in scene_asset_catalog, the scene and the exported GLB, and scene_export_glb takes clip as an index or a name (an unknown name lists the valid ones).
  • A two-bone IK target on or next to the root joint now folds the limb and reaches it when the bones are equal, and motionIk[n].warnings carries target-at-root with the distance to move the target off the root.
  • glTF nodes with a scale of 1e-5 or smaller now load at their real size instead of being skipped as singular, and a skipped node's warning names its axis scales and the limit (#2077).
  • Floating bodies damp their vertical speed relative to the water, so a hull or cube on a steep sea tumbles far less (mean tilt 48 to 27 degrees for a flat hull) (#2081)
  • Water with contactFoam now draws its line at opacity 1 as well: a blended batch whose shader reads the opaque scene skips the opaque cutout that ran before the scene resolve, so water no longer needs an opacity below 1 (such as 0.98) for contact foam. (#2088)
  • Fix: curve and curveSet errors for a bad radius (0 or less) or a closed flag that is not true or false now name only that field (radius, closed, splines[1].closed; geometries[i] first in a scene recipe), the value received and an example, instead of one shared sentence that blamed both (#2089)
  • scene_create, scene_apply and scene_capabilities materialFields now accept the material dispersion layer that materialLayers already listed, and a test checks every listed material layer against the MCP schema (#2090).
  • scene_create and scene_apply accept material alphaMode: "add" (additive light), as scene_capabilities topic alphaModes already listed; both read one list (#2091)
  • scene_capabilities topic localShadows now lists areaLights (one atlas tile each), and the shadow atlas error names how many point, spot and area lights asked for a shadow and the castShadow fields to turn off (#2092). An instances.where that drops every candidate point now fails with an error that names the node, the point count and the fix instead of creating no instances (#2094). A grid with spacing 0 on an axis that has several points fails the same way.
  • MCP tool inputs built from a union (a texture resolution of 256, 512 or 1024, a field expression such as instances.where) now answer a wrong value with the field path, the value received and every accepted shape, for example expected 256, 512 or 1024 (got 2048), instead of a bare Invalid input (#2093).
  • scene_render_submit errors for a refused audio file name, a motion or renderer clock past its range and an image job with duration or fps now name the field, the value, the rule and the fix (#2095, #2096, #2098)
  • scene_render_submit now refuses a gpu path tracer backend on a --backend cpu runtime and an ID matte naming a part or material the scene lacks, at submit with the names to pass, instead of queuing a job that fails later (#2097)
  • set-camera accepts fStop: null to turn depth of field off (it clears focusDistance too) and focusDistance: null to clear only the focus plane; fStop: null with a numeric focusDistance says what to pass (#2109).
  • remove-geometry and remove-material on a resource that nodes still use now name the nodes (first 8, then a count) and the fix, and no field error prints an empty "expected one of ." list (#2110)
  • scene_create and set-physics accept the cylinder, cone and compound (with shapes) physics body shapes that docs/physics.md documents, and scene_capabilities topic physics lists them (#2113).
  • A spot angle error names radians and turns a value above pi into "looks like degrees", and an edit that names no field (set-camera, set-node, set-material, set-shadow) is refused with the fields it takes instead of bumping the revision (#2112, #2114). The missing affects node half of this work landed in #2269.
  • Physics joint, cubic keyframe and particle vertex-limit errors name the field and what to pass, scene_capabilities motion names the driver expression type instead of __schema0, and the physics guide's cloth, spray and box-vertex lines match the code (#2115, #2116, #2117)
  • The live game physics now builds cone and compound bodies (up to 16 sub-colliders), so a recipe that bakes with those shapes plays in a game; only trimesh is refused, with a message that lists the live shapes (#2123).
  • scene_create accepts motion properties, the custom, distance and rotationDifference driver variables, every constraint type and chain and spline IK that set-motion and the docs list, and those lists now come from leaf modules the backend shares (#2124).
  • The error tables in the build and render skill references now quote only text the tools return, and a test fails when a quoted message is reworded (#2125)
  • mesh_edit takes split_edges, flatten, circularize, delete_loose and unsubdivide like a recipe geometry edit does, its op list is checked against the engine list at load, and scene_capabilities operations no longer lists edit-mesh and set-mesh-stack, which scene_apply refuses (they are the mesh_edit and mesh_stack tools) (#2126)
  • GLB export keeps a child's transform under a rotated, unevenly scaled parent (the preview rebuilt it with a wrong rotation), writes an emissive color above 1 as a factor plus KHR_materials_emissive_strength, and names the part, its parent chain or the material in shear and emissive errors (#2127, #2129)
  • scene_create accepts the morph motion track that set-motion and docs/mesh.md document, and its kind list now comes from the backend (#2128).
  • scene_export_glb lists what it did not write in an omitted list (motion tracks by kind, the camera, lights), and scene_capabilities has an export topic for what the GLB carries (part of #2130)
  • The build skill and the mesh and point light guides no longer say splat outlines, knife and bisect or point light shadows are missing (#2131)
  • mesh_edit and recipe edits gain transform_selection: rotate (axis and angle in radians) and scale (one factor or per axis) a selection about a pivot, default the selection centre, with the same falloff as translate (#2141)
  • Mesh edits smooth_laplacian (volume-keeping smoothing with a pinned boundary and optional vertex group weights) and warp (carry one point to another with a radius, curve and twist) join the deform modifiers, as edits and stack nodes (#2142).
  • A scene of many parts with a few thousand triangles each, such as Lone Monk, now gets levels of detail by default: addLodsToDenseParts starts at 4000 triangles instead of 20000, which drew 1.06 instead of 1.80 million triangles and took a courtyard view from 4.36 to 3.38 ms on the GPU (a slight change in far detail; #2144). bench/glaze-passes can write a camera move and measure the shimmer and level pops of it (#2157).
  • A scene file now picks levels of detail at lodPixelError 0.5 instead of 1 (about 21 percent more triangles than at 1 on Lone Monk, less shimmer in a camera move); "renderer": { "lodPixelError": 1 } restores the old choice (#2157).
  • A touch game can draw its stick: startGame takes touchControls, and exported pages show a ring and knob under the finger on a phone (#2148)
  • A particle emitter on a sea animated by an oceanTime track now takes its droplets from the crests of each particle's birth time, and the "Spray from the sea" example in docs/physics.md is a whole recipe that scene_create accepts (#2152)
  • A portal area light (portal: true) no longer lights the light bake, the object reflection probes or the room bounce estimate as if it were a panel, and is no longer named as the strongest light to turn down (#2153).
  • The Glaze sun disc is drawn per pixel at sunAngularRadius with a screen-space anti-aliased edge instead of baked into the 1024x512 sky map, so it stays a sharp round disc of the right size at any field of view (#2164)
  • The window room's floor sky trace no longer lights bright slivers at the back wall's corners: a wall end or floor rim buried in the wall beside it is read as occluded instead of smearing a half-lit value onto the visible face (#2166).
  • Studio has property panels for lights, the sun, the camera, the world, fog, film, effects, shadows and quality, laid out one line per row in groups that fold; its panels dock to the window edges by default, the axis widget sits at the top right, and floating cards resize one at a time (#2177)
  • Studio pauses the picture with a notice and a Reload button when the browser drops the WebGL context or a frame throws, and draws again by itself when the context returns instead of freezing for good (#2739)
  • Studio's bundled HDRIs (sky-clouds, studio-softbox) and looks (teal-orange, noir) now load in the page build with no catalog folder, so the World HDRI choice no longer snaps back to None (#2177)
  • Studio shows the recipe validation message instead of "nodes.some is not a function" when the Recipe JSON dialog gets nodes that is not a list (#2177)
  • Ctrl or Meta with a double click on a floating card grip puts both cards back to automatic in that direction, as Ctrl-drag and Ctrl with the arrows already change both (#2177)
  • In a compact window Studio's Properties card starts right of the tool rail and the Scene and Properties cards share the height without overlapping (#2177)
  • Studio's Web pack export refuses a scene with imported textures (placed catalog scans) by naming the part and offering GLB export, instead of "got a ImageData; expected plain data" (#2177)
  • Studio's Material tab has a Clearcoat roughness slider and a Double sided switch, and moving Clearcoat no longer resets a coat roughness already chosen (#2177)
  • Studio copies the selected object with Ctrl+C and pastes a copy with Ctrl+V (Edit menu and Help list too), as one undo step that still works after the original is deleted; the keys stay with the browser while typing or while text is selected (#2177)
  • Studio keeps unsaved work as a draft in localStorage and, on the next start, offers Restore or Discard when it differs from the scene that opened (skipped above about 2 MB, cleared by Save, New and Open) (#2177)
  • Studio: the Scene list and Properties keep an outline and a gap in the docked column, so they read as two cards (#2177)
  • Studio marks the file as unsaved after a camera, lens or view edit (orbiting still does not), and picking a mesh after the Sun, a light or the camera leaves the Look or Camera tab instead of leaving the Properties card on the old object (#2177)
  • Studio undo and redo apply the difference to the scene in place when only fields, materials, looks or sections changed, so a large scene no longer freezes for seconds on each step; adding, deleting or a change that removes a field still rebuilds it (#2787)
  • Studio keyboard shortcuts keep working after a drag on the timeline or a slider; before, the tools, play and keyframe keys were ignored until another control was clicked (#2177)
  • Studio is now one full-screen viewport with floating controls and icons, its handles follow the object's own axes, the selected object gets an outline, undo takes back one whole drag and leaves the camera alone, and the colours and fonts come from the brand kit. Studio is no longer a page of the public site: it stays an addon that an app embeds, with a development page under bench/studio. When an agent edits the scene, a pointer with the agent's name, in a colour of its own, travels to each object it changed. The viewport gains working aids: a ground grid in metres with the X and Z axes, a view widget that snaps to the main views, and a readout of the camera and the size of the selection. Move handles end in arrows, and Studio opens on a plain blockout scene of three grey primitives. Turning a ring shows where the turn began and a faint wedge over the angle turned so far. A drag leaves a dashed outline where the object was, a move also draws the line it has travelled, and a new object lands beside the ones already in the scene. Studio is split into three workspaces that follow the work from left to right, Build, Look and Animate, each showing only its own panels, so the timeline no longer covers the readout; scene rows draw the shape of each object, a selected row has one highlight, and the toolbox gaps are even. The Scene card moves to the right with Properties under it, across from the tools; Studio gains Blender keys (Shift+A, Shift+D, X, Esc, 1/3/7, N, I) and a Settings dialog for the snap step and angle, handle size, starting workspace and what the viewport shows, kept in the browser (#2177). The top bar now has File, Edit, View, Agent and Help menus with the key beside each row, the handle under the pointer lights up, the dashed drag trace shows on any surface and an axis that points at the camera stays long enough to grab. The Scene and Properties column sits on the right, across from the tool rail, the Scene head has a search button and an add button, the Add menu gains disc, ring, arch, vase, star, 3D text and an area light, handle heads show a border only under the pointer, and the top left shows the Crucible mark. The selection outline now follows the object's shape, F flies the camera to the selection in a third of a second, the grid covers the floor and changes its step with the zoom, and zooming far out keeps the floor and the scene in view. The add menu has thirteen more shapes (capsule, dome, pyramid, prism, hexagon, wedge, pipe, gem, heart, bowl, spring, knot and stairs), each an ordinary recipe geometry, shown in groups. The panel column can be resized by dragging its inner edge and the gap between its cards (floating, each card resizes on its own by its left and bottom edges, Ctrl resizes both, and the axis widget moves to the top right beside the column), each card folds down to its head, the rail has one line between the tools that change the scene and the switches that show or hide things, and Export is a plain white button. The bar, the rail and the column dock to the window edges by default and the scene is drawn in the room they leave, at its true proportions; Floating panels in Settings puts them over a full-window scene instead. G, R and S now pick the selected object up under the pointer as Blender does: X, Y or Z keeps it to one axis, a click places it, Esc puts it back, and a pill names those keys while you hold it. A right click on an object, in the viewport or the Scene list, opens a menu of its actions, H hides the selection and Alt+H shows everything again, and Alt+G, Alt+R and Alt+S reset its position, rotation and scale. Menu rows carry an icon where one fits. The move, rotate and scale handles answer a press within 11 pixels of an axis or ring and 16 pixels of its tip, while the drawn handle stays thin.
  • Studio: on a scene whose camera a motion track moves, orbit, zoom, pan, F and the view presets now move a free view of the viewport, where they used to do nothing; View → Animated camera returns to the animated camera.
  • Studio: the scene camera, the sun and every light are now objects in the Scene list with marks in the viewport; click to select, drag a light with the Move tool, press Delete to remove a light, and the controller gains listSceneObjects, selectSceneObject, moveSceneObject and deleteSceneObject.
  • Studio: a selected light, the sun and the camera now have property panels laid out like Blender's Object Data tab (light color, intensity, radius, range, shape, shadows and position; sun strength, color and size; camera focal length, sensor, clip planes, shift, depth of field, eye and target). Every edit is one undo step, fields a motion track drives are locked and marked, and a change an agent makes shows in the controls; the controller gains updateSceneLight, updateSceneCamera and describeSceneObject.
  • Studio: the Look tab now edits every environment, effect and shadow setting an agent can write, laid out like Blender's World, Render and Film properties: the HDRI, sky, daylight, fill and ambient strength, fog and volume fog, exposure, temperature, vignette, grain, ambient occlusion, bloom, depth of field, motion blur, the shadow box and the render quality switches. Property groups fold and stay as you left them, fields a motion track drives are locked and marked, and a change an agent makes shows in the controls; the controller gains updateSceneShadow.
  • Studio: the property panels are one line per property, as in Blender: label on the left, control in a value column on the right, switches for toggles, a slim slider with its value for bounded numbers, a smaller sun pad beside its label and lens presets inside the Lens group. Group titles stay at the top while their rows scroll and only the first group of a tab starts open. Angles show in degrees, lengths in metres and lens values in millimetres as a quiet unit, numbers show three decimals at most, an HDRI the list lacks shows as Custom and its first characters, Properties takes the rest of the column below a Scene card of at most 35 percent, and the column scrollbars are thin (#2177).
  • Added crucible/addons/studio (createStudio and createStudioController) and the /studio.html browser Studio for viewport picking, transform and surface-snap gizmos, look and material sliders, timeline scrubbing and camera bookmarks on the shared agent recipe (#2177).
  • crucible pack stores reflection probes as RGBE bytes instead of Float32, which cuts the gzip data of a scene with metal parts by 55 percent (#2178)
  • crucible pack now carries a recipe's baked lightmaps: the bake runs in Node at pack time, the texels travel as bytes, and <crucible-scene> draws them with no bake code and no tracing on the page; a bake over 262,144 texels is refused with the field to lower (#2178)
  • crucible pack renders the poster itself in headless Chrome (--poster-size <w>x<h>, default 1280x720, writes poster.webp); --poster <picture> uses your own and --no-poster skips it (#2178)
  • <crucible-scene> takes scroll="orbit 0 90", hover-tilt="6" and view="close" attributes that move the camera from the page, drawing frames only while one is moving (#2178)
  • crucible pack <scene.json> --out <dir> compiles a recipe into a runtime-only web bundle, and <crucible-scene> shows its poster at once and swaps in live 3D without the recipe compiler (#2178)
  • Live loops sleep at zero draws when idle and pause offscreen, and an opaque HDR canvas stores its frame as R11F_G11F_B10F, 39.55 MB less at 1080p with 4 samples (#2179)
  • A native video frame whose scene table changes length (a particle part under flush ranking) now sends the changes in the bytes it shares with the old table plus the new tail, instead of the whole table: on the particle clip a frame sends about 50 percent of the tables where it sent 76 percent; the video is the same bytes (#2180).
  • A render job whose scene could not be created in its page now reports that failure instead of the cleanup's "No scene is active: ... at Object.dispose", because after a failed job an error from its cleanup never replaces the job's own (#2198)
  • A render job whose page navigates or reloads now fails with that cause, the frame, the memory budget and the estimate instead of a stale reading 'dispose' error, a preview timeout names the operation that ran long, and a hung browser no longer delays the next scene_create (#2198, #2200)
  • Estimate job output bytes at scene_render_submit to catch stills past 128 MiB early, and keep complete leading frames readable when late overflow occurs (#2199).
  • A mesh box base with bevel 0 now honours subdivisions: each face becomes an n by n grid welded at the edges, instead of 8 vertices (#2201).
  • A scene with more than 200000 triangles and a smooth metal part no longer fails with "Light bake takes at most 200000 triangles" when no bake was asked for: the automatic object reflection probes are skipped and the sky reflection stays (#2202).
  • A box particle emitter no longer gets a radius: 0.5 written in (a stored one is dropped on load), and set-particles on a node added in an earlier batch now renders instead of failing with "Unknown part identity" (#2203, #2204).
  • Volume fog no longer makes scene_look fail with "WebGL render failed with error 1282" on the first frame after the canvas changed size (#2205)
  • Align scene_capabilities, docs and error text with what the validator accepts: pattern colors takes three colours only for bricks (the error says so), meshEdit and meshStack topics list the modifier ops (wave, ocean, ...) and point to meshModifiers.<op>, particle stop is described as an absolute time, and a scene_review shot with fov now works on a scene camera that uses focalLength (#2206).
  • A coplanar-overlap warning no longer flags parts 100 mm or more apart, however large the scene (#2207)
  • An explicit keyColor, fogColor or fogDensity now wins over a physical sky preset instead of being replaced by the colours the sun derives (#2208)
  • scene_asset_catalog and name placements look at the --assets folder again, so a GLB, image or HDRI downloaded mid-session is listed by the next catalog call and placed by name without restarting the server; a removed file leaves the list (#2209)
  • Warn when a whole part hangs off its support: scene_inspect, scene_apply and scene_review list an unsupported-part warning with the unsupported share when under 70 percent of a part's footprint has a surface within 2 cm below it (#2210)
  • Baked light no longer steps across the seams of a curved mesh: the unwrap leaves two and a half texels between charts and the smoothing averages over the same patch on both sides of a chart edge (#2212).
  • User post passes get one edge antialias step after the last pass, so lines drawn from worldPointAt and the other G-buffer reads no longer stair-step; postPassesAntialias: "off" keeps the exact pixels (#2214)
  • The Object studio shows a laboratory student microscope (CC BY 4.0, "Microscope" by Eugen Vahrushin on Sketchfab, taken from the Objaverse mirror and credited in THIRD-PARTY-NOTICES.md) instead of the procedural robot; crucible/addons/model now also exports assembleSampleModel and loadSampleModel (createModel stays unchanged as public API until #2818), public/wall-e.glb became public/sample-model.glb (the old URL has no redirect, and no page, doc or smoke script names the old robot any more), and the finish swatches and the export:model script are removed; the source is one mesh, so scripts/build-sample-model.py splits it into 14 named parts (base, arm and head, condenser, rack post, two focus knobs, stage, stage clips, nosepiece, three objectives, head cap, eyepiece tube) that keep its PBR textures with clearcoat, the exploded view lifts each part clear of the others so the set stays together, above the floor, and the studio frames the exploded pose from its bounds, relights the model and lifts the floor tone (the floor shader now scales its tone by a custom floor colour; the default is unchanged), and the microscope studio fill is 0.3 (#2218)
  • Docs: new learn pages and 'Look and light' and 'Ship to the web' nav groups; preview pictures stay as they were (part of #2219).
  • scene_inspect and the scene_apply answer carry a reflection-skipped diagnostic when smooth metal keeps only the sky reflection because the automatic object probes were skipped (over 200000 triangles, or too many parts); it names the triangle count, the limit and the fix (#2221).
  • displace along the normal no longer folds a welded, sharp-edged mesh over at its edges: sharp vertices move to the meeting point of their sides and the move fades to zero toward the edge over a band of twice the largest move, so the face eases into its rim with no lip or fold; smooth meshes are unchanged (#2224).
  • A path traced render job on a scene with postPasses now reports a post-passes-skipped warning in metrics.diagnostics that names the passes it did not run, and the path tracer and user pass docs say so (#2226)
  • A path traced job that asks for renderer.backend "native" without the native tracer now reports backendFallback (requestedBackend, usedBackend, fallbackReason) and adds that reason to a later failure such as the gpu triangle limit.
  • A path trace over its triangle limit now says how many triangles came from expanded instanced copies and how many are unique, and suggests fewer copies, a simpler GLB or the Glaze renderer (#2228).
  • A water material is traced as a glossy dielectric (IOR 1.33, transmission, absorption from its absorption and turbidity) and fogDensity with world: true is traced as a uniform haze medium, so path traced water and distance haze no longer render as a flat matte surface without haze (#2230)
  • The glTF loader skips a meshopt view with count 0 that no accessor reads (with a warning) instead of refusing the file, prepare-hero-glb no longer writes one, and the Dark store showcase scene gets its camera so it opens in the showcase page (#2235)
  • The WebGPU path tracer (backend: "webgpu", megakernel) keeps parts that share one mesh as instances, like the gpu backend, so the triangle limit counts a shared mesh once and memory grows with the copies, not their triangles (#2239)
  • The WebGL2 path tracer (backend: "gpu") keeps parts that share one mesh as instances, with one bottom-level BVH per mesh and a top-level BVH over the copies, so the triangle limit counts the mesh once and a scene of nine nodes sharing three 300,000 face meshes renders instead of being refused at 2,000,000 (#2239)
  • The Object studio footer and its Measure performance button no longer draw over the settings panel (#2241)
  • Fit the Object studio toolbar on one row at 1024 px so Reset view and Export GLB no longer wrap or clip (#2245).
  • The scene skill has two new references, materials.md (colour, patterns, glass, water, shader hooks) and particles-and-vfx.md (caps, spray, dust, sparks, sea foam, fog and beams), so agents stop rediscovering their limits by trial (#2247).
  • The scene skill now says point and spot lights scatter in volume fog (up to 8, no shadows), and the physics guide names the baked gas solver behind add-explosion and grid volumes instead of saying smoke and fire are not built (#2251).
  • The Object studio Auto orbit button now sits in the bottom bar beside Measure performance, so it stays fully visible at 1024x768 and 1280x720 instead of being cut off by the settings panel (#2254).
  • A skin worn by many primitives now counts its joints once against maxJoints, so a 153-joint rig on 12 primitives loads through scene_create instead of being refused at 1860; the memory the pose copies hold is bounded by maxDecodedBytes (#2259).
  • A glTF texture with a NEAREST sampler now renders hard-edged instead of blurred by anisotropic filtering (#2260)
  • A scene that places an asset clip plays it from settings.animation or a default-length render, with no motion track (#2261)
  • The unsupported-part warning no longer fires on a part turned about the vertical axis that rests flush on its support: a support coplanar with the part's base is found, and probes outside the part's real outline are skipped (#2263).
  • scene_apply with branch now works on a scene that places catalog assets: the host loads the assets for the branch's scratch copy, as it does for scene_create.
  • scene_review accepts projection and orthoScale on a shot camera, samples the scene camera the way a look and a render job do, and sets rendererTime from the shot's motionTime when it gives none; a user post pass reads the shot's motionTime as its clock, as in a look and a render job (#2268).
  • A light's affects error names the list you set (environment.spotLights[2].affects, pointLights, areaLights or keyAffects) instead of always environment.keyAffects, and says that group and placed-asset nodes are not accepted (#2269)
  • Render jobs retry a blocked status.json rename for under a second and keep the last good status with a warning instead of failing the job (#2270).
  • showcase.html?scene=<name> now says so when the scene does not exist, naming the request and the scenes it has, instead of silently opening the airport (#2271)
  • A splat material on a terrain compiles and draws without grass in the scene, and no longer breaks every draw beside a blended shadow caster: the splat weight mask moved to unit 13 so the tinted shadow map shares a unit only with a sampler of its own type, and layer textures are only refused beside splat layers when a layer texture is in use (#2272)
  • The dev server builds release.json, changelog.json and api-reference.json on request when public/ lacks them, so the home, changelog and docs pages load without errors in a fresh checkout (#2278).
  • environment.skyTop and skyBottom now draw as the background gradient when world is true with a setup sky, instead of being ignored; the setup still lights the scene (#2280)
  • A placed asset takes clip: { index: "all" } to play every animation of a GLB together, and scene_inspect warns when a single clip leaves out animations that move other nodes (#2281)
  • A user pass that calls helper functions without loops no longer counts each call as a loop iteration, so a 3 x 64 loop is 192, not 5376; the over-limit error now lists which loops add up (#2284).
  • A render job store that is full releases completed jobs whose result was already read, oldest first, before it refuses a new job, and the refusal now names scene_render_release with the MiB needed and free (#2286)
  • scene_create now says why it closed older scenes (evictionReason: the 4-scene cap or the 96 MiB geometry cap, with the sizes), and a later call with that ID repeats the reason (#2287)
  • scene_apply set-motion takes removeTracks selectors, so one camera or node track is dropped without sending the whole scene again (#2288)
  • A part with foam or a wear mask, such as an ocean with a water material, now counts in the placement check, so a buoy on the sea is no longer reported floating above a far backing plane, and specular and specularColor are no longer reported as ignored on a water material (#2288)
  • Post passes read the camera eye as the cameraEye uniform, and a motion track holds up to 256 keys instead of 64 (part of #2288).
  • The explosion smoke holds up close: grid volumes take noiseAmount, noiseScale and noiseOctaves as fine detail on top of their cells, and add-explosion sets them, with a cooler, redder flame (1300 K to 1900 K) that reads closer to Cycles (#2289)
  • A native trace that succeeds no longer reports a backend fallback and fails its job with "Snapshot must contain finite, acyclic JSON"; a real fallback always names a reason.
  • A closed room built from default-bevel boxes now gets a room-edge-leak diagnostic from scene_inspect: the rounded edges leave open grooves at every join, and light shines in at the corners (#2291).
  • User post passes get pixelFootprintAt(uv), worldFootprintAt(uv, direction) and bandLimitedLine(coordinate, pitch, width, footprint), so a pass that draws thin lines or grids can filter them instead of shimmering at a distance: far-view error against a 3x reference falls from 46.0 to 26.5 on the iso-line example (#2293)
  • A thin water part (its height at most a tenth of the water column down to the bottom of the scene) now carries an absorbing medium under its footprint in a path trace, with the water's absorption and turbidity as extinction, so a sheet over a bed tints the bed like a deep body does on the CPU and native Cook tracers (#2294)
  • A closed room built from boxes that touch (four or more touching pairs) is drawn with sharp box edges at its joins, so the sun, the sky and lamps no longer shine through a groove along every edge of a sealed room (#2298).
  • A test pins that a part of a baked closed room keeps its light when a bulb mesh surrounds the point lamp (#2299)
  • A glowing lamp mesh drawn around its own point light no longer shadows that light in the WebGL2 path tracer and light bake, so a closed room with a bulb traces lit instead of about six times too dark (#2299).
  • A lamp mesh drawn around its own point light no longer shadows it in the recipe bake, so a closed room with a glowing bulb bakes lit instead of about forty times too dark (#2299).
  • The CPU path tracer absorbs light inside glass and water: a transmissive part with attenuationDistance multiplies the light by attenuationColor per attenuationDistance metres of path inside it, as the rasterizer and Cook do (#2300)
  • A large ground with thousands of instanced copies no longer fails scene_create with "Map maximum size exceeded": the coplanar search makes its grid coarser when it would list over 16 million cells, and a grid still too large names environment.resolveCoplanar (#2302)
  • Explosion dust is a soft warm-brown haze of large overlapping puffs, drawn with the new opt-in material value softEdge (alpha fades toward each puff's silhouette), instead of opaque dark cubes (#2304)
  • A scene builds the same parts whatever was built before it in the same process: the flush ranking and the floor sky trace run for a scene only when the host loaded every module or the scene itself asked for them (#2305)
  • Tests pin that render-media --scene file poses the glTF clip, including in scenes with water reflection (#2308)
  • render-media --scene file plays the first animation clip of the scene's GLB on a loop, so a rigged character no longer renders frozen in its bind pose; a GLB without a clip renders as before (#2308)
  • render-file-native.mjs poses the glTF clip before the native trace, at the new --time <seconds>, instead of tracing the bind pose (#2310)
  • scene_look at a motionTime gives post passes that time as their clock, like a render job frame, so a beam anchored to a moving part no longer draws detached in the look (#2315)
  • scene_render_result attaches no pictures for a job of more than 8 files and returns paths and byte counts; images also takes up to 8 artifact indexes to attach chosen frames (#2316).
  • The CPU path tracer's shadow rays step through glass and water instead of stopping at them: each face keeps its Fresnel transmission, the part's transmission and colour, and the length inside absorbs by Beer-Lambert, so tinted water casts a lighter, tinted shadow (#2318)
  • Reuse the audio bus gain node when createBus names an existing bus, and make videoFrameCount refuse a bad fps or duration (#2336, #2337).
  • Cloth refuses out-of-range damping, friction, thickness, stiffness, bend and density and a triangle that names a missing particle with an error that says which, and the scene_inspect path error shows a position the query accepts.
  • Curves with a repeated point keep a unit direction when resampled and stay one point when filleted, and a mesh edge loop that meets a junction becomes a closed spline (#2345, #2346, #2347).
  • createTerrain refuses more than 64 chunks or 4096 cells per side, sampleRasterGrid refuses a raster whose values, box or sampling options cannot give a mean, and createHeightfieldGeometry gives finite normals for a one-column or one-row grid, all with errors that name the field (#2348, #2349, #2350)
  • A glowing lamp mesh drawn around its own point light no longer shadows that light in the CPU and WebGPU path tracers, as in WebGL2, so a closed room with a bulb traces lit instead of dark (#2353).
  • Mesh bevel refuses a width of 0, and mesh boolean names a null mesh or cutter or an unusable cut tag, and turns a solver failure on extreme sizes into a clear error (#2355, #2356, #2357).
  • Camera samplers name a bad roll override, reject sparse frames and refuse a null, string or infinite sample time on both forms (#2358, #2359, #2360).
  • A drive option that is NaN, a negative suspension travel, or a drive longer than an hour now throws an error that names the field instead of returning NaN poses or failing with an allocation error (#2361, #2362).
  • GLB export refuses animation keyframes of the wrong width and cubic keys without tangents, and a node list whose parents form a loop, each with an error that names the track or node instead of a misaligned accessor, an unnamed TypeError or a stack overflow (#2365, #2366, #2367)
  • Skinned world bounds now divide vertex weights by their total as the renderer does, a crowd rig refuses out of range skin joints and zero weight totals, and a foot placement recovers after a frame with a NaN foot position (#2369, #2370, #2371).
  • selectEdges now refuses open combined with along (or any other key) and names both, and projectUv and packUvIslands refuse a non-boolean pack or rotate instead of treating a string as true (#2373).
  • A look-at with no good target keeps a finite aim, a constraint influence that turns NaN names its constraint and node, and baking a crowd clip no longer keeps every skinned vertex in memory (#2377).
  • Splat PLY loading drops a splat whose position is past the float32 range instead of loading an infinite position, and a PLY header over 64 KiB is refused with a message that names the limit instead of "Not a PLY file" (#2379, #2380).
  • Reject a glTF export skin joint index at or past the skin joint count, naming the part, vertex and joint count (#2381).
  • Fix walkableMask hanging on an infinite or huge keepOut (and refuse NaN or negative values), createNavmesh hanging on an agent radius far above the cell size, and accept only whole-number navmesh indices.
  • Wear packs a NaN vertex weight as no wear and refuses a dirt group with a different weight count, the material graph refuses a bake resolution that is not a whole number of at least 1, and a sliced texture upload refuses a fractional size and names the field in its errors (#2387, #2388, #2389)
  • Particle colliders no longer let a path through a shared triangle edge or vertex fall through the mesh (#2390).
  • Field rotate, align and transform errors name the operand that is not a vector (#2391).
  • Fixes from a sculpt, settle and rig bug hunt: settle finds the ground under colliders above 10 km (#2393), a humanoid or quadruped preset fitted to a flat mesh is refused instead of collapsing every bone to one point (#2394), and sculptGeometry refuses unknown stroke fields and a direction on a stroke that ignores it (#2395)
  • A one-shot game timer shorter than a nanosecond now fires, unbindAction and unbindAxis drop the last sample at once, and bindAxis refuses a misspelled field such as deadzone (#2396, #2397, #2398)
  • Material graph errors name the missing or wrong input (hue "color", curve "value", add argument 2, output "roughness") and what came instead, and a one-argument operator given three numbers says how to pass a vector (#2403)
  • Six fixes from a bug hunt (#2403): navmesh.findPath refuses a route with more than 200 corners instead of returning more points than its limit; a path follower skips repeated points instead of slowing at them as at a corner, and gives up with status: "stuck" after stuckSeconds (2) blocked on every side; walkMap({ lowerPass: null }) and a game with too many animated copies of one asset now say which field or limit is wrong; an input axis whose bindings sum to Infinity minus Infinity reads 0 instead of NaN; and loadTextureSet keeps a query string or hash on baseUrl after the file name.
  • An IES profile with a hole in its arrays, or with no light from 0 to 90 degrees, and a wake point with a hole or a width over 1000 metres now throw an error that names the field and the limit instead of giving NaN or a black light (#2405, #2406, #2407)
  • createTree refuses a height outside 0.01 to 1000 m, createGrassClump refuses a bad blade radius, and scatterVegetation, createGrassClump and createFlowerPatch refuse a seed that is not a finite number, instead of building NaN geometry, running out of memory or quietly using seed 0 (#2408, #2409, #2410)
  • Boat and float input checks: a rejected setBoatControls call leaves the live controls as they were, a missing controls object names what to pass, sparse point, stern and keyframe arrays fail with their index, and boat.forward must be a string axis.
  • The motion page reads an empty width, height, samples or memory option as its default and rounds a fractional value, as the film page already did (#2414)
  • sampleFilm names the aspect when the portrait shots cannot frame a very narrow one, like the other shots (#2415)
  • Refuse a mixer play() timeScale beyond 1e6 or offset beyond 1e9, hold the graph speedParameter multiplier to 0 to 100 and keep 2D blend weights summing to 1 when positions overflow (#2416, #2417, #2418).
  • Zero-area and non-finite inputs in closestPointOnTriangle, simplifyGeometry and recomputeNormals now return the nearest edge point or throw an error that names the vertex (#2420, #2421, #2422).
  • A drag force field on cloth no longer blows the sheet up at strengths of 500 and above: a drag slows a particle to rest and never carries its velocity past rest (#2424)
  • The distortion and flash steps no longer throw when the scene clock passes an hour or a followed node has no usable position, and a null inside a three-number post field is refused instead of read as the default (#2426, #2427).
  • Cloth self collision on a mesh with two vertices at one point names those vertices and says to weld them, instead of blaming a radius the caller never gave.
  • Gaussian splats: a rotation of any length packs its unit covariance, createGaussianSplats checks bounds at the call, and the sorter re-sorts tiny scaled scenes (#2435, #2436, #2437).
  • Kernel offload: a build cancelled during a page kernel stops at once, kernel keys tell 0 from -0 and sparse arrays from dense ones, and a malformed worker request names the field it lacks (#2438, #2439, #2440).
  • The mesh library functions remeshMesh, unwrapUv and generateGeometryLods refuse a bad resolution, voxelSize, maxDistortion or smoothAngle with an error that names that field, instead of blaming another field, failing late or ignoring it (#2441, #2442, #2443)
  • A motion blur previousCamera with a non-finite eye, an eye on its target or a parallel up now throws an error that says what to pass (#2446)
  • A mesh volume part with a non-finite or short matrix now throws an error that names the part (#2447)
  • A mesh volume part with out-of-range or partial-triangle indices now says so instead of reporting an open mesh (#2448)
  • fractureMesh, fragmentPhysics and registerExplosionGrids name the bad field when given NaN geometry, a stray index, a zero or NaN density or an unknown fuel (#2449, #2450, #2451)
  • A glTF whose children, animation channels or samplers, extensionsUsed or extensionsRequired is not an array, or whose node or mesh name is not a string, now fails with an error that names the field instead of a raw TypeError (#2452, #2453)
  • parseRadianceHdr names the accepted input and refuses a header that claims more pixels than the file holds before allocating them, keyLightFromHdri says which bounds to pass, and GLB export checks maxTextureSize before reading a texture's pixels (#2454, #2455, #2456)
  • createGrass and createClutter throw an error that says what to pass for a zero or NaN clumpSize, a clumpStrength outside 0 to 1, a bend that is not a finite pair, and an infinite height, width, rock or pebble size or tile size, instead of building NaN blades or nothing (#2460, #2461, #2463)
  • glTF MAT2 and MAT3 accessors of byte or short components now load the values the file stores instead of shifted ones (#2462)
  • glTF errors for a node mesh, an accessor count and a node child name their path, and a string POSITION index no longer loads (#2464)
  • AdaptiveResolution, estimateTextureBytes and the budget error refuse an infinite target, huge texture sizes and an infinite suggested budget (#2465, #2466, #2467)
  • Export writers refuse inputs that used to produce corrupt files: a null compressed mip level, a zero, fractional or too short PNG, and NaN or ragged GLB accessor data (#2471, #2472, #2473).
  • The particle playback test counts integration steps instead of timing them, so it no longer fails on a loaded machine (#2475)
  • Refuse an over-budget bakeGasSim up front with the sequence limit bakeGasSimToGrids already used, and refuse a sparse burstPosition that baked NaN (#2476, #2477).
  • Per-node line art no longer throws "Maximum call stack size exceeded" when one node owns over 100,000 object IDs (#2478).
  • sdf geometry refuses sizes, positions, scale, offsets and blends beyond Float32 range instead of returning NaN positions.
  • Sparse arrays in sdf vectors and children, curve points, handles, taper and profile, and tube or extrude point lists are refused with an error that names the field.
  • Retargeting refuses a bone mapping that repeats a joint or names an unknown bone, rig joints with a zero rotation or a non-finite translation, and a crowd seed that is not a whole number from -2147483648 to 4294967295 ; a scene recipe names a fractional crowd.seed at validation (#2487, #2488, #2489)
  • Streaming fails an asset whose loader resolves with no asset instead of leaving it pending, keeps resident assets when a load can never fit the budget, and createTileField rejects an inverted area or a non-positive tileSize (#2490, #2491, #2492).
  • Live physics raycast, shapeCast and overlap now see the starting world before the first step instead of returning nothing, and createPhysicsSystem rejects bindings that are not an array of { body, part } with an error that says so (#2493, #2494).
  • Refuse invalid angle, sides and index options in joinTriangles, dissolveLimited, fillHoles and createTriangleSurfaceIndex instead of joining, filling or rounding silently (#2500, #2501, #2502).
  • Surface attachments reject only a zero-area bound triangle, not any zero-area triangle of the mesh (#2503)
  • An asset character whose file has no animation clips now throws a message that says so, not an index range from 0 to -1 (#2504)
    Skeleton poses refuse rig rest values that are NaN or a zero quaternion, custom solvers without joints or solve, and an aim solver whose joints is not a list.
  • Refuse a texture sequence frame list with holes at the missing frame, and give the whole-number error of bake counts an example inside the field range (#2508, #2509).
  • Fix three bad-input holes in mesh recipes, imports and exports: an edit op named like an Object.prototype key now lists the valid ops, OBJ and STL export refuse a matrix that overflows the file, and editImportedGeometry refuses short skin or morph arrays. (#2510, #2511, #2512)
  • Mesh modifier edits now refuse null for an optional field (axis, cyclic, replace, falloff and the like) instead of silently using the default.
  • Mesh editing refuses to remove an element twice, to create a face over the vertices of an existing face and to take a fractional vertex index, instead of corrupting the element lists (#2516, #2517, #2518)
  • subdivide_edges no longer fails on a mesh with UVs when it splits all four sides of a quad, and it, bisect_plane, knife_project and bridge_edge_loops now give their new points the blended vertex groups of the points around them (#2524, #2525)
  • A glTF weights animation moves only its own node, no longer the morph weights of its child nodes (#2526)
  • A motion layer mask whose exclude covers all its joints is refused instead of loading a layer that moves nothing (#2527)
  • A selection rule that lists more faces than the mesh has now says how many it listed (#2528)
  • Mesh lint keeps part pairs distinct past 1000 parts, and a drive path that is not a list of points says so.
  • Refuse non-finite positions in updatePartVertices, name the shape key in its edit errors and say so when an edit leaves no faces (#2531, #2532, #2533).
  • Inspect no longer calls a geometry used only as a boolean cutter unused, and the fitted near plane leaves an invalid far plane to the camera check (#2534, #2535)
  • A subsurface block now rejects inherited names such as constructor as unknown fields (#2538).
  • The real-time tracer refuses a historyLimit below 1, createProgressiveTracer refuses resolutionDivisors that are empty, fractional or do not end with 1, and denoiseRadiance refuses a buffer shorter than width times height, instead of blending past the new sample or returning NaN.
  • The asset and nature viewers open with default quality when ?samples= or ?memory= is not a usable number, unknown code languages show as plain text, and live example sliders with step="any" show their fractions (#2546, #2547, #2548)
  • A render target of infinite size, a shader program that failed while preparing, and a mesh volume buffer wider than the texture limit or left half built now fail cleanly instead of corrupting totals, hiding the shader log or leaking GPU objects (#2549, #2550, #2551)
  • Scene file density options refuse a pixel ratio outside 0.1 to 16 and NaN triangle thresholds by name, and a vegetation scatter that excludes around a node regrows when that node's parent or the ground moves (#2552, #2553).
  • withSunBounce and attachWaterReflection refuse a NaN or out-of-range environment.sunBounce, mirror scale or updateEvery with an error that names the range, instead of NaN lights, a 1 pixel or giant mirror target, or a mirror that never redraws (#2555, #2556)
  • Leaf and bark texture names such as constructor now fail as unknown kinds, and bakeImpostorAtlas refuses a frameSize outside 8 to 512 instead of returning an empty or unbounded atlas (#2557, #2558).
  • build-pack-index keeps the previous output folder when a build fails, and refuses a misspelled or repeated flag (#2562, #2563)
  • check:tool-schemas now fails on a portable schema finding, check:change-note fails on a note with no bullet, and the coverage gate fails when branch or function records are missing (#2567, #2568, #2570)
  • Refuse a non finite sun direction, an empty depth range and a zero shadow extent in resolveShadowLight and shadowBiasPerSlope instead of returning a NaN eye, Infinity or 0 bias.
  • Job script guards: the MCP log summary skips lines that are not call records, the native memory allowance refuses a NaN or negative --memory budget, and a GLB whose JSON chunk runs past the file gets a clear error (#2571, #2572, #2573)
  • scripts/downsample-hdr.mjs refuses a target size above the source or not a whole number instead of writing a broken sky (#2574)
  • scripts/recode-glb-textures.mjs leaves URI images alone instead of crashing, and refuses a WebP quality above 100 or a texture cap that is not a whole number (#2575)
  • The real-time path tracer keeps its GL objects when a scene or kernel is refused at creation and keeps the working scene when update refuses a new one (#2576, #2577)
  • A traced subsurface block with a radius that is not three numbers in range, or a NaN weight or scale, is refused with the field name (#2578)
  • test:mutation-check also reverts changes under scripts/ and reads --base=<ref>, shard-test-files --merge-timings refuses an empty file list instead of wiping the timings, and the test hang guard refuses a limit above 2147483647 ms (#2579, #2580, #2581)
  • The scripts/drive.mjs flags --out, --origin, --width, --height, --surface and --settle now reject a value that starts with --, and --width, --height and --settle reject non-numeric values, each error naming the flag and what to pass (#2591).
  • scripts/render-doc-media.mjs now throws for an unknown page id, a poster= that is not a plain file name, and a shown WebM whose example has no positive loop=, each with a message that says what to pass. Parsing moved to scripts/doc-media-examples.mjs.
  • oidnDenoise reports a truncated PFM output instead of denoising a partly black image (#2596)
  • fromThreeObject names a mesh with no material in a ThreeBridgeError, and skipUnsupported leaves it out (#2597)
  • toThreeObject turns vertexColors on for parts that carry colours, so three.js shows them (#2598)
  • The size gate skips an external package (manifold-3d, Rapier, Jolt) imported statically when it adds up the initial chunks, instead of stopping with "Cannot read properties of undefined" (#2601)
  • The base size cache key also covers strip-glsl-comments.mjs, vite-cook-optional.mjs and measure-archive.mjs, and a test follows the imports of each measuring script so a missing file fails (#2602)
  • A peer entity message without x, or with a null variable, is read as no variables instead of throwing in the receive handler (#2606)
  • A peer that leaves frees its sender slot, so a room with reloads or random ids no longer fills all 32 slots and rejects newcomers (#2607)
  • The netcode client ignores a non-finite or negative frame time in update, so a bad timer reading no longer freezes interpolated entities at NaN (#2608)
  • createMeshData refuses an unknown attribute domain instead of dropping its data (#2609)
  • createMeshData refuses only one of edgeVertices and cornerEdges instead of dropping it (#2610)
  • createMeshData() now reports a missing or non-object mesh input, attributes: null, or an array for attributes at the public boundary instead of a raw destructuring error, so agent callers can see what to pass (#2611)
  • One non-finite sample from an input axis counts as released, so a vehicle, flyer, boat or orbit camera stays finite after a broken gamepad bridge sample (#2612)
  • A camera rig refuses a subject position that is not three finite numbers and skips a step whose subject reports a NaN position or yaw, so one bad reading no longer leaves focus and yaw NaN (#2613)
  • A refused teleport on a character, vehicle or flyer checks both arguments before it moves the body, so a bad yaw leaves the controller where it was (#2614)
  • A runtime hook that throws a string, null or a frozen Error is reported with the system, the hook and the original text instead of a Cannot create property 'message' error (#2615)
  • Crown sky fields now refuse missing or non-finite vertex positions with a RangeError instead of returning NaN visibility; visibilityOf still returns an empty result for an empty target list (#2616)
  • runtime.dispose() disposes every system and then reports the first failure, instead of leaving the rest undisposed (#2617)
  • vertexCoverage refuses an index past the vertex list or a list that does not end on a whole triangle, instead of returning NaN coverage (#2618)
  • createRuntime rejects a non-function clock with a clear error when the runtime is created (#2619)
  • A malformed percent escape in a docs URL hash no longer blanks the page; the bad part is treated as empty so the first topic opens (#2620)
  • A malformed image paragraph in a docs topic now renders as text instead of throwing and blanking the page (#2621)
  • The Marketplace addon list now skips npm search entries without a publishable package name, so one bad entry no longer hides the other addons (#2622)
  • The placed-asset scans now skip a malformed nodes list, a null node or a non-list game.npcs, so validation names the field before any asset load instead of a raw TypeError (#2623)
  • A grid local volume whose frames is a value such as 5 now names that value in the MCP error instead of blaming an unset grid (#2624)
  • skyOpenness now names the point to pass when it is not three finite numbers, instead of reporting open sky for a NaN point (#2625)
  • The closed room test names the part whose world matrix is missing and tells the caller to pass partMatrixLookup(parts) (#2626)
  • A Spume spray index entry that is not two whole numbers from 0 is refused by frame, instead of building phantom droplets (#2627)
  • A WebGPU real-time cache or denoiser that fails to set up now destroys the buffers it made, instead of keeping their memory until the page closes (#2628)
  • The real-time path tracer releases its shaders and program when a pass fails to compile or link (#2629)
  • The real-time path tracer releases an incomplete framebuffer and refuses an empty attachment list with an actionable message (#2630)
  • A velocity pass names a previous camera, view projection or object motion it cannot read instead of failing with a raw error (#2631)
  • packObjectMotion names current or previous and asks for the Map from sampleWorldMatrices(parts) instead of failing with a raw TypeError (#2632)
  • The hero keeps drawing after a quick scroll out and back, and startLoop now returns a stop() that releases its observer, listener and pending frame (#2634)
  • A second press on "Play live 3D" while the world loads joins the first press instead of starting the world again (#2635)
  • The hero camera spline refuses fewer than two keys and key times that do not rise, instead of drawing NaN poses (#2636)
  • A scene file now renders with the punctual lights of its GLB, in the drawn frame and the Cook path trace; keys in renderer.environment still override them (#2664)
  • Lights of the later parts of a staged showcase world reach the scene like the first part's (#2666).
  • Showcase scenes now draw with the lights their GLB carries in KHR_lights_punctual, with the scene.json renderer.environment still winning key by key (#2666).
  • A glowing part inside a smooth metal ring no longer tints every face of the ring with its colour, because a smaller part that holds the reflection probe inside its solid is left out of that probe (#2669)
  • The marketplace lists every built-in addon, grouped by area with a filter, copyable import lines and docs links; import lines show in full on desktop and scroll inside their block on a phone; package cards keep the name, version and npm link on one title row; a Submit your work link points to the showcase.
  • The community showcase shows an example card with the submit actions when its list is empty or fails to load, ships four CodePawl pieces, lets an entry without a Show and tell post leave discussion out when it sets link, and the docs page links to "Submit your work"; every page's nav links to Showcase, and on a phone the five links fit one row at 375 px and wrap instead of overflowing below that (#2678)
  • The single sun shadow map is 4096 x 4096 instead of 2048 x 2048 when shadowBounds.extent is above 1000 m, so a kilometre-scale view such as a mountain valley no longer shows texel steps along the shadow on a slope (#2687).
  • A sun shadow with cascades keeps its near slices to 150 m and adds one far slice out to the end of the scene bounds, so far terrain in large scenes receives shadow instead of reading as lit (#2691)
  • Studio opens scenes that use catalog scans, a catalog HDRI or a .cube look: pass catalog: { asset, environment, look } to createStudio and it fetches each file once, also on reload, undo and redo; scenes with volume fog now draw in the viewport (#2695)
  • An imported GLB opened with scene_create_asset now counts its vertex, index and morph target bytes in residentGeometryBytes, so it counts toward the 96 MiB open-scene cap instead of 0 (#2699)
  • build/crucible.standalone.js is one file again: it no longer imports a renderer chunk, so a jsdelivr or unpkg page makes one script request (#2726).
  • Particle systems no longer join the flush ranking that stops z-fighting: a scene with 2,000 particles now builds in tens of milliseconds instead of about 110 seconds, and a seek no longer searches every speck again.
  • Playing a scene with an ocean time track no longer searches the whole scene for overlapping faces on every frame: on a lighthouse scene with a 66,000-vertex sea each new frame takes about 0.5 seconds instead of about 6 (#2730)
  • An edit that does not touch a sea with an ocean time track (a camera move, a moved node, a material or light change) no longer builds the posed sea again and ranks the whole scene for overlap again: on a lighthouse scene with a 66,000-vertex sea and placed rock models each edit takes about 20 ms instead of about 10 seconds, and an edit after seeking keeps the time the scene shows.
  • A test harness that starts the MCP server can raise the 30 second preview and review deadline with CRUCIBLE_TEST_PREVIEW_DEADLINE_SECONDS (30 to 180); the live branch assets smoke uses 90 so a loaded CI runner no longer fails it (#2741)
  • The home page hero loop plays the port, the data center and the dark store; the chip fab and the warehouse left it, since they show a simulation rather than a scene made to look at (#2743)
  • renderer.render now lists an effect-not-drawn warning in renderer.diagnostics for each effect key it does not draw (such as glare, lensDistortion, stylize, exposure or depthOfField.aperture), instead of dropping it silently (#2749)
  • Soft gaussian splats now write depth in a second colourless pass (alpha 0.5 and up), so depthAt, fog and other depth effects see them instead of the far plane (#2752).
  • --kind video renders longer than about 2 s keep their full length: the in-page encoder's H.264 now gets explicit frame times instead of an ffmpeg guess that collapsed every frame after the 50th into one instant (#2759)
  • A scene file lit by an HDRI with a sun and no lights of its own takes the sun out of the sky term and lights with it as a shadowed key light, and its sun shadow view is fitted to the scene instead of a 7 m box at the origin, so CC0 demo scenes like Lone Monk are no longer washed out (#2761).
  • A scene file or showcase scene whose renderer asks for viewTransform agx, neutral or standard, or a look, now loads the view transform shader before the renderer is built, instead of stopping with an import the page cannot add (#2764)
  • A sun bounce or sky trace that stops at a size limit (a CC0 demo scene like Classroom, past the light bake's 200,000 triangles) says why in its report and the log instead of failing silently, largeScenes: 'proxy' traces such a scene through an occupancy grid whose values do not depend on the mesh density, and openScenes: 'proxy' traces an open scene the same way; both are opt-in, so the default look is unchanged (#2771).
  • The home page is a pour-to-cast scroll story drawn live by Crucible itself, with still pictures for reduced motion and light connections (#2772)
  • The home page shows the pot still in the hero while the live scene loads, then fades to the live scene, so the hero is never empty (#2781).
  • On a phone the home page "Pour" note stays on screen through its whole beat: when the rising mould covers its bottom corner it moves to the free column beside the stream (#2794)
  • The docs, changelog, recipes, marketplace, showcase and tiers pages now share the home page's look: one top bar and footer (generated by scripts/site-chrome.mjs, styled by src/site-chrome.css), Pixelify Sans headings, square panels with 2px edges and the home page's code block, in light and dark (#2796).
  • The film, motion, modeling, nature, object, 2D and asset viewer pages now share the site theme: the same top bar, Pixelify Sans titles, square 2px-edge panels and controls, and light and dark from the system, with the canvas filling the space under the bar (#2804).
  • The PR metadata check no longer holds a pull request as a look change when a look-named file only gains an error message or an input check (#2805)
  • Studio: deleting an object leaves nothing selected, so a second Delete cannot remove an object nobody picked; a light added from the menu is selected; picking an object in Animate opens its panel; undo and redo restore the selection of their step (#2817)
  • Remove the modeling page and its Aster lantern scene: /modeling.html now redirects to the procedural modeling guide (#2822)
  • Water: ripples { strength, speed, windDirection } on a water material calms or aligns the small wind ripples that strobe in a 24 fps film (strength 0 to 1, speed 0 to 2, direction in degrees like the ocean edit); absent, the water renders exactly as before. Scene file and library only. (#2843)
  • Volume fog takes beamRadius (metres, off by default): with scatterOctaves above 1 the extra octaves count only as far as the sun reaches around each point, so a narrow shaft keeps a narrow glow; in the dark-shaft reference the octaves cost 0.01 FLIP and with it on that cost is gone (#643)
  • The netcode addon gains peer-to-peer authority (authority: 'peer': every peer owns its entities, an owner term with a lower-peer-id tie break settles conflicts, claimEntity takes one over), and the browser sample runs over a WebRTC data channel (?transport=webrtc), checked in two headless Chrome pages with measured lag (#778)
  • The home hero builds a world's renderer on one-pixel stand-in textures and uploads large textures in bands, which removes the 100 to 150 ms texture upload blocks of a world build (#779)
  • The home hero's world build hands the thread back more often: the sky prefilter's pass over the whole map runs in steps of a fixed texel count, replaceParts slices are sized from how long the last one took, and replaceParts computes each material's layer state once instead of once per value (#779)
  • The home hero no longer allocates its bloom targets inside the first draw of a world: prepareFrame creates them in a task of their own, which removes a 55 to 75 ms main-thread block at every world switch,; programsReady also takes the size plan and frame targets in a task of their own, which removes the 35 ms resize block of the build; measure-hero-load.mjs names the functions and build phases behind each long task (--profile) (#779)
  • Far water keeps each ripple at the strength a pixel can still show instead of cutting it off, so the far sea shimmers less (#853)
  • Glaze now draws through a backend boundary (GlazeBackend) for its context, frame targets, MSAA resolve and opaque draws, with WebGL2 as the only implementation; frames are unchanged (#901).
  • The home page tier cards are now written from the tier matrix, so their figures cannot drift from the measured results (#906)
  • A tiers page at /tiers.html shows draft, realtime and final on one scene beside Blender, with every figure generated from the measured matrix and the card it ran on (#906)
  • The three.js addon accepts MeshLambertMaterial and MeshPhongMaterial and maps them to matte Crucible materials (#986)
  • The three.js addon test pins the addon at 10 or more snippets that each draw a frame, and its source under 40,000 bytes, so growth shows up in review (#986)
  • The agent bench takes --prompt-note <text>, one line appended to every task prompt and recorded in the result files, to compare prompt wording on the same tasks (#986)

Install: npm install @codepawlhq/crucible@0.22.0