Guide · Section 7
Troubleshooting & FAQ
Real problems, searched-for answers, and the stuff that's easy to miss the first time through. Use the search bar or Ctrl+K if you're looking for something specific.
Import Problems
The 3MF imported with no colors / everything is grey
The file probably has materials, but the import dialog was left on Geometry Only mode, or the materials use a format the addon doesn't recognize.
- Re-import and make sure Material Mode is set to Import Materials (not Geometry Only)
- Check the slicer info in the 3MF tab N-panel after import — if the Slicer Info sub-panel is empty, the file may not have embedded any slicer-specific color data at all
- If the file came from Orca or BambuStudio, the import should auto-detect this. If colors are still missing, the file may use a custom or non-standard color extension
I imported a multi-color file but I can't see the paint zones
MMU paint data only converts to a visible UV texture when you import with Material Mode → Import MMU Paint Data. Standard import reads the data into materials but doesn't build the editable texture.
Re-import with that mode selected, then switch to Texture Paint mode to see and edit the zones.
The import is extremely slow
You're probably importing with Import MMU Paint Data mode on a high-poly model. This mode subdivides every triangle and paints segmentation data onto a texture — it's inherently slow on dense meshes.
If you just need to view the file, switch to Import Materials mode instead. It's much faster and still brings in the colors. Use the paint import mode only when you actually need to edit the zones.
Objects landed in the wrong place after import
Check the Location setting in the import dialog. If it's set to Keep Original, objects land wherever the 3MF file placed them — which may be far from the world origin if the file was made by a slicer that uses a build plate offset.
Try re-importing with Location → World Origin or 3D Cursor to bring everything to a known position.
Export Problems
My colors disappeared from the export
If you exported with Material Export Mode → Standard 3MF but the original file had Orca-specific paint data, the colors get written as standard materials (colorgroups/basematerials) — not as slicer paint attributes. The slicer receives colors but not the per-triangle zone assignments.
To preserve the slicer paint zones, export with Material Export Mode → Paint Segmentation and select the right slicer format.
The slicer opens the export but shows no filament assignment
The most likely cause is that Material Export Mode landed on Standard when you expected Paint. Check the export dialog — Auto mode only promotes to Paint if it finds MMU paint textures on the objects. If Initialize Painting was never run, there are no paint textures to detect.
Also check that your object actually has paint data: select it, press N, and look for the MMU Paint sub-panel in the 3MF tab. If it's empty, the object doesn't have an active paint texture.
The export is very slow
You're exporting with Paint Segmentation mode. Segmentation encoding is the slowest part of the whole addon — it recursively subdivides every triangle and traverses the painted texture.
Try lowering the Subdivision Depth setting in the export dialog (default 7). Going from 7 to 5 is roughly an 8x speedup with only a modest loss in color boundary sharpness. Depth 5–6 is often enough for most models.
The file is huge
A few things can cause large exports:
- High Subdivision Depth on a dense mesh — reduce depth or reduce polygon count
- High-resolution paint texture — the texture itself gets embedded in the archive. A 16K texture is about 256MB uncompressed
- No compression — check Archive → Compression in the export dialog (default 3 is a good balance)
- Many unique objects with no shared meshes — enable Use Components if you have repeated meshes
MMU Paint Problems
I don't see the MMU Paint panel
The MMU Paint panel only appears in Texture Paint mode. If you're in Object mode, Edit mode, or any other mode, you'll see the Metadata panel instead.
Switch the interaction mode (top-left of the 3D Viewport) to Texture Paint, then press N and look for the 3MF tab.
I can't find the Initialize Painting button
If you see a filament swatch palette instead of the initialize setup, the mesh already has a paint texture. You're in active paint state, not initialization state.
If you see neither — check you're in Texture Paint mode and that a mesh object is selected and active.
The brush is painting but the colors look wrong / blurry
Soft brush falloff causes blurry edges that export as ambiguous color boundaries. The panel will show a warning if it detects this. Click Fix Brush Falloff to snap the brush to Constant falloff. Then use Quantize Texture before exporting to clean up any accumulated blur.
I painted the wrong filament over a big area and want to undo it cleanly
Reassign Filament Color is the right tool for this. Select the filament you want to fix in the list, click Reassign, and pick the replacement color. It bulk-replaces every pixel of that color on the texture in one operation — much faster than trying to paint over it.
If you want to clear a region back to the base/default extruder color, use Reassign and set the target to the base filament's color.
Quantize Texture merged zones I didn't want merged
Lower the Region Similarity value (default 0.20) before running Quantize again. A lower value means the algorithm requires regions to be more similar in color before merging adjacent areas, preserving finer distinctions.
If regions are still merging incorrectly, make sure the colors in your filament list are sufficiently distinct from each other. Very similar filament colors are hard for the region algorithm to separate.
Slicer / Compatibility Questions
Does this work with Cura?
Not currently. Cura uses a blue-channel encoding in PNG files for color zones which is a different format entirely. It's on the research list but not implemented.
I exported for Orca but the file shows no printer or filament config in the slicer
You either need to embed a Slicer Profile (see Slicer Profiles) or the source file you imported from didn't have config data.
Check the Slicer Info sub-panel in the 3MF N-panel tab after import — if it lists config file names, those are stashed and will round-trip automatically. If it's empty, there was no embedded config and you'll need a saved profile or to configure the slicer manually.
My print service rejected the file saying it doesn't support components
Enable Flatten Hierarchy in the export dialog. This writes all objects as top-level build items instead of 3MF component references, which is the broadest compatibility mode.
The slicer shows objects in the wrong position / scale
Check that the 3MF was exported in millimeters (the default). Blender scenes set to meters with scale 1.0 export as millimeters correctly. If your scene units are set to something unusual, verify the Scale setting in the export dialog is compensating correctly.
General Questions
Where are my settings saved between sessions?
All addon defaults live in Edit → Preferences → Add-ons → 3MF → Import and Export tabs. Slicer Profiles live in the Advanced tab. Everything else (like the filament list for a specific model) lives on the scene or mesh data in the .blend file.
Can I use this without having a 3MF file to start from?
Yes. The export workflow works on any Blender scene with meshes. You don't need to import a 3MF first. For plain geometry export, just use File → Export → 3D Manufacturing Format (.3mf) directly. For MMU painting on a new model, use the Initialize Painting workflow in the MMU Paint panel.
Does the addon support Blender 4.1 / 4.2 / 5.0?
Minimum supported version is Blender 4.2. The addon is primarily developed on Blender 5.0. If something looks or behaves differently from what this guide describes, check that you're on 4.2 or newer.