# terrain.create

> Talos next · Since next

[editor or disk] A terrain file, empty or a landform (terrain.ops lists them), with entity also its scene entity, as one change; a layer material the project lacks is written plain.

3D only.

| | |
|---|---|
| Title | New terrain |
| Mode |  |
| Token cost | about 189 tokens (listed only when its toolset is enabled) |
| Toolset | `terrain` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `entity` |  | no |  |  | true, an id, or {id, name, position} |
| `extentM` |  | no |  |  | m, or [x, z]; 128 m cells |
| `landform` | `string` | no |  |  |  |
| `layers` | `object[]` | no |  |  | {name, material} |
| `params` | `object` | no |  |  |  |
| `path` | `string` | yes |  |  | terrain/x.terrain.json |
| `sampleM` | `number` | no |  |  | 0.25 to 4 |
| `seed` | `integer` | no |  |  |  |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "terrain.create",
  "arguments": {
    "path": "<path>"
  }
}
```