Terrain Engine Pro

De Martin in Modeling


Terrain Engine Pro — Tutorial

Version 2.0 · Blender 4.2 or later · License GPL-3.0-or-later

Terrain Engine Pro turns a closed curve (spline) into a terrain mesh. The terrain's border follows the curve exactly, including the position and height (Z) of every point. The interior is filled automatically with a smooth surface.

It is built for architecture, land subdivision and urban design: plots, embankments, terraces and green areas between streets, walls and buildings.


1. Installation

  1. In Blender, open Edit → Preferences → Get Extensions.
  2. Click the ⌄ arrow in the top-right corner and choose Install from Disk…
  3. Select the terrain_engine_X.X.X.zip file (no need to unzip it).
  4. Make sure Terrain Engine Pro shows up enabled in the list.

The panel lives in the 3D View Sidebar (press N), in the Terrain Engine tab.

Updating from an older version: install the new zip the same way. It replaces the old version. If the panel does not change, restart Blender.

2. Quick start (5 steps)

  1. Draw the curve. Create a closed curve (Add → Curve) around the terrain area. In Edit Mode, put each point at its correct height (Z): top of a wall, sidewalk level, top of a slope, etc.
  2. Select the curve. It must be the active object (the last one clicked).
  3. Turn on Live Preview. A Terrain_PREVIEW object appears with the terrain.
  4. Tweak the parameters in the panel. The preview updates on every change.
  5. Click Generate Final Terrain. This creates the final object (Terrain), independent from the curve.

Done. To make another plot, change the Plot ID (e.g. Plot_02), select the next curve and repeat.


3. How the terrain is built

Knowing the sequence helps you pick the right parameter:

 Curve ──► 1. Border points    (Edge Subdiv)        ──► 2. Interior grid    (Grid Spacing, Edge Clearance)        ──► 3. Triangulation    (Delaunay constrained to the border)        ──► 4. Initial height   (IDW — Stiffness)        ──► 5. Relaxation       (Relax Iterations / Relax Force)        ──► 6. Final smoothing  (Surface Smooth)        ──► Terrain mesh
  1. Border points. The curve is converted into points. Long segments get extra points with heights interpolated in a straight line, which gives a linear ramp along the border.
  2. Interior grid. A regular grid of points fills the interior. Each point gets a tiny offset (2% of the spacing) to avoid degenerate triangles. That offset always uses the same "seed", so the same curve with the same parameters always produces the same terrain. Points outside the curve, inside holes or too close to the border are discarded.
  3. Triangulation. The points are joined into triangles (Delaunay), respecting the border and the holes.
  4. Initial height. Border vertices get the exact Z of the curve and stay locked from then on. Interior vertices get a weighted average of the heights of the nearest border points (IDW).
  5. Relaxation and 6. Smoothing only smooth the height (Z) of interior vertices. They never move X/Y, never change the topology and never touch the border.
Core guarantee: the terrain always meets the curve exactly. No parameter changes the border.

4. Panel parameters

Top of the panel

Parameter What it does
Live Preview Turns automatic updates on or off. When on, any parameter change regenerates the <Plot ID>_PREVIEW object. Turn it off if you are going to change several values on a very large terrain.
Plot ID Name of the final terrain. The preview is called <Plot ID>_PREVIEW. Use one name per plot (Plot_01, Plot_02…) to generate several terrains without one replacing the other.

Block 1 — Border and initial height

Edge Subdiv (m) — default 1.0, minimum 0.1
Maximum distance between two border points. A curve segment longer than this gets extra points, with height varying in a straight line between its ends.

  • Lower (0.3–0.5): more faithful border, well-defined straight ramps, more triangles.
  • Higher (2–5): fewer points; good for large plots with simple borders.
  • Prevents the "belly" that shows up on steep ramps when the border has few points.

Stiffness — default 3, range 1–8
How many of the nearest border points define the initial height of each interior vertex, with closer points weighing more.

  • Low values follow the nearest border more closely. High values average over a wider area.
  • Because Relax and Smooth run afterwards, the effect on the final result is usually small. Leave it at 3 and only change it if Relax is set to 0.

Block 2 — Mesh

Grid Spacing — default 0.5 (meters), minimum 0.05
Distance between the interior grid points, i.e. the mesh density.

  • Halving the spacing gives roughly 4× more vertices.
  • 0.5 works for most plots. Use 0.2–0.3 for fine detail and 1–2 for large areas or quick studies.

Edge Clearance — default 0.5, range 0–1
Minimum distance between the interior grid and the border, as a fraction of Grid Spacing. With Grid 0.5 and Clearance 0.5, no interior point is closer than 25 cm to the curve.

  • Removes the sliver triangles along the border that cause "spikes" or "dips" in the terrain.
  • If you see a bump right at the border, increase it (0.7–1.0). 0 turns the feature off.

Relax Iterations — default 40, range 0–250
Relax Force — default 0.5, range 0–1
Surface relaxation: each interior vertex is pulled toward the average height of its neighbors, with the border locked.

  • The result tends toward a smooth, continuous surface, like a "membrane" stretched between the borders.
  • Iterations is how many passes are made. Force is how far each pass moves (1.0 = full move).
  • The weights account for the actual position of each neighbor (Mean Value Coordinates). Because of that, relaxation does not create creases of its own and keeps straight ramps perfectly straight.

Block 3 — Surface Smooth (Z only)

An extra smoothing step applied after Relax. It removes any remaining ripples and creases.

Smooth Iterations — default 20, range 0–1000
Number of passes. 0 turns it off.

Smooth Strength — default 0.5, range 0–1
Intensity of each pass.

Preserve Shape — default off

  • Off (recommended for generated terrains): full smoothing. With enough iterations it reaches the smoothest possible surface between the borders. It works like extra Relax iterations.
  • On (Taubin): removes only small ripples and keeps larger forms. Use it only on meshes with hand-made relief you want to keep. On a generated terrain, turning it on tends to keep the large creases you want to remove.

Buttons

Generate Final Terrain — creates the final <Plot ID> object with the current parameters. It no longer depends on the curve or on the preview. If an object with that name already exists, Blender adds .001.

Smooth Terrain (Post-process block) — smooths a mesh that already exists. See section 5.


5. Smooth Terrain — smoothing a finished terrain

Use it to smooth a final terrain (or any terrain mesh) without regenerating it. It is useful for treating just one area.

  • Object Mode: smooths the whole mesh.
  • Edit Mode: smooths only the selected vertices. Everything else stays locked, and the transition stays continuous.

In both modes only the height (Z) changes; X/Y, topology and open borders stay intact.

To treat just one area:

  1. Select the terrain and enter Edit Mode (Tab).
  2. Select the irregular region (C = circle select, or Ctrl + right-drag = lasso).
  3. Click Smooth Terrain.
  4. Fine-tune the result in the Adjust Last Operation panel, bottom-left corner (or press F9).
Option Default What it does
Iterations 60 Number of passes (1–2000).
Strength 0.5 Intensity of each pass (0–1).
Preserve Shape off Same meaning as in the panel: off smooths as much as possible; on keeps larger forms.
Only Selected on In Edit Mode, limits smoothing to the selection. When off, smooths the whole mesh.
Tip: on a terrain generated by the add-on, the border vertices come already selected when you enter Edit Mode. Use Select → Invert (Ctrl+I) to select the whole interior at once.
Smooth Terrain computes its weights in plan view (XY). It is made for terrain surfaces, not vertical walls or closed objects.

6. Holes and islands

To leave a hole in the terrain (a building footprint, a pool, a planter), draw a second closed spline inside the same curve object:

  1. Select the plot curve and enter Edit Mode.
  2. Add a new closed spline (Add → Curve) inside the outline.
  3. Go back to Object Mode.

The add-on uses the even-odd rule: an area inside one outline is terrain; inside two outlines it is a hole; inside three it is terrain again, and so on.

The hole's border also follows the height of the curve points.


7. Recommended settings

Goal Grid Spacing Edge Clearance Relax It. / Force Smooth It. / Strength Preserve Shape
Quick study 1.0 0.5 40 / 0.5 0 —
Default 0.5 0.5 40 / 0.5 20 / 0.5 off
Maximum smoothness 0.5 0.7–1.0 40 / 0.5 100 / 1.0 off
Fine detail 0.2–0.3 0.5 100 / 0.7 100 / 1.0 off

Going above ~100 Smooth Iterations usually changes nothing more: the surface has already reached the smoothest result possible for that border.


8. Troubleshooting

"The active object must be a Curve (Spline)."
The curve is not the active object. Click it last before generating.

I edited the curve and the preview did not update.
The preview updates when a parameter changes, not when the curve is edited. To refresh it, turn Live Preview off and on again, or use F3 → "Update Preview Manually".

Bump, spike or dip right at the border.
Increase Edge Clearance (0.7–1.0).

Creases or ripples in the middle of the terrain.
Keep Preserve Shape off and use Smooth Iterations ~100 with Smooth Strength 1.0. For a single area, use Smooth Terrain in Edit Mode.

There is still a sharp edge at one point of the border.
The problem is almost always in the curve, which is locked on purpose. Check for:

  • duplicate points at the same XY position with different heights (a hidden vertical "step");
  • very tight corners, or a point with an unexpected Z.

Fix the curve and the terrain follows.

The border looks "bent" along a ramp.
Lower Edge Subdiv (m) to place more points along the border.

It is slow.
Increase Grid Spacing while you adjust things, and only lower it at the end. Or turn off Live Preview while changing several parameters.

The terrain is in the right place, but its origin is at (0,0,0).
This is expected. The terrain is created directly in the curve's real-world coordinates (with the curve's transforms applied), so the object sits at the origin. Use Object → Set Origin if you need a different origin.

I changed the Plot ID and another preview appeared.
Each Plot ID has its own _PREVIEW. Old previews can be deleted manually.


9. Performance

All generation uses vectorized operations (numpy). Times measured in Blender 4.2:

Terrain Time
~25 × 54 m plot, Grid 0.5 (~2 thousand vertices) ~0.03 s
Same plot, Grid 0.15 (~20 thousand vertices) ~0.35 s
Large area with one hole, Grid 0.5 (~71 thousand vertices) ~1.3 s

10. Version history

  • 2.0 — Engine rewritten for performance: 35× to 100× faster generation. Relax and Smooth use Mean Value Coordinates weights (no self-made creases on irregular meshes). New: Edge Clearance, Surface Smooth panel and the Smooth Terrain tool (Object/Edit Mode). Now distributed as a Blender Extension (4.2+). Full tutorial in English and Portuguese.
  • 1.0 — First release: Live Preview, islands/holes, multi-plot workflow.
$15

Have questions about this product?
Login to message

Details
Blender Extension Compatible Yes
Rating
1 ratings
Dev Fund Contributor
Published 7 months ago
Blender Version 4.2 - 5.0
Extension Type Add-on
Render Engine Used Cycles, Eevee
License GPL