@@ -24,6 +24,15 @@ with a contributing guide and an `llms.txt` for coding agents.
 
 ## What's new
 
+**1.43 — scatter everywhere.** [Scatter](scatter.md) works on [any object](scatter.md#add-scatter-to-an-object) now,
+not just terrains — moss on a rock, barnacles on a ship — and moves with it. A set can
+[fill](scatter.md#fill-and-masks) by count or density with a minimum spacing and slope, height or painted-layer masks,
+[mix models](scatter.md#mix-tint-and-sink) by weight with tint and sink, and draw pack items, prefabs (their look) or
+any object you pick. [Edit instances](scatter.md#edit-instances) with Rotate, Scale, Relax and a Select tool with a
+gizmo, and [convert both ways](scatter.md#convert-both-ways) — a prefab comes back with its logic. Everyone gets the
+same layout from a seed + your edits, while [far scatter thins](scatter.md#distant-scatter-each-device) to each
+device's budget.
+
 **1.42 — together and anywhere.** Open the same code as someone in your session and you
 [type into one text together](code-workspace.md#editing-together): two people in one line both keep their typing,
 everyone's cursor and selection show in their colour, an **Editing with you** strip names who is where, a late joiner
 
@@ -0,0 +1,107 @@
+# Scatter
+
+*New in 1.43.* Scatter places many copies of a model — rocks, trees, grass, crates, barnacles — over a surface and
+draws them all together, so thousands cost about as much as a handful of objects. It works on a
+[Terrain](terrain.md#scatter) and, since 1.43, on **any object**.
+
+A scatter set is **its settings + a seed + your hand edits**. Every computer in your session builds the same instances
+from those, and so does every reload — a set of thousands of instances travels as a few hundred bytes.
+
+## Add scatter to an object
+
+Select any mesh or placed model ▸ **Properties ▸ Scatter** (right after the Water section's *Add bubble emitter* /
+*Add pour emitter*) ▸ **Add scatter**. 200 instances of the brush's current model fill the whole surface. The instances
+belong to the object: move, turn or scale it and they come along, for everyone in the session.
+
+![Properties ▸ Scatter on a sphere: 200 cones fill it, with the Fill rows below](img/scatter/add-scatter.png)
+
+On a Terrain the Scatter section stays where it was (after Terrain paint) with the same rows. **Add fill** adds another
+set; **Paint scatter…** (or **Scatter…** on a terrain) opens the scatter brush to paint by hand.
+
+## Fill and masks
+
+Each set's **Fill** block places instances over the whole surface instead of by hand:
+
+| Row | What it does |
+|---|---|
+| **Count / Density** | Exactly N instances over the surface, or N per square metre. |
+| **Spacing** | The minimum distance between two instances (0 = off) — nothing closer, nothing overlapping. When the surface is full, Count places what fits and stops. |
+| **Slope** | Only where the surface is between two angles from "up": 0° flat ground, 90° a wall, 180° an overhang. 0–30° keeps instances on the flat top of a rock. |
+| **Height** | Only between two heights, in metres, measured in the object's own frame. |
+| **On paint** | (Terrains) only where a painted layer covers the ground, above a Coverage threshold. Repaint and the fill follows. |
+| **Re-roll** | A new seed: a fresh layout with the same settings. Every instance you edited by hand is kept. |
+| **Remove fill** | The fill goes; instances painted by hand stay. |
+
+**Align** stands each instance on the surface (on by default on objects); switch it off to keep them upright. Masks and
+density are measured before the object's scale, so moving or scaling the object never reshuffles a fill.
+
+## What you can scatter
+
+- **Primitives** and **Library models**.
+- **Pack items** — a kit piece such as a Nature Kit rock, picked in the model list. Everyone fetches it from the pack
+  server, so nothing extra travels.
+- **Prefabs** — a prefab scatters as its **look only** (model and materials); its logic, physics and scripts are not
+  copied, and the model's row says so. [To objects](#convert-both-ways) brings the real prefab back, logic and all.
+- **Use as scatter source** — right-click any object ▸ **Physics & effects ▸ Use as scatter source**, then paint it. A kit piece you have not
+  edited scatters as its pack item; anything else scatters as its look.
+
+### Mix, tint and sink
+
+- **Add a model to the mix** turns a set into a weighted mix — three rocks at 50/30/20. Drag a model's **w** to change
+  how often it is picked; ✕ removes a model and the instances painted with it.
+- **Tint** varies each instance's colour a little (0 = all alike).
+- **Sink** pushes each instance into the ground, in metres at scale 1 (bigger instances sink deeper); a negative value
+  lifts them.
+
+## Edit instances
+
+On a terrain, the scatter brush in the Sculpt toolbox has a row of **tools**:
+
+| Tool | What it does |
+|---|---|
+| **Paint** | Paints instances of the model picked above. |
+| **Erase** | Removes instances under the brush. |
+| **Rotate** | Turns the instances under the brush (*Turn the other way* reverses). |
+| **Scale** | Grows them (*Shrink* to shrink). |
+| **Relax** | Evens out the spacing under the brush — clumps spread, nothing leaves the brush. |
+| **Select** | Pick instances and edit them directly. |
+
+**Affects** (every tool but Paint) limits a tool to one model of a mix — erase only the boxes, turn only the trees.
+
+![The Select tool: seven instances picked, the gizmo on them and the selection commands in the toolbox](img/scatter/select-tool.png)
+
+**Select**: click an instance; <kbd>Shift</kbd>/<kbd>Ctrl</kbd>+click adds or removes; drag a box to select everything
+inside it; <kbd>Ctrl</kbd>+<kbd>A</kbd> selects every instance of the Affects model. The gizmo's **Move** slides the
+selection over the ground, **Turn** rotates it about up, **Size** scales it — one drag is one undo step. The toolbox adds
+**Turn left / Turn right** (15°), **Bigger / Smaller** (10 %), **Re-roll** (a new random turn and size), **Delete** (or
+the <kbd>Delete</kbd> key — it deletes instances, never the terrain) and **To objects**. <kbd>Esc</kbd> drops the
+selection; a second <kbd>Esc</kbd> leaves sculpting.
+
+!!! note "On an object"
+    On a mesh or a model (not a terrain) the scatter brush has **Paint** and **Erase**; the other tools are
+    terrain-only for now.
+
+## Convert both ways
+
+- **Instances → objects**: *To objects* in the Select tool (the selection) or on a model's row in Properties ▸ Scatter
+  (every instance of it). Each instance becomes a real object exactly where it stood — on the ground, turned, tilted
+  and sized the same. A prefab's look becomes the **real prefab with its logic** (when that prefab is in your
+  library); a pack item becomes the pack piece. More than 500 asks first. One undo turns them back into instances.
+- **Copies → scatter**: select several copies of one primitive or one Library model standing on a Terrain,
+  right-click ▸ **Make scatter**. They become instances of that model's scatter on the terrain (position, turn and size
+  kept) and the objects go. One undo turns them back.
+
+## Distant scatter (each device)
+
+Far scattered models fade out so each device stays inside its budget — about half of its triangle line in the
+[budget meter](performance.md#the-budget-chip-will-it-fit-on-a-quest) (Quest 150k, phone 250k, desktop 2M). The layout
+is the same everywhere: instances within 30 m of you, and every [collider](terrain.md#scatter-collider), are never
+thinned, so a ball hits the same rock on a phone and on a desktop.
+
+**Settings ▸ Scene ▸ Performance ▸ Distant scatter**: **Auto** (reads the device) / **Headset** / **Phone** / **Desktop**
+/ **All** (draws everything). This device only.
+
+!!! note "Limits"
+    Up to 8 scatter sets and 8,000 instances per object or terrain (painted and filled together). Filling 5,000
+    instances on a 100,000-triangle model takes about 10 ms on a desktop (25–55 ms with spacing and a slope mask).
+    Everything replicates, undoes in one step per stroke, drag or command, and saves with the scene.
@@ -103,6 +103,7 @@ photo decoder (libheif-js) is LGPL-3.0: it ships unmodified as its own file, loa
 | Sticky panel headers | new in 1.33 | **Interface ▸ Windows & chrome ▸ Sticky panel headers** — keeps the Properties and Configure Scene headers on top while you scroll, or lets them scroll away; both panels at once (mixed while they differ), this device only. See [Panel headers](interface.md#panel-headers) |
 | Lift corner buttons above docked panels | new in 1.33 | **Interface ▸ Windows & chrome ▸ Lift corner buttons above docked panels** — off by default, beside *Lift toolbar above docked panels*; this device only. See [The toolbar](controls.md#the-toolbar) |
 | Selection toolbar · Dock tab row · Grab handle | new in 1.33 | **Interface** — the phone's Show switches, all on by default, this device only; also at the bottom of **More** on a phone. See [The phone bar and More](interface.md#the-phone-bar-and-more) |
+| Distant scatter | new in 1.43 | **Scene ▸ Performance ▸ Distant scatter** — **Auto** / **Headset** / **Phone** / **Desktop** / **All**, this device only: far scattered models fade out to stay inside the device's budget; nearby instances and colliders never thin. See [Distant scatter](scatter.md#distant-scatter-each-device) |
 | GPU fluid | new in 1.40 | **Scene ▸ Performance ▸ GPU fluid** — **Auto** / **Off**, this device only; Auto runs fluid tanks on the graphics card only where a one-time measurement says it is clearly faster, with **Measure again**. See [GPU fluid](simulation.md#gpu-fluid) |
 | Quality preset | new in 1.33 | **Scene ▸ Performance ▸ Quality preset** — **Auto** / **High** / **Medium** / **Low**, this device only; the same as **Configure Scene ▸ Quality ▸ Preset**. See [The Quality preset](performance.md#the-quality-preset) |
 | Reset tips | new in 1.34 | **Interface ▸ Reset tips** — brings back tips that have gone away — on a phone, the *Hold and drag items to or from the bar* line at the bottom of More, which hides itself once you have arranged the bar. See [The phone bar and More](interface.md#the-phone-bar-and-more) |
 
@@ -96,38 +96,45 @@ Inspector ▸ **Terrain paint ▸ Paint…**) and pick the **Paint** brush after
   give it a colour or texture (*Use the material for layer 1* goes back), so the first stroke on a fresh terrain only
   changes where you paint.
 - The coverage line shows how much of the terrain each layer covers; **Clear paint** removes all of it.
+- *New in 1.43:* **Detail** sets this terrain's paint resolution, 64 × 64 to 512 × 512 (default 128). What is painted
+  is resampled (edges get sharper or softer) and the next strokes paint at that detail; a bigger map costs more to send
+  while you paint.
 - One drag = **one undo step**. Peers see the stroke while you paint and exactly your result when you let go; the
   paint is saved with the scene.
 
 ![The Inspector's Terrain paint section](img/terrain/inspector-paint.png)
 
 ## Scatter
 
-The **Scatter** brush paints instances of a **primitive or any 3D model in your Library** — trees, rocks, grass
-tufts — onto the terrain.
+The **Scatter** brush paints instances of a primitive, a Library model, a pack item or a prefab's look — trees, rocks,
+grass tufts — onto the terrain. Since 1.43 a set can also **fill** the terrain by count or density with slope, height
+and painted-layer masks, mix several models, and be edited instance by instance: see [Scatter](scatter.md), which also
+covers scatter on any other object.
 
 ![The Scatter brush in the Sculpt toolbox, with cones scattered over a painted terrain](img/terrain/scatter-toolbox.png)
 
 | Control | What it does |
 |---|---|
-| **Source** | A primitive, or any model in your Library. |
-| **Paint / erase** | Paint adds instances; the eraser removes *that model's* instances under the brush. |
+| **Source** | A primitive, a Library model, a pack item or a prefab ([what you can scatter](scatter.md#what-you-can-scatter)). |
+| **Tools** | Paint, Erase, Rotate, Scale, Relax and Select ([Edit instances](scatter.md#edit-instances)). |
 | **Density** | Instances per m² — painting over a patch fills it up to that density and never past it. |
 | **Scale min – max** | A random size per instance. |
 | **Random rotation** | Turns each instance around its vertical axis. |
 | **Align to slope** | Tilts instances to the ground. |
 
 Instances follow the ground — sculpting the terrain later moves them with it. Inspector ▸ **Scatter** lists each
-scattered model with its count, an Align toggle and **Remove**. Scatter is counted by the
+scattered model with its count, an Align toggle and **Remove**, plus the Fill, mix, Tint and Sink rows
+([Scatter](scatter.md)). Scatter is counted by the
 [budget chip](performance.md#the-budget-chip-will-it-fit-on-a-quest) on the terrain's row, and a dense model (300
 triangles or more) switches to lighter [levels of detail](lod.md) with distance — instances far away draw fewer
 triangles.
 
 !!! note "Limits"
     Up to 8,000 instances and 8 scattered models per terrain. For a Quest, keep it near 2,000 instances of a low-poly
     model (≤ 150 triangles each): each scattered model is one draw call (a dense one, a few — it is drawn in patches so
-    its levels of detail can switch), plus one per shadow-casting light. Instances cannot be selected one by one, and
-    are solid only when their model has a [Collider](#scatter-collider). Older versions open a painted or scattered terrain as the plain terrain.
+    its levels of detail can switch), plus one per shadow-casting light; far instances
+    [thin out per device](scatter.md#distant-scatter-each-device). Instances are solid only when their model has a
+    [Collider](#scatter-collider). Older versions open a painted or scattered terrain as the plain terrain.
 
 ### Scatter ▸ Collider
 
 
@@ -41,6 +41,7 @@ nav:
     - Fluid Tank & Jiggle: simulation.md
     - "Fluids: Emitters & Flow Paths": fluids.md
     - Terrain & Sculpting: terrain.md
+    - Scatter: scatter.md
     - Saving & Sessions: saving.md
     - Checkpoints: checkpoints.md
     - Loading Placeholders: loading.md