BedSplit troubleshooting
The BedSplit tab is missing
The panels show only in Object Mode and in a 3D Viewport sidebar. Press N, leave Edit Mode, and look for the BedSplit tab. If you installed BedSplit Lite, its tab is named BedSplit Lite. If neither is there, check Edit > Preferences > Get Extensions that the extension is enabled. See install.
The buttons are greyed out
Find Cuts, Add Cut and Split to Bed need Object Mode and a mesh. A mesh imported from glTF often has an empty parent that becomes active. BedSplit then uses the only selected mesh, or the only mesh below the active object. If several meshes are selected, select just one, or join them first.
The model has holes or is not manifold. Do I need to fix it first?
No. The split repairs holes, flipped normals, loose edges and overlapping shells before cutting, and the Result panel tells you what it did. If the mesh was too damaged for a light repair, the surface is rebuilt, and the panel warns "Heavy repair: surface rebuilt, fine detail smoothed" when the surface moved by more than 0.5 mm. In that case compare the parts to the original and fix the damaged area by hand if you lose detail you need.
It says "The model is ... mm long and needs about ... parts. Turn on Resize for print"
This is the scale check. If the whole model would need more than 64 parts at your bed size, BedSplit stops before cutting anything. The parts are counted as the product of the slabs per axis, so a model that is five bed-widths wide, deep and tall already needs 125. A count that high nearly always means the units are wrong, for example a model in metres read as millimetres, or the reverse. Fix it one of two ways:
- Turn on Resize for print and type the real longest side in millimetres.
- Correct the scene unit scale so the "Now: ... mm longest side" line shows the real size.
The same message appears from Find Cuts.
The message says "The object has no faces" or "The object has no size"
The selected object is empty, or every vertex is at the same place, or modifiers produce nothing. Check that the object shows a mesh in the viewport.
"N part(s) larger than the bed: add a cut plane"
At least one part exceeds the bed on some axis. This most often happens with a hand-made cut list that leaves a piece wider than the bed. Press Add cut on the axis that is too long, or move a plane so pieces are smaller, then split again. Remember that the printer's height counts too: a piece must fit the print height as well as the width and depth.
"N part(s) not watertight: move a cut plane and split again"
A cut produced a part the add-on could not close. BedSplit already retries up to five times with the planes nudged by a fraction of a millimetre. If it still fails, slide a plane a few millimetres and split again.
Some joints have no dowel
The message "N joint(s) without dowel (wall too thin): glue these" means the cut face is too small or too thin. A socket needs 1.6 mm of wall around it in both parts, so with the default 6 mm dowel and 0.2 mm clearance the section must be about 10 mm across. Options:
- Move the cut to a thicker place.
- Lower Dowel diameter, mm, which lowers the needed wall.
- Set Dowels per joint to 1.
- Accept it and glue the flat faces.
"A dowel socket came out wrong: check the joints"
The built-in check found a socket that either overlaps the dowel or whose gap differs from the clearance. Look at the joints in the viewport, and slide the cut or change the dowel diameter and split again.
The dowels are too tight, or too loose
The socket is made as wide as the dowel plus the Clearance, mm on every side. Printers over- or under-extrude, so the same 0.2 mm can behave differently. Print one test joint. If tight, raise the clearance in steps (0.25, 0.3). Re-split to apply it. The range is 0 to 1 mm.
"Split failed ... Move a cut plane and try again"
An unexpected error occurred during cutting. Move a plane a little with Find Cuts and try again. If it keeps happening on a particular model, send it with your Blender version via the contact page.
The result looks wrong or I want to start over
The split does not change the source. Delete the collection called "BedSplit - " plus your model name, or press Undo, or just split again, which replaces the previous result for that source.
The STL files do not match my slicer scale
The files are exported in millimetres. Import them at 100 percent. If your slicer assumes inches, change that setting there.
Export STL is greyed out, or it says "choose a folder"
The button needs a result in the scene. Run Split to Bed first. When the folder chooser is closed with no folder, you get "choose a folder". If the folder cannot be written the message says "cannot write the files".
Splitting is slow
Cutting and repair run in Blender's Python, so a mesh with millions of faces keeps Blender busy for a while, and the cursor shows a wait symbol until the result appears. A typical figure finishes in seconds. The slowest case is a broken mesh that needs the voxel rebuild: the add-on tries a fine 0.8 mm grid first and steps up to coarser grids (1.15, 1.6, 2.4, then 3.2 mm) when the rebuilt surface would exceed 600,000 faces. If the wait is long, reduce the polygon count first, for example with a Decimate modifier applied to a copy.
Related
- Product page: BedSplit
- Panel reference for defaults and ranges
- Guide: how to split a model for 3D printing