Repository navigation
- Breaking: the 67js names kept since the rename are gone: the
67js-mcpand67js-addon-checkcommands, theRenderer67export,SIXTYSEVENJS_*environment variables and the67js.scene,67js.asset,67js.packand67js-pack.jsonformats; use the Crucible names (#2724) - Breaking: the package module files are now
build/crucible.module.jsandbuild/crucible.standalone.js(was67.module.jsand67.standalone.js), and the site serves/releases/<version>/crucible.module.js; imports of@codepawlhq/crucibleitself 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": falseto 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,bouncesandtexelsPerUnitare over the 24 million path step limit now shrinks to fit it, as a preset does, and reports what ran inbake.usedandbake.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 everybake.irradianceGridnode 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: trueand thefinalquality tier use OIDN when@codepawlhq/crucible-denoise-oidnand its binary are installed, and otherwise the wavelet filter withdenoiserNotesaying so;denoise: "wavelet"still means wavelet (#1335)- A local volume with
castShadowno 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 raiseseffects.bloomto 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. createGaussianSplatstakesoutline: { color, width }(width 1 to 4 pixels, needsalphaCut) to draw a dark pixel outline round the silhouette of hard-disc splats, for the pixel-art look (#1744)- The path tracer reads
ambientIntensityas environment map strength, so a recipe with ambient 0 and dim lamps stays dark in Cook;fillIntensityandworld: trueare 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=offreads 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 andscene_inspectnames 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:
gpuTraceSecondsis the trace, and a compile over one second adds akernelCompileNote. - A material graph has a
vertexGroupnode: 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.mattesto write one ID matte PNG per part or material, andsrc/pass-compositing.jsadds Z combine and alpha-over of pass pixels (#1962) - Say in the
environmenttool schema,docs/agent-look.mdand the look reference thatambientIntensityalso scales the HDRI diffuse light and reflections, so an HDRI-only scene keeps it above 0 (#1983). - Fix: the
effectstool schema no longer says ambient occlusion defaults to 0.7; it is 0 (off), asscene_capabilitiesambientOcclusionand 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-bridgefrom npm, now that 0.1.0 is published. scene_createaccepts camera, light and morph driver targets inmotion.drivers, the onesdocs/agent-motion.mddocuments, instead of failing withrecipe.motion.drivers.0.target: Invalid input(#1995)motion.tracksis optional in the MCP schema, so a motion made only of drivers no longer needstracks: []; 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.localVolumeswith 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
maxBouncesand the sunenvironment.sunMaxBounces, a per-light bounce limit like a Cycles light'smax_bouncesthat the nativecycleskernel 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, whenenvironment.worldis false, while every other ray still sees the environment map; only the native Cook kernel still draws the map there and says so inignored(part of #2016) - The CPU path tracer draws the rasterizer's flat background colour for camera rays that escape the scene when
environment.worldis false, and keeps lighting with the environment map; the other tracers still draw the map there and say so inignored(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
--memoryinstead 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
standardview 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|8draws a turnaround sheet per item, andbreakdown: truewrites a shaded, outline, hatching, final strip per item (#2031) scene_render_submittakeskind: "icons": render up to 256 GLBs as matching transparent icons (clean or toon, fit or relative scale), with an atlas andicons.json, in one job (#2031)- Water:
waterRamppaints 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 theoceanedit 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 takesfoamEdge(softlace orhardpainted shape) andfoamWidth, 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.waterGlintadds a hard-edged sun glint and star or dot sparkles to water, off by default; sparkles are four-point stars unlessshapesaysdot(#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
cloudgeometry (seed,puffs,width,height,flatBase) makes one closed mesh of round puffs that toon-shades into clean lobes (#2039) - The
cloudgeometry grows towers fromlevels(lobes on the surface of the level before), withupBias,unionSoftnessand normals taken from the field gradient (#2039). - A material can set
toonColors, one linear colour pertoonstep, so each light step carries its own tint (warm light, cool shadow); materials without it render as before (#2039). - An
oceanedit withspray: truewrites asprayvertex group and surface velocity vector, and a mesh particle emitter takesvelocityFrom: "spray"(withvelocityScale, andgroupThresholdto 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
waterHookto 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
translationforposition, and says where lights and sizes live (#2048) - An invalid
environment.hdriorenvironment.looknow 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.motionis left out, instead of rendering frozen frames. scene_lookandscene_reviewadd amotion-not-sethint when the scene has such moving content and nomotionTimewas 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_capabilitiestopicschemas,sceneorruntimenow 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_resulttakesimages: falseto 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_createwith the fix named, a hole that removes no cell returns aterrain-hole-removes-no-cellwarning with the cell size and the smallest working radius, andscene_export_glbnames the node whose mesh has no triangles (#2071). scene_asset_catalognow lists the good files and puts a GLB with a missing sibling image underskippedwith 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,extrudeandtorusinput 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>inscene_asset_catalog, the scene and the exported GLB, andscene_export_glbtakesclipas 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].warningscarriestarget-at-rootwith 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
contactFoamnow draws its line atopacity1 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:
curveandcurveSeterrors for a badradius(0 or less) or aclosedflag 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_applyandscene_capabilities materialFieldsnow accept the materialdispersionlayer thatmaterialLayersalready listed, and a test checks every listed material layer against the MCP schema (#2090).scene_createandscene_applyaccept materialalphaMode: "add"(additive light), asscene_capabilitiestopicalphaModesalready listed; both read one list (#2091)scene_capabilitiestopiclocalShadowsnow listsareaLights(one atlas tile each), and the shadow atlas error names how many point, spot and area lights asked for a shadow and thecastShadowfields to turn off (#2092). Aninstances.wherethat 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
resolutionof 256, 512 or 1024, a field expression such asinstances.where) now answer a wrong value with the field path, the value received and every accepted shape, for exampleexpected 256, 512 or 1024 (got 2048), instead of a bareInvalid input(#2093). scene_render_submiterrors for a refused audio file name, a motion or renderer clock past its range and animagejob withdurationorfpsnow name the field, the value, the rule and the fix (#2095, #2096, #2098)scene_render_submitnow refuses agpupath tracer backend on a--backend cpuruntime 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-cameraacceptsfStop: nullto turn depth of field off (it clearsfocusDistancetoo) andfocusDistance: nullto clear only the focus plane;fStop: nullwith a numericfocusDistancesays what to pass (#2109).remove-geometryandremove-materialon 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_createandset-physicsaccept thecylinder,coneandcompound(withshapes) physics body shapes thatdocs/physics.mddocuments, andscene_capabilitiestopicphysicslists them (#2113).- A spot
angleerror 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 missingaffectsnode half of this work landed in #2269. - Physics joint, cubic keyframe and particle vertex-limit errors name the field and what to pass,
scene_capabilitiesmotion 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
coneandcompoundbodies (up to 16 sub-colliders), so a recipe that bakes with those shapes plays in a game; onlytrimeshis refused, with a message that lists the live shapes (#2123). scene_createaccepts motionproperties, thecustom,distanceandrotationDifferencedriver variables, every constraint type andchainandsplineIK thatset-motionand 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_edittakessplit_edges,flatten,circularize,delete_looseandunsubdividelike a recipe geometry edit does, its op list is checked against the engine list at load, andscene_capabilities operationsno longer listsedit-meshandset-mesh-stack, whichscene_applyrefuses (they are themesh_editandmesh_stacktools) (#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_createaccepts themorphmotion track thatset-motionand 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
omittedlist (motion tracks by kind, the camera, lights), andscene_capabilitieshas anexporttopic 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_editand recipe edits gaintransform_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 astranslate(#2141)- Mesh edits
smooth_laplacian(volume-keeping smoothing with a pinned boundary and optional vertex group weights) andwarp(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:
addLodsToDensePartsstarts 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-passescan write a camera move and measure the shimmer and level pops of it (#2157). - A scene file now picks levels of detail at
lodPixelError0.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:
startGametakestouchControls, and exported pages show a ring and knob under the finger on a phone (#2148) - A particle emitter on a sea animated by an
oceanTimetrack now takes its droplets from the crests of each particle's birth time, and the "Spray from the sea" example indocs/physics.mdis a whole recipe thatscene_createaccepts (#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
sunAngularRadiuswith 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
nodesthat 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,moveSceneObjectanddeleteSceneObject. - 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,updateSceneCameraanddescribeSceneObject. - 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(createStudioandcreateStudioController) and the/studio.htmlbrowser 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 packstores reflection probes as RGBE bytes instead of Float32, which cuts the gzip data of a scene with metal parts by 55 percent (#2178)crucible packnow 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 packrenders the poster itself in headless Chrome (--poster-size <w>x<h>, default 1280x720, writesposter.webp);--poster <picture>uses your own and--no-posterskips it (#2178)<crucible-scene>takesscroll="orbit 0 90",hover-tilt="6"andview="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 nextscene_create(#2198, #2200) - Estimate job output bytes at
scene_render_submitto catch stills past 128 MiB early, and keep complete leading frames readable when late overflow occurs (#2199). - A mesh
boxbase withbevel0 now honourssubdivisions: 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.5written in (a stored one is dropped on load), andset-particleson a node added in an earlier batch now renders instead of failing with "Unknown part identity" (#2203, #2204). - Volume fog no longer makes
scene_lookfail 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
colorstakes three colours only for bricks (the error says so),meshEditandmeshStacktopics list the modifier ops (wave,ocean, ...) and point tomeshModifiers.<op>, particlestopis described as an absolute time, and ascene_reviewshot withfovnow works on a scene camera that usesfocalLength(#2206). - A coplanar-overlap warning no longer flags parts 100 mm or more apart, however large the scene (#2207)
- An explicit
keyColor,fogColororfogDensitynow wins over a physical sky preset instead of being replaced by the colours the sun derives (#2208) scene_asset_catalogand name placements look at the--assetsfolder 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_applyandscene_reviewlist anunsupported-partwarning 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
worldPointAtand 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/modelnow also exportsassembleSampleModelandloadSampleModel(createModelstays unchanged as public API until #2818),public/wall-e.glbbecamepublic/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 theexport:modelscript are removed; the source is one mesh, soscripts/build-sample-model.pysplits 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-skippeddiagnostic 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). displacealong 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
postPassesnow reports apost-passes-skippedwarning inmetrics.diagnosticsthat 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 reportsbackendFallback(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
watermaterial is traced as a glossy dielectric (IOR 1.33, transmission, absorption from itsabsorptionandturbidity) andfogDensitywithworld: trueis 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-glbno 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 thegpubackend, 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) andparticles-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-explosionand 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 throughscene_createinstead of being refused at 1860; the memory the pose copies hold is bounded bymaxDecodedBytes(#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.animationor 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_applywithbranchnow works on a scene that places catalog assets: the host loads the assets for the branch's scratch copy, as it does forscene_create.scene_reviewacceptsprojectionandorthoScaleon a shot camera, samples the scene camera the way a look and a render job do, and setsrendererTimefrom the shot'smotionTimewhen it gives none; a user post pass reads the shot'smotionTimeas its clock, as in a look and a render job (#2268).- A light's
affectserror names the list you set (environment.spotLights[2].affects,pointLights,areaLightsorkeyAffects) instead of alwaysenvironment.keyAffects, and says that group and placed-asset nodes are not accepted (#2269) - Render jobs retry a blocked
status.jsonrename 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.jsonandapi-reference.jsonon request whenpublic/lacks them, so the home, changelog and docs pages load without errors in a fresh checkout (#2278). environment.skyTopandskyBottomnow draw as the background gradient whenworldis 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, andscene_inspectwarns 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_releasewith the MiB needed and free (#2286) scene_createnow 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_applyset-motiontakesremoveTracksselectors, 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
specularandspecularColorare no longer reported as ignored on a water material (#2288) - Post passes read the camera eye as the
cameraEyeuniform, 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,noiseScaleandnoiseOctavesas fine detail on top of their cells, andadd-explosionsets 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-leakdiagnostic fromscene_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)andbandLimitedLine(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
attenuationDistancemultiplies the light byattenuationColorperattenuationDistancemetres 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 fileposes the glTF clip, including in scenes with water reflection (#2308) render-media --scene fileplays 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.mjsposes the glTF clip before the native trace, at the new--time <seconds>, instead of tracing the bind pose (#2310)scene_lookat amotionTimegives 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_resultattaches no pictures for a job of more than 8 files and returns paths and byte counts;imagesalso 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).
createTerrainrefuses more than 64 chunks or 4096 cells per side,sampleRasterGridrefuses a raster whose values, box or sampling options cannot give a mean, andcreateHeightfieldGeometrygives 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).
selectEdgesnow refusesopencombined withalong(or any other key) and names both, andprojectUvandpackUvIslandsrefuse a non-booleanpackorrotateinstead 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
walkableMaskhanging on an infinite or hugekeepOut(and refuse NaN or negative values),createNavmeshhanging 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,alignandtransformerrors name the operand that is not a vector (#2391). - Fixes from a sculpt, settle and rig bug hunt:
settlefinds 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), andsculptGeometryrefuses unknown stroke fields and adirectionon a stroke that ignores it (#2395) - A one-shot game timer shorter than a nanosecond now fires,
unbindActionandunbindAxisdrop the last sample at once, andbindAxisrefuses a misspelled field such asdeadzone(#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.findPathrefuses 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 withstatus: "stuck"afterstuckSeconds(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; andloadTextureSetkeeps a query string or hash onbaseUrlafter 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)
createTreerefuses a height outside 0.01 to 1000 m,createGrassClumprefuses a bad blade radius, andscatterVegetation,createGrassClumpandcreateFlowerPatchrefuse 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
setBoatControlscall 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, andboat.forwardmust be a string axis. - The motion page reads an empty
width,height,samplesormemoryoption as its default and rounds a fractional value, as the film page already did (#2414) sampleFilmnames 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
dragforce 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,
createGaussianSplatschecksboundsat 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,unwrapUvandgenerateGeometryLodsrefuse a badresolution,voxelSize,maxDistortionorsmoothAnglewith an error that names that field, instead of blaming another field, failing late or ignoring it (#2441, #2442, #2443) - A motion blur
previousCamerawith 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,fragmentPhysicsandregisterExplosionGridsname 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, animationchannelsorsamplers,extensionsUsedorextensionsRequiredis not an array, or whose node or meshnameis not a string, now fails with an error that names the field instead of a rawTypeError(#2452, #2453) parseRadianceHdrnames the accepted input and refuses a header that claims more pixels than the file holds before allocating them,keyLightFromHdrisays which bounds to pass, and GLB export checksmaxTextureSizebefore reading a texture's pixels (#2454, #2455, #2456)createGrassandcreateClutterthrow an error that says what to pass for a zero or NaNclumpSize, aclumpStrengthoutside 0 to 1, abendthat 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,estimateTextureBytesand 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
bakeGasSimup front with the sequence limitbakeGasSimToGridsalready used, and refuse a sparseburstPositionthat 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.seedat 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,shapeCastandoverlapnow see the starting world before the first step instead of returning nothing, andcreatePhysicsSystemrejectsbindingsthat 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_edgesno longer fails on a mesh with UVs when it splits all four sides of a quad, and it,bisect_plane,knife_projectandbridge_edge_loopsnow 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
excludecovers all itsjointsis 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
constructoras unknown fields (#2538). - The real-time tracer refuses a
historyLimitbelow 1,createProgressiveTracerrefusesresolutionDivisorsthat are empty, fractional or do not end with 1, anddenoiseRadiancerefuses 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 withstep="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).
withSunBounceandattachWaterReflectionrefuse a NaN or out-of-rangeenvironment.sunBounce, mirrorscaleorupdateEverywith 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
constructornow fail as unknown kinds, andbakeImpostorAtlasrefuses aframeSizeoutside 8 to 512 instead of returning an empty or unbounded atlas (#2557, #2558). build-pack-indexkeeps the previous output folder when a build fails, and refuses a misspelled or repeated flag (#2562, #2563)check:tool-schemasnow fails on a portable schema finding,check:change-notefails 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
resolveShadowLightandshadowBiasPerSlopeinstead 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.mjsrefuses a target size above the source or not a whole number instead of writing a broken sky (#2574)scripts/recode-glb-textures.mjsleaves 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
updaterefuses 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-checkalso reverts changes underscripts/and reads--base=<ref>,shard-test-files --merge-timingsrefuses 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.mjsflags--out,--origin,--width,--height,--surfaceand--settlenow reject a value that starts with--, and--width,--heightand--settlereject non-numeric values, each error naming the flag and what to pass (#2591). scripts/render-doc-media.mjsnow throws for an unknown page id, aposter=that is not a plain file name, and a shown WebM whose example has no positiveloop=, each with a message that says what to pass. Parsing moved toscripts/doc-media-examples.mjs.oidnDenoisereports a truncated PFM output instead of denoising a partly black image (#2596)fromThreeObjectnames a mesh with no material in aThreeBridgeError, andskipUnsupportedleaves it out (#2597)toThreeObjectturnsvertexColorson 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) createMeshDatarefuses an unknown attribute domain instead of dropping its data (#2609)createMeshDatarefuses 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 forattributesat 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
teleporton 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,
nullor a frozen Error is reported with the system, the hook and the original text instead of aCannot create property 'message'error (#2615) - Crown sky fields now refuse missing or non-finite vertex positions with a RangeError instead of returning NaN visibility;
visibilityOfstill 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)vertexCoveragerefuses an index past the vertex list or a list that does not end on a whole triangle, instead of returning NaN coverage (#2618)createRuntimerejects a non-functionclockwith 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
nodeslist, a null node or a non-listgame.npcs, so validation names the field before any asset load instead of a rawTypeError(#2623) - A grid local volume whose
framesis a value such as5now names that value in the MCP error instead of blaming an unset grid (#2624) skyOpennessnow 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)
packObjectMotionnamescurrentorpreviousand asks for the Map fromsampleWorldMatrices(parts)instead of failing with a raw TypeError (#2632)- The hero keeps drawing after a quick scroll out and back, and
startLoopnow returns astop()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.environmentstill 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.environmentstill 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
discussionout when it setslink, 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.extentis 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
.cubelook: passcatalog: { asset, environment, look }tocreateStudioand 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_assetnow counts its vertex, index and morph target bytes inresidentGeometryBytes, so it counts toward the 96 MiB open-scene cap instead of 0 (#2699) build/crucible.standalone.jsis 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.rendernow lists aneffect-not-drawnwarning inrenderer.diagnosticsfor each effect key it does not draw (such asglare,lensDistortion,stylize,exposureordepthOfField.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 videorenders 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
viewTransformagx, neutral or standard, or alook, 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, andopenScenes: '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 bysrc/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.htmlnow 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 theoceanedit); absent, the water renders exactly as before. Scene file and library only. (#2843) - Volume fog takes
beamRadius(metres, off by default): withscatterOctavesabove 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,claimEntitytakes 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,
replacePartsslices are sized from how long the last one took, andreplacePartscomputes 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:
prepareFramecreates them in a task of their own, which removes a 55 to 75 ms main-thread block at every world switch,;programsReadyalso 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.mjsnames 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.htmlshows 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
MeshLambertMaterialandMeshPhongMaterialand 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