Mesh Rules¶
HausTools places your meshes by measuring them, so the mesh itself is the specification. A piece that breaks one of these rules is the usual reason a pack tiles with gaps or sits off the grid.
1. Where the origin matters¶
Walls, corners, windows, doors and foundations are placed by their bounds. The first time you enter HausTools mode it stores an offset for each one that puts its footprint's minimum corner on its grid node and its base on the floor. Dropping a new mesh onto the tile measures it again.
Every other piece is placed from its origin. That covers fence posts, balusters and rails, gutters and downspouts, stair trim, and the extras that ride on a wall or a frame. Put their origin where the piece you replace has it.
Keeping every origin where the BasePack Blender file has it is the safe habit. Reset pivot () seats any piece on its own origin, so a wall modelled away from its origin moves when you press it.
Fix an origin in HausTools
If a piece sits off, you do not need to go back to your modelling tool. Double-click its tile to open its Edit () settings and move it with Pivot X / Y / Z. See Editing a piece.
2. The bounding box is the specification¶
HausTools reads these from the mesh's bounding box:
| What it measures | What it decides |
|---|---|
| Longest horizontal extent (unless Length axis is set) | Which length slot a wall, window, door or foundation fills when you drop it |
| Height of the style's tallest wall | The top of the style's cladding |
| A frame's length | The opening's width |
| A frame's height | The opening's height. The sill is the frame's Pivot Z |
So keep the length and height tight. Stray geometry, a forgotten helper object or a flare past a piece's ends inflates the box and throws off every one of those.
Depth is free
A wall's thickness is set on the wall, starting from the pack's Wall Thickness Cm. It is never measured from the mesh, so detail can stand out from its face, such as a skirting board or a cornice.
Collision boxes do not count towards the bounds, but a mesh's Positive Bounds Extension and Negative Bounds Extension in Unreal do.
3. Author to exact multiples of the cell size¶
The grid's cell size is the pack's Cell Size Cm, the width of one grid square. A piece's length in cells is its length divided by the cell size, rounded. On a 1 m grid a 3 m wall is 3 cells, and so is a 2.9 m wall. The 2.9 m wall leaves a 10 cm gap every time it repeats.
Model to the exact multiple: 1 m, 2 m and 3 m on a 1 m grid, with no gap and no overlap.
4. Run the length along one horizontal axis¶
By default the longer horizontal extent is the piece's length, so a pack modelled along Y works the same as one modelled along X. There is nothing to convert.
A piece that is square or close to it, such as a corner, can pick the wrong side. A tie goes to X. To choose, change its Length axis in its Edit () settings from Auto to Length X or Length Y. See Editing a piece.
5. Model to the pack's numbers¶
Model each piece to the pack's dimensions. Lengths follow Cell Size Cm, as rule 3 says, and walls stay at or below Structural Wall Height Cm when it is set.
Give every wall in a style the same height. The tallest one sets the top of the style's cladding, so a shorter wall leaves a gap above it.
Model corners to Wall Thickness Cm. A corner's arms are sized from the wall's thickness, so a corner made for a thicker wall will not meet its runs flush.
6. Follow the per-role convention¶
A few roles have a specific shape the generator expects:
| Piece | How to model it |
|---|---|
| Straight wall | Length along one horizontal axis, standing on the floor |
| Corner (90°) | An L seen from above, with one arm along X and the other along Y. Copy the arm lengths from the corner in the BasePack Blender file, so each run's first wall starts where an arm ends |
| Corner (45°) | A wide V seen from above, with one arm along X and the other leaving 135° from it, for a wall that turns 45°. Copy the arm lengths from the 45° corner in the BasePack Blender file, so each run's first wall starts where an arm ends |
| Foundation | Spans from the ground to the foundation top, under the wall |
| Window or door frame | Its longer side runs along the wall and sets the hole's width. Its height sets the hole's height. Model the frame at the size you want the hole |
| Ridge cap | Model it flat. Each half folds onto its own slope, so one flat piece fits every pitch |
| Flashing | Model it flat, with the bend line down the Y centre |
| Roof surface, soffit, gable | Tileable at its real size. The generator repeats and cuts it |
| Fascia | Tileable at its real size. A short run stretches one board to fit, and a raked board stretches with the pitch |
| Gutter, fence rail, deck skirt | Length variants at 1, 2 and 3 cells |
Your UVs and materials are kept
HausTools keeps each mesh's UVs and materials, and most pieces are placed at their modelled size. A few stretch to fit: walls and foundations on a 45° run, the last tile of a fence, rail or gutter run, downspouts and posts in height, and fascia. Faces that a roof cut creates get new UVs. Painting swaps a material on the placed copy and leaves the asset alone.
Facing is a button, not a re-export
If a piece faces the wrong way, do not flip it in your modelling tool. Flip facing () in its Edit settings turns it 180°. Only that slot turns, so the same mesh can sit elsewhere in the pack facing its own way.
A quick self-check¶
Before you call a style done, confirm that:
- every straight piece is an exact multiple of the cell size
- every wall in the style is the same height
- no piece has stray geometry inflating its bounds
- every piece sits where its BasePack piece did, from its origin or with Pivot X / Y / Z
- corners are modelled to the pack's Wall Thickness Cm, with the BasePack file's arm lengths
- frames are modelled at the size of the hole, their longer side along the wall
- ridge and flashing pieces are modelled flat
- the pack's Structural Wall Height Cm is set
Compare with the BasePack Blender file
When in doubt, compare a piece with its twin in the BasePack Blender file, which follows every rule on this page.