Reclaimer Kit · Lesson 4 of 11

Paint surface detail

Use the decorator brush for small foliage and ground detail, then check that the saved map contains your strokes.

Level
Beginner
Before you start
A map with decorator sets, such as Guardian. No Editing Kit tags needed.
You will make
A saved patch of painted detail with a clear gameplay route and a tested erase operation.

Shortcuts use Ctrl; Cmd also works on macOS, and Alt is Option. Keep the pointer over the viewport for editing shortcuts. Save before switching projects.

Pick a small test patch

Save as courtyard_detail. Choose a flat area of the existing level beside a route, away from the player's start. First paint a patch you can recognize, rather than covering the entire map. Decorators are surface detail; use actual objects when you need cover or solid barriers.

Built maps do not retain all decorator type names. A type may appear as a numbered mesh instead of a descriptive plant name. Try a small stroke to learn what that mesh looks like.

Make one controlled stroke

  1. Choose the brushSelect Paint Decorators in the viewport toolbar. Its controls appear in the viewport header.
  2. Choose the set and typePick a Decorator set, then a Decorator type. These are the sets present in your map; another map may offer different ones.
  3. Keep the brush smallSet a small Radius and low Density. Density is decorators per square unit. A large radius and high density can add far more instances than a short stroke suggests.
  4. Paint a surfaceDrag across the level's ground, then release. The game updates the painted detail after the stroke ends. Painting in empty space does not create a floating surface.
  5. Inspect the patchOrbit to a low angle. The decorators stand on the surface with varied rotation and their type's scale. Toggle Overlays → Painted decorators if you need to see the editing markers clearly.

Shape the brush

The Brush menu in the viewport header decides how each stamp lays its decorators down. Its options are kept between sessions. Try each of these on a fresh patch, undoing between attempts:

  • Spread: Even fills the circle, Soft edge thins toward the rim so patches blend into bare ground, Clumps makes a few tufts per stamp, and Single places one under the pointer, or a row when you drag.
  • Types mixed: tick several of the set's types to paint them together instead of one at a time.
  • Scale and Spacing multiply the type's own size and distance to its neighbours. Upright and Lean control whether plants follow the slope or stand straight, and how much they tip at random. Turn is random, along the stroke, or one heading.
  • Slope limits painting to a range of steepness: grass on the flat only, or vines on the walls only.

Press [ and ] to narrow and widen the brush without leaving the viewport.

Revise without losing the map's own detail

Press Ctrl+Z: one completed stroke is one undo step. Redo it, enable Erase, and brush over half the patch. The erase brush removes detail you painted. It does not remove the base map's original decorators.

Hold Ctrl as a stroke begins to erase without switching the brush. In the Brush menu, erasing can take Only the chosen set's types, and a Strength under 100% thins a patch instead of clearing it.

If part of the original ground cover remains after erasing, that is expected. Confirm the difference by undoing the erase and watching your added patch return. Leave the main route and the exits of teleporters easy to read.

Save and compare the built result

  1. Save the scenarioCtrl+S keeps your painted strokes as editable work. Reopen the scenario once and check the same patch.
  2. Compile the mapCtrl+B builds the painted decorators into the map's level data. Wait for the save report before opening the package.
  3. Walk past the patchInspect it in a playtest and on the compiled map. Look at ground contact and whether it hides a pickup or an important route.
  4. Keep later edits in the scenarioContinue from the scenario rather than repeatedly using compiled packages as new source projects. Your brush operations remain understandable there.

If the brush does not do what you expect

SymptomCheck
Nothing appears while draggingRelease the stroke. Check that you chose a set and type, that density is above zero, and that the pointer is over the level.
Erase leaves foliage behindThe original map's decorators are separate from your painted additions. Also check the Brush menu: erasing only the chosen set's types, or at a strength under 100%, leaves the rest on purpose.
Nothing is painted on a slope, or only on a slopeThe Brush menu's Slope limits are set. Widen them.
Markers obscure the resultTurn off Painted decorators in Overlays and leave Paint Decorators mode.
The saved map differs from the editorWait for Compile Map to finish and inspect that package, not an older package with a similar display name.

Next step

Make a controlled tag change or verify and share the map. Reference: decorator controls.