terrain

Since 0.6Changed in 0.7

A terrain: a heightfield ground built from the op stack of a .terrain.json file, drawn, collided and navigated as one.

The entity's position is the terrain's origin; its rotation and scale must be identity. 3D projects only.

Use it in a scene entity's components list as { "type": "terrain", … }. The contract writes the fields flat and refuses unknown keys.

Fields

Field	Type	Required	Default	Allowed values	Description
`source`	`string`	yes			Project-relative .terrain.json file.
`render`	`TerrainRenderMode`	no		`auto`, `off`	Default auto: HD draws VG, standard draws LOD meshes.
`collision`	`TerrainCollisionMode`	no		`heightfield`, `off`	Default heightfield: the terrain is solid ground. off: no collider.
`nav`	`boolean`	no			Feed nav's heightfield source. Default true when the scene has nav.
`groundCover`	`TerrainGroundCover`	no			Grass and forest-floor cover grown on the terrain in HD; none when absent.
`horizon`	`boolean`	no	`false`		The terrain's horizon map: the terrain shadows itself past the sun's shadow distance and deep valleys get less sky light (standard renderer, and HD without ray-traced shadows or GI). Default false.