# foliage.preset

> Talos next · Since next

Plant a scene's terrain over an area with a plant preset as instancedMesh entities; a re-run replaces it.

Answers counts against the preset's budget and a changeId for revert.

| | |
|---|---|
| Title | Plant a preset |
| Mode | `disk` |
| Token cost | about 203 tokens (listed only when its toolset is enabled) |
| Toolset | `foliage` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `area` | `number[]` | yes |  |  | [minX, minZ, maxX, maxZ] m |
| `define` | `object` | no |  |  | the project's own preset to write and plant: {ops: [scatter ops]} (docs foliage-presets) |
| `dryRun` | `boolean` | no |  |  |  |
| `preset` | `string` | yes |  |  | meadow, roadside-verge, pine-forest, broadleaf-wood, temperate-forest, meadow-farmland, or the project's own |
| `scene` | `string` | no |  |  | The scene file to act on. The open scene when absent. |
| `seed` | `integer` | no |  |  |  |

## Example

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

```json
{
  "name": "foliage.preset",
  "arguments": {
    "area": [],
    "preset": "<preset>"
  }
}
```