> For the complete documentation index, see [llms.txt](https://quasistellar-game-development.gitbook.io/town-generator/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quasistellar-game-development.gitbook.io/town-generator/reference/building.md).

# Building

## General

### Other Options

#### Path Start Prefab (Optional)

​Set to override the default prefab. See Functions tab.

#### ​Door Prefab (Optional)

​Set to override the default prefab. See Functions tab.

#### ​Attach Point Prefab (Optional)

​Set to override the default prefab. See Functions tab.

#### Ignore Direct Attachments

If checked, Buildings that are generated and added to any of this Building’s Attach Points will be ignored in the Physics check.

#### Is Landmark

If checked, this Building will not be removed when Clear Buildings is run on the Town Generator. Use it to add buildings to the Scene that you would like at a specific location and the generator will use them as a starting point, i.e. a market plane or roads that contain a Building component and Building Attach Points.

## Terrain Manipulation

### Raise/Lower at Doors

#### **Auto Flatten At Doors**

If checked the Town Generator’s and/or Sector’s Default Process will include this building when running the Flatten At Doors process.

#### **Amount Below Door**

Set the amount that the Terrain height should be below the door.

#### **Flatten At Door Steps**

Terrain Steps around the door that should be affected by the Flatten At Doors process.

### Raise Around/Under Building

#### Auto Raise Terrain

If checked the Town Generator’s and/or Sector’s Default Process will include this building when running the Raise Below Building process.

#### Raising Steps

Terrain Steps around the building that should be affected by the Raise Below Building process.

#### Raise Smooth Amount

Amount of smoothing to apply after raising the Terrain.

#### Raise To Door Height

If checked the Terrain will be raised below the Building to the same height as the lowest Door.

#### Only Lower Terrain

If checked, only Terrain lower than the bottom of the Building’s bounds will be affected.

### Lower Around/Under Building

#### Auto Lower Terrain

If checked the Town Generator’s and/or Sector’s Default Process will include this building when running the Lower Below Building process.

#### Lowering Steps

Terrain Steps around the building that should be affected by the Lower Below Building process.

#### Lower Smooth Amount

Amount of smoothing to apply after lowering the Terrain.

#### Lower To Door Height

If checked the Terrain will be lowered below the Building to the same height as the lowest Door.

#### Only Higher Terrain

If checked, only Terrain higher than the bottom of the Building’s bounds will be affected.

## Path Painting

#### Terrain Layer

Set a Terrain Layer to use for this specific building, overriding the one set on the parent Sector or Town Generator.

#### Random Paint Size

Enable or disable the use of a random paint size or not.

#### Paint Size

Size to paint on the terrain. If Random Paint Size is enabled you will be able to set the Min and Max size.

#### Paint Strength

Strength or opacity of the paint on the terrain.

## Functions

### Create Attach Points <a href="#text-create-attach-points" id="text-create-attach-points"></a>

#### ​Sides

​Select the sides on which to add Attach Points.

#### ​Distance From Bounds

​Set the distance from the building bounds to place the Attach Points.

#### ​Button: Create Attach Point(s)

​Create Attach Points as set in the options above. You can set which prefab to use on the General tab.

### ​Create Other

#### ​Button: Path Start

​Create a Path Start object on this building. You can set which prefab to use on the General tab.

#### ​Button: Door

​Create a Door object on this building. You can set which prefab to use on the General tab.

## ​Terrain Manipulation

#### Button: Run Terrain Manipulation

This function will run the selected Terrain Manipulation processes for this Building under the Settings tab.

#### Button: Raise/Lower at Doors

This function will run the Flatten At Doors Process for this Building.

#### Button: Raise Around/Under Building

This function will run the Raise Below Building Process for this Building.

#### Button: Lower Around/Under Building

This function will run the Lower Below Building Process for this Building.

## Paint on Terrain <a href="#text-paint-on-terrain" id="text-paint-on-terrain"></a>

#### ​Button: Paint Under

​Run the Terrain Paint process for this Building.

## ​Peasants

#### ​Peasant Prefabs

​Set the NPC prefabs to use for this building, overriding the defaults set on the parent Sector or Town Generator.

## Debugging

#### Display Debug Bounds

If checked, will display the Bounding box used by the generator.

#### Display Debug Points

If checked, will display debug rays to indicate where the Terrain is lowered/raised.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://quasistellar-game-development.gitbook.io/town-generator/reference/building.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
