b3d-decorator

Rocks and trees on the terrain, by budget and by climate. Drop it into a scene with a <tosi-b3d-terrain>. It scatters a fixed NUMBER of things around the camera, chosen by scatter's climate rules (the same temperature, moisture, altitude and slope axes the terrain's biome shader paints with), so the pines stand where the ground is cold forest, and the palms at a warm shoreline.

b3dDecorator({ budget: 5000, radius: 900 })

How it draws

Every model is drawn with thin instances: one draw call per model PART, however many copies. A few dozen Nature Kit models make a few dozen draw calls, whether the budget is 1,000 or 20,000. What grows with the budget is vertices. The Perf Stats panel's decorator row shows the counts and the build time.

The scatter is world-anchored, so when the camera moves far enough (radius / 4) it re-scatters around it and only the edge changes. It follows the terrain's floating origin and rebuilds when the terrain's shape or climate changes.

Shadows, where they show

Casting from every copy puts each one into all four shadow cascades: measured at +3.7 ms (2k) to +6.7 ms (20k) on an M5 Max, most of it for copies too far away for their shadow to be seen. So each part has a shadow-only twin (on a layer the camera does not draw) holding just the nearest shadowBudget copies within shadowRange, re-picked as the camera moves. The visible copies never cast. Measured after: 5 or 600 casting copies cost the same. What remains (≈2.4 ms there) is the sun's shadow pass switching on at all, which the sun's own settings govern.

Collision, where it matters

A small POOL of invisible colliders follows the camera: trunks as thin cylinders, boulders as boxes (see ScatterRule.collider), assigned to the nearest placements within colliderRange. A fixed cost however big the budget, and it exists exactly where something can bump into it. They collide the way everything here does (checkCollisions + moveWithCollisions), so a biped stops at a trunk and can stand on a boulder.

Attributes