# building.generate

> Talos next · Since next

[editor or disk] One building of kit pieces, metres.

Same id replaced; overlaps refused.

| | |
|---|---|
| Title | Building |
| Mode |  |
| Token cost | about 263 tokens (listed only when its toolset is enabled) |
| Toolset | `buildings` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `at` | `any[]` | no |  |  |  |
| `balconies` | `any[]` | no |  |  |  |
| `bandStyles` |  | no |  |  |  |
| `buildings` |  | no |  |  |  |
| `chimney` |  | no |  |  |  |
| `colliderMode` |  | no |  |  |  |
| `doorHood` | `enum` | no |  | `canopy`, `porch` |  |
| `doors` | `any[]` | no |  |  |  |
| `dormers` | `number` | no |  |  |  |
| `eaveBrackets` |  | no |  |  |  |
| `faces` | `any[]` | no |  |  |  |
| `floors` |  | no |  |  |  |
| `footprint` | `any[]` | no |  |  |  |
| `galleries` |  | no |  |  |  |
| `groundStyle` |  | no |  |  |  |
| `id` |  | no |  |  |  |
| `instance` |  | no |  |  |  |
| `jetty` |  | no |  |  |  |
| `kit` |  | no |  |  |  |
| `levelGround` |  | no |  |  |  |
| `outsideStair` | `object` | no |  |  |  |
| `over` |  | no |  |  |  |
| `party` |  | no |  |  |  |
| `paving` | `number` | no |  |  |  |
| `plinth` |  | no |  |  |  |
| `raise` |  | no |  |  |  |
| `ridge` | `enum` | no |  | `x`, `z` |  |
| `roof` | `enum` | no |  | `flat`, `pitched`, `hip`, `tower` |  |
| `roofSet` |  | no |  |  |  |
| `save` |  | no |  |  | `true` saves the scene afterwards. |
| `scene` |  | no |  |  | The scene file to act on. The open scene when absent. |
| `seed` |  | no |  |  |  |
| `shopfront` |  | no |  |  |  |
| `size` | `any[]` | no |  |  |  |
| `storeyScale` |  | no |  |  |  |
| `style` |  | no |  |  |  |
| `wear` |  | no |  |  |  |
| `windows` | `object` | no |  |  |  |
| `yaw` |  | no |  |  |  |

## Example

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

```json
{
  "name": "building.generate",
  "arguments": {}
}
```