After the Bake¶
Baking is where HausTools stops. What it hands you is ordinary Unreal content, and this page covers how it fits into your project: collision, Nanite, lighting, materials, source control and packaging.
A baked building behaves like any other static-mesh content in your project. There is no HausTools runtime, no component that has to tick, and nothing that phones back to the build mode.
Collision¶
Collision is built from the building's model, not from its render triangles. The exception is clad pieces from a pack, which keep the pack's own meshes and use whatever collision those carry. The base pack's boxes leave doors and windows clear.
Wherever a box fits a part within the Collision box tolerance in the bake settings (8 cm by default) the part gets a box, and boxes that line up are joined. A shape no box fits that closely, such as a hip roof's triangle, a gable end or a stair rail, keeps a convex hull. Both are far cheaper to collide with than triangles.
Complex collision fallback, also in the bake settings, covers any structural mesh that got no blockers of its own: that mesh collides on its own triangles.
What blocks¶
| Part | Blocks |
|---|---|
| Walls | Per run, with doorways and windows cut through |
| Floors and ceilings | Per room, with the stairwell cut out so the slab above doesn't cap the stair |
| Roofs and overhangs | Following each roof face. On a clad roof it sits on top of the pack's tiles |
| Gable ends | Cut to the part of the gable left standing. Pack gable siding and a shed's side siding block with their own boards |
| Attic lining | Including knee walls standing on the room floor. An attic window lets you through |
| Stairs | A smooth ramp rather than steps, so characters don't catch on each tread. A mid-flight landing blocks only its slab. A plain railing blocks post to post, and one clad in fence pieces uses the pieces' own collision |
| Roof trim | Nothing: fascia, soffit, ridge, flashing and gutters. Downspouts are the exception, with a box along each length of pipe |
Nanite¶
Nanite meshes in the bake settings is on by default, so the meshes HausTools generates are Nanite: the walls, floors, ceilings, roofs, decks, fences and stairs. Meshes from your pack keep whatever they were authored with, so a baked building often has Nanite structure carrying non-Nanite cladding. To make the cladding Nanite too, enable Nanite on the pack's static meshes.
Lighting¶
The bake is set up for dynamic lighting with Lumen. Every baked mesh gets a distance field whatever your project's setting, because software Lumen traces against it. Lumen cards per mesh and Distance field resolution scale in the bake settings tune how Lumen sees those meshes.
For baked lighting, tick Generate lightmap UVs in the bake settings, set Lightmap min resolution to suit your scale, and re-bake.
To check a bake before you light a scene, run HausTools.BakeAudit. It reports
each mesh's distance field, surface-cache cards and Nanite fallback triangles.
See Console Commands.
Materials¶
The bake uses your pack's materials directly. Only a tuned swatch becomes a new Material Instance in SharedMaterials, named after the swatch and shared by every building painted with it. Each re-bake writes the swatch's current values into that instance and overwrites any change made to it in Unreal. Every building painted with that swatch updates.
Shading¶
Baked meshes keep the normals HausTools generated, so they shade the same as the live building. Leave Recompute Normals off in a baked mesh's build settings, because turning it on re-shades every piece by angle. If a baked surface shades wrong, fix the source building or the material and re-bake.
Editing a baked building¶
You can edit inside a baked building's Level Instance like any other, but a re-bake builds a new mini-level and your changes are lost, saved or not. Make lasting changes to the source building with Edit source on the Manage tab, then re-bake.
Source control and packaging¶
A bake writes binary assets to the building's own folder and to the SharedMaterials and SharedMeshes folders. Baking one building can rewrite shared assets that other buildings use, so check in the shared folders together with the building.
A placed building uses only engine classes. A packaged game needs nothing from HausTools, which is editor-only.
When something looks wrong¶
| Symptom | Where to look |
|---|---|
| The building renders black in a Lumen scene | Run HausTools.BakeAudit and see Lighting |
| You can't walk through a doorway | The pack's door mesh has collision across its opening. Fix it in that mesh |
| The baked building flickers against another copy of itself | The source building is still showing. Use Hide source on the Manage tab, or tick Hide source buildings after bake in the bake settings |
More in Troubleshooting.