AssetBake documentation

AssetBake panel reference

Every control in the AssetBake sidebar panel: mode, budget, textures, maps, scope, hidden surface, Make Game Asset, Result and Export GLB, with defaults.

Where to find it

Open the 3D viewport sidebar with N and choose the AssetBake tab. The settings panel is titled with the add-on name and version. Below it is the Result panel. The settings need Object Mode and are greyed out while a job runs. Hover over a control in Blender to see its tooltip.

Mode

Two buttons side by side.

ControlWhat it doesDefault
Game (triangles)All triangles, reduced to the budget. Works on every model and keeps the shape best.On
Quad-dominantQuads where the model is thick enough, triangles on thin parts, in one closed mesh. When a model does not allow it, a Game asset is made instead and the result says why.Off

When Quad-dominant is selected, the panel shows the note "Quads on thick parts, triangles on thin parts." If your system has no Quad-dominant build, the button is greyed out and the panel says so. See install for the platforms.

Budget

The title of this box changes with the mode: Triangle budget in Game mode, Face budget (quads + triangles) in Quad-dominant mode. In Quad-dominant mode a quad counts as one face.

ControlWhat it doesDefault
Budget dropdownPresets: 2,000, 5,000, 10,000, 20,000, 50,000, or Custom.10,000
Triangles / Faces (only with Custom)Your own number. The label says Triangles in Game mode and Faces in Quad-dominant mode.10,000

The custom value goes from 200 to 1,000,000. The slider stops at 200,000. Type a number to go higher.

Quad-dominant has its own limits, and the panel shows a message when you hit one:

  • Under 5,000 faces it will not run. The panel says "Quad-dominant needs at least 5,000 faces."
  • Under 10,000 faces the quad share drops and a fallback to Game is more likely. The mode was tuned at 10,000 faces.
  • A source above 2,000,000 triangles is not tried. A Game asset is made instead. To get quads, decimate the source first.
  • If the source already has fewer triangles than the budget allows, it is kept as it is.

Quad share estimate

In Quad-dominant mode with the Scope set to one asset for the selection, the panel takes a quick look at the wall thickness of your model before you start. It shows a line that starts with "Expect about" and gives a range of the share of quads. When many parts are thin it adds that a fallback to Game is possible. When most of the model is thin it says "Mostly thin parts: will likely fall back to Game". The estimate is a guide, not a promise. While it is measuring, the panel says "Estimating the quad share...". With Scope set to one asset per part, no estimate is shown, because every part is checked on its own.

Textures

ControlWhat it doesDefault
1k / 2k / 4kWidth and height of the baked textures: 1024 x 1024, 2048 x 2048 or 4096 x 4096 pixels.2k
NormalAlways baked. Shown ticked and not changeable.On
Base ColourColour of the surface.On
RoughnessPacked into the green channel of one combined texture.On
MetallicPacked into the blue channel of the same texture.On
EmissionBaked only when the source glows.On
AlphaBaked only when the source has transparency. Stored in the base colour.On
AOAmbient occlusion, packed into the red channel of the same texture. It is the slowest map.On

Roughness, Metallic and AO share one texture (AO in red, roughness in green, metallic in blue), the layout most game engines expect. Alpha is a cut-out: half-transparent surface such as glass becomes solid or a hole. Turn off the maps you do not need to save time.

Scope

ControlWhat it doesDefault
Scope dropdown: One asset for the selectionAll selected objects become one asset.On
Scope dropdown: One asset per partEvery separate part becomes its own asset with its own textures. A part is what stays connected after doubled vertices are merged, not an object.Off
Remove hidden surfaceSurface that is shut in between parts and can never be seen is left out, so its triangles and texture space go to the visible surface. The mesh is open there.On

Untick Remove hidden surface if you need the inner surface kept.

Selection line and the button

Below the settings the panel shows what you have selected, for example "Selected: 1 object, 145,859 triangles".

  • With nothing usable selected it says "Select one or more mesh objects".
  • If you select only assets that AssetBake made, it says so and offers a Select Source button to select the originals.
  • Above 5,000,000 triangles it warns that the job takes several minutes and several GB of memory.
  • Above 8,000,000 triangles it stops and asks you to decimate the source first.
  • In Edit Mode it says "Go to Object Mode to make an asset".
ControlWhat it does
Make Game AssetBuilds a low-poly, UV-unwrapped, textured asset from the selected objects. The work runs in the background and the selected objects are not changed. The button is greyed out when there is nothing to work on or a limit above is exceeded.

While a job runs, the panel shows a progress bar and a Cancel button.

ControlWhat it does
CancelStops the background job. Nothing in the scene changes.

If you switch to Edit Mode while the job runs, it keeps running. When it finishes, the panel says "Done - return to Object Mode to get the result". The asset appears when you are back in Object Mode.

Result panel

The Result panel shows what the last job did.

  • Asset box: the name of each asset and its numbers: triangles before and after (or faces, with the quad and triangle shares in Quad-dominant mode), how close the new shape is to the source, the texture size and maps, the number of UV islands, and the time.
  • Messages: notes and warnings about this job. See troubleshooting.
  • Select Source: after a successful job, the original objects are hidden, not changed. Press Select Source to show and select them again, so you can make another version with a different budget or texture size. It also works from the viewport when you select an asset.
  • Copy log path: appears after a failed job. It copies the location of a log file to attach to a support request.

Export

The export box is at the bottom of the Result panel and works in Object Mode. It appears only when there is an asset to export.

ControlWhat it doesDefault
OpenGL / DirectX (Normal map)OpenGL is green up: Blender, Unity, Godot, glTF. DirectX is green down: Unreal Engine. The exported normal map has its green channel flipped.OpenGL
Also save texturesWrites the textures as PNG files next to the GLB file.Off
Export GLBSaves the asset as a GLB file for a game engine, with scale applied and roughness, metallic and occlusion packed into one texture.

Export GLB exports the selected assets, or the assets of the last run when none is selected. With one asset the file gets exactly the name you type. With several assets, each gets its own file named with the name you typed, an underscore and the asset name. A quad-dominant asset is exported as the triangles the textures were baked on.

Install AssetBake in Blender
Previous page
AssetBake troubleshooting
Next page