Bake project-owned terrain

quick start Beginner ⏱ 6 min vgai 0.1.0

Prerequisites: Installed vgai and run the editor

What you'll learn

Run a scene that uses ordinary GLB terrain
See a baked sum-of-sines heightfield
Understand why generation belongs to the project

What you'll build: A look at the terrain scene — a reproducibly baked heightfield GLB.

Walkthrough — Bake project-owned terrain · generated by site/media/lessons/scenes-batch.lesson.ts (4 steps)

The terrain scene loads a normal project-owned GLB. Its source script uses native Three.js to build a horizontal heightfield from a deterministic sum of sines, then bakes the result to the model asset that the scene and its trimesh collider consume.

Steps

Open the terrain scene. The scene is already open — if you followed the link above, the terrain scene is loaded and rendering (in the local dev editor: VGAI_PROJECT=examples/feature-scenes npm run dev, then open scenes/terrain.vscn.json).

The terrain scene.
Enter play mode — the project-owned GLB loads. The model contains an XZ plane displaced in +Y; the runtime does not need a terrain-specific engine type.

A generated heightfield.
A baked sum-of-sines heightfield renders. The generation script owns width, depth, segments, amplitude, and frequency, and the resulting model pairs with a trimesh collider that follows its actual surface.

Deterministic terrain.
Stop play mode. Press Stop (or Escape).