Skip to content

Project Settings

HausTools keeps its project-wide options on one page: Edit → Project Settings → Plugins → HausTools. The sections below follow its groups from top to bottom.

Some are starting values, such as the pitch of a new roof, and leave what you already placed alone. Others shape every building, such as the roof bevel, and reach each one on its next rebuild. HausTools.Rebuild in the console forces one.

The defaults suit a residential building. Grid Unit is the one setting to check, since it has to match your pack.

Grid

Setting Default What it does
Grid Unit 100 cm The size of one grid cell, the step everything snaps to. It has to match the pack's Cell Size Cm, or the pack's pieces won't tile. See Pack dimensions
Working Grid Width / Depth 60 × 60 cells The size of the grid shown before you draw a plot. It is only a drawing aid
Major Grid Every 5 A brighter line every this many cells, for counting at a glance

Walls

A pack sets its own wall height and normally the thickness, so these apply only where it doesn't. See Walls.

Setting Default What it does
Default Wall Height 280 cm How tall walls are without a pack, which is also the storey height
Default Wall Thickness 20 cm How thick walls are when the pack sets no thickness

Openings

A catalog door or window takes its size from its frame mesh. See Windows & Doors. With no tile picked, the Openings tool places a plain doorway with no frame, and its size comes from here.

Setting Default What it does
Default Door Width / Height 140 / 230 cm The size of a doorway placed with no tile picked
Attachment Merge Gap 10 cm Two adaptive attachments this close merge into one piece. Raise it if flanking pillars that should join stay apart
Gable Opening Snap Distance 25 cm An opening in a gable snaps to the gable's centre line or a tile seam within this distance. Lower it for freer placement

Editing

Setting Default What it does
Wall Pick Radius 0.6 How close the cursor must be to a wall to pick it, as a fraction of a grid cell. Raise it if walls are hard to click. Lower it if you pick the wrong one in tight layouts

Foundation

Setting Default What it does
Foundation Step 25 cm The step the foundation height arrow snaps to while you drag it
Max Foundation Height 100 cm The tallest a foundation can be dragged. Foundation pieces are authored 1 m tall, so raise it only if yours are taller

Roof

These apply to every roof:

Setting Default What it does
Default Roof Pitch 30° The slope of a new roof, roughly 7:12
Roof Pitch Step 25 cm The step the apex arrow snaps the ridge height to while you re-pitch a roof
Roof Centre Snap Distance 30 cm While you resize a roof, its ridge snaps to a centre line within this distance
Fascia Depth 25 cm The height of the procedural fascia board. A style with its own fascia piece uses that instead, trimmed by its Fascia Cut
Roof Bevel Subdivisions 1 Cuts across each bevel. 1 gives a single chamfer and more give a rounder edge

These apply only to a roof with no roof style. A pack with a roof style, BasePack included, sets each of them in the style's settings instead, and a new roof always takes that style.

Setting Default What it does
Default Roof Thickness 20 cm The thickness of the roof, measured square to its slope
Roof Wall Clearance 12 cm How far a roof reaches past the outside face of its walls. It has to cover the cladding and corner posts, or daylight shows at the eave
Soffit Panel Thickness 1.5 cm The thickness of the soffit panel under the overhang
Roof Bevel On Rounds off the roof's hard edges: ridges, eaves and corners
Roof Bevel Width 3 cm How far the bevel reaches in from each edge
Roof Bevel Hard Angle 30° An edge gets bevelled when its faces turn by more than this angle
Roof Bevel Weighted Normals On Smooths the shading across a bevel, so a narrow one doesn't darken the large face beside it

Stairs

Appearance is the one look every staircase shares, since none is stored per staircase. Its railing is plain boxes that a fence style's pack pieces replace. A fence without pack pieces is built from the same sizes and bevels. See Stairs.

Setting Default What it does
Default Stair Width 100 cm The width of a new staircase, rounded to whole grid cells
Appearance Opens into the fields below

Inside Appearance:

Setting Default What it does
Handrail Height 90 cm Height of the handrail above the front edge of the steps
Handrail Width / Thickness 6 / 5 cm The handrail's width and its top-to-bottom thickness
Newel Size 12 cm The width of a post
Newel Height 115 cm The height of a fence post. A staircase's post stops just above its handrail
Baluster Size 4 cm The width of a baluster
Stringer Thickness 5 cm The thickness of the side boards, and of the plain lining of a stairwell
Stringer Rise 10 cm How far a closed stringer stands above the steps, or an open one hangs below them
Handrail, Newel, Baluster, Stringer and Steps Bevel One set of bevel and grain options per part, below

Steps Bevel covers the treads, risers and landings. Stringer Bevel also covers the walls under a staircase. Each bevel holds:

Setting Default What it does
Bevel On for Steps Bevel, off for the rest Rounds off the part's free edges. Where a step sits against another step or a stringer the edge stays sharp
Width 2 cm How far the bevel reaches in from each edge
Segments 1 Cuts across the bevel. 1 gives a single chamfer and more give a rounder edge
Weighted Normals On Smooths the shading across the bevel. Off keeps crisp edges
Rotate Grain Off Turns the part's wood grain 90°, for boards whose grain runs the wrong way. It works with the bevel off too, and it leaves fences alone

Bake

The Bake window shows all of these and saves its changes here.

Setting Default What it does
Output Folder /Game/HausTools/BakedBuildings Where every bake saves: one folder per building plus a shared materials folder. /Game is your project's Content/ folder
Clean Old Files On Re-bake On A re-bake deletes the files it no longer makes, such as the meshes of a staircase you removed
Run Sweep Library Cleanup After Bake Off Runs Sweep Library once each bake finishes. Off leaves it to the button on the Manage tab
Nanite On Builds the baked meshes as Nanite. Pack meshes keep their own setting
Generate Lightmap UVs Off For baked or static lighting. Leave it off for dynamic lighting, since it slows every bake
Lightmap Min Resolution 64 The smallest lightmap a baked mesh gets. Only used with lightmap UVs
Lumen Cards Per Mesh 32 The most Lumen surface cards a baked mesh can use. Too few leaves large baked meshes dark in Lumen, and 0 turns them off
Distance Field Resolution Scale 1.0 Distance field detail for baked meshes, which sharpens Lumen on thin walls and boards. Memory use climbs quickly above 1
Complex Collision Fallback On A baked mesh collides on its own triangles wherever no simple collision was built. Turn it off if your project adds its own blocking volumes
Collision Box Tolerance 8 cm How far a collision box may sit off the shape it stands in for. A shape no box fits this closely keeps its convex hull. 0 allows exact boxes only
Cast Shadows On Baked meshes and pack pieces cast shadows
Hide Source After Bake On Hides each building once its copy is placed, so the two don't z-fight
Place In Level On Places the baked building where its source stands. Off writes only the assets and the Buildings tile
Instance Pack Pieces On Pools the pack pieces on one Cladding actor. Off gives every piece its own named actor. See Bake settings

Pack

Setting What it does
Default Pack The pack HausTools opens with. Picking a pack in the catalog's PACK dropdown changes it too. Left empty, it fills in with the first pack HausTools finds. See Compatible Packs