MATRICXBAKE

CONTENTS

What's Inside

SECTION 01

Overview

SECTION 02

Install and Open

MatricX Bake 1.6.2 is provided in two ZIP formats. Keep the ZIP compressed when installing.

Supported Blender Versions

Open the tool from 3D View > Sidebar > MatricX Bake.

Clean Upgrade

1. Disable older MatricX Bake versions.
2. Remove old copies from Blender add-ons or extension folders.
3. Install the 1.6.2 ZIP.
4. Restart Blender if an older module was already loaded.

SECTION 03

Main Workflow

The panel is organized in the same order users normally work.

Basic Steps

1. Select the object or collection to bake.
2. Use Prepare Mesh if UVs are missing or need a shared atlas.
3. Select maps under Material Bake.
4. Choose Output, Map Packing, Objects, and Performance settings.
5. Click Check, then Bake.
6. Click Setup Baked Material to apply the baked maps.

SECTION 04

Prepare Mesh and UVs

Good UVs are required for clean maps. A procedural material can look correct without usable UVs, so MatricX Bake audits the actual bake layout before starting.

Auto-Fix Bake UVs

Keep Auto-Fix Bake UVs enabled to detect missing UVs, zero-area faces, stacked or overlapping faces, and coordinates outside the 0–1 tile. When the active layout is unsafe, the add-on creates a dedicated MX_BakeUV and leaves the artist's original UV layer intact. Setup Baked Material reads the bake manifest and uses that exact UV map.

MinistryOfFlat

Advanced UV mode can use MinistryOfFlat_Release.zip. Its console executable is Windows-only. On macOS and Linux, use Normal UV mode; the material, decal, final-bake, packing, and export workflows remain fully available.

If the configured zip exists, the panel shows MinistryOfFlat installed. If not, the download button appears. Blender's Online Access preference must be enabled before downloading.

• Padding: Adds spacing when fitting UVs into the 0–1 tile.
• Triangulate Temp: Sends a triangulated temporary copy to MinistryOfFlat.
• Weld Temp: Lets MinistryOfFlat weld duplicate vertices internally.
• Extra Flags: Optional command line flags for advanced users.

SECTION 05

Material Bake Maps

MatricX Bake can bake both clean PBR channels and extra utility maps.

Include Scene Lighting

When enabled, Base Color uses a lighting-aware Combined bake. It captures scene lights, direct light, indirect light, shadows, glossy contribution, and transmission where Blender supports it.

SECTION 06

One Texture Set for Multiple Objects

Texture Set Modes

Atlas UVs

For Pack Existing Islands and Rebuild Shared Atlas, MatricX Bake writes a named UV map like MX_Combined_AtlasUV to each source object. The baked material uses that exact UV map.

MatricX Pro and Procedural Coordinates

MatricX Pro imperfection layers frequently use Object or Generated coordinates inside nested node groups. Joining several source objects changes the temporary object's bounds and normally shifts or stretches those masks. MatricX Bake stores each source object's original procedural coordinates and substitutes them only on temporary copied materials, so dirt, wear, noise, bump, and layered Mix Shader masks keep their original placement. Source materials and node groups are not modified.

MatricX Dirt and Edge Wear mix complete shader closures, while a normal PBR texture set is rebuilt with one Principled shader. MatricX Bake applies channel-consistent MatricX flattening compensation so Dirt remains present without replacing broad metal regions with brown dielectric color, and Edge Wear does not become stronger than the source material. Other Mix Shader materials keep the standard linear conversion.

Modifiers and Mixed UV Layers

One Texture Set normalizes UV-layer names and order on temporary copies before joining. Negligible zero-area CAD or boolean residue no longer rejects an otherwise usable atlas. Material and Final Bake use the source topology that owns the shared atlas; render modifiers stay enabled on the original receiver objects. This prevents Bevel, Subdivision, Mirror, Array, and Geometry Nodes output from adding inherited UV overlaps that can overwrite another object's atlas pixels. Original mesh UVs and modifier settings are not destructively changed.

SECTION 07

Map Packing

Map Packing combines AO, Roughness, and Metallic into one Non-Color image for game-engine workflows.

SECTION 08

Setup Baked Material

After baking, click Setup Baked Material to create a preview material from the baked maps.

• Base Color connects as sRGB.
• Utility maps connect as Non-Color.
• Normal maps use a Normal Map node.
• Height maps connect through a Bump node.
• Opacity maps connect to Alpha and enable material transparency.
• For one texture set, the material is applied to all objects in the current bake scope.
• For one texture set, the material uses the named shared atlas UV map.

Setup Baked Material can read individual maps or packed maps. If individual AO/Roughness/Metallic maps are missing, it can split the packed map channels and use them instead.

Glass Materials

Glass and refraction shaders can be baked into practical texture maps, but baked PBR maps cannot perfectly recreate live refraction, caustics, or transparent ray depth. For closest visual matching, bake Base Color with Include Scene Lighting, plus Roughness, Normal, and Opacity.

SECTION 09

Decals, Final Bake, and Export

Bake Scene Decals

The active mesh is the UV target. Decal sources can be selected objects or children of the target. Decal bake uses the main resolution, margin, output, and device settings.

One Texture Set Decals

When Texture Set is set to One Texture Set, decal baking targets the full bake scope instead of only the active mesh. The add-on creates a temporary combined receiver, activates the shared atlas UV, and bakes decals into the same texture space as the shared material maps.

Use Collection scope for the receiver meshes, then select decal meshes outside that receiver collection or parent decals to the receivers and choose Target Children. Shared outputs use names like MX_Combined_decal_color.png and MX_Combined_decal_mask.png.

Combine Decal & Material

Combine uses the decal mask for every channel and blends Base Color, Roughness, Metallic, and Normal into a new PBR material.

For One Texture Set, do not choose an individual target mesh. Combine Set & Apply to All reads the shared manifest, resolves material and decal folders automatically, uses the named atlas UV, and assigns one combined material to every receiver mesh. It works without an active object. Decals can occupy only a few atlas regions; every receiver still needs the shared material so those regions appear on the correct parts.

Combine creates the live PBR material. Run Bake Final Maps for Entire Set afterward when flattened combined texture files are required. In One Texture Set mode, Final Bake also uses every receiver in the bake scope and does not require an active mesh.

Final Bake

Final Bake flattens the current material into a simplified texture set. Use it after combining decals or when exporting a simplified game-ready result.

Final Normal Strength controls the Normal Map node in the generated final material and defaults to 0.4. This keeps normal-driven lighting from washing out the apparent Base Color or decal appearance. It does not weaken or modify the saved normal texture.

Game Asset Export

Game Asset Export packages models, textures, and asset_manifest.json. Supported formats include FBX and GLB depending on the selected settings.

SECTION 10

Troubleshooting

SECTION 11

Cross-Platform Notes

MatricX Bake uses Blender and Python APIs for Windows, macOS, and Linux. GPU availability depends on Blender, OS, hardware, and drivers. CPU remains the fallback.