BedSplit documentation

BedSplit panel reference

Every BedSplit control with its default and range: printer presets, Resize for print, cut planes, dowels, Split to Bed, the Result panel and STL export.

Where everything is

All controls live in the BedSplit tab of the 3D Viewport sidebar (press N), in Object Mode. The tab has two panels: BedSplit (settings and the split button) and Result (what the last split produced and the export button). If no mesh is selected the top of the panel says "Select a mesh object".

Printer

ControlWhat it doesDefault and range
Printer (dropdown)Chooses the build volume. Each entry shows its name and width × depth × height in millimetres.Creality Ender 3 / V3 SE (220 × 220 × 250)
Custom sizeLast entry of the dropdown. Shows the Bed fields so you can type your own size.Off
BedWidth, depth and print height in millimetres. Visible only with Custom size.220, 220, 250. Minimum 40 each
Bed: ... mmRead-only line that repeats the size in use.

Changing the printer or the bed size clears the cut list, so the cuts are found again for the new bed.

Printer presets

PrinterWidth × depth × height, mm
Bambu Lab A1 mini180 × 180 × 180
Bambu Lab A1 / P1 / X1256 × 256 × 256
Bambu Lab H2D350 × 320 × 325
Prusa MINI+180 × 180 × 180
Prusa MK4 / MK3250 × 210 × 220
Prusa XL360 × 360 × 360
Prusa CORE One250 × 220 × 270
Creality Ender 3 / V3 SE220 × 220 × 250
Creality K1220 × 220 × 250
Creality K1 Max300 × 300 × 300
Creality Ender 5 Plus350 × 350 × 400
Anycubic Kobra 2220 × 220 × 250
Anycubic Kobra 3250 × 250 × 260
Elegoo Neptune 4225 × 225 × 265
Elegoo Neptune 4 Max420 × 420 × 480
Sovol SV06220 × 220 × 250
Voron 2.4 300300 × 300 × 280
Voron 0.2120 × 120 × 120

The presets are the nominal build volumes. If your machine has a smaller usable area, choose Custom size and type a smaller bed.

Model size

ControlWhat it doesDefault and range
Now: ... mm longest sideRead-only. The longest side of the selected object, taken from its dimensions and the scene unit scale.
Resize for printOff: the model is printed at its current size (scene unit scale applied). On: the parts are scaled so the longest side of the whole model has the size below.Off
Longest side, mmPrinted size of the longest side of the whole model. Greyed out unless Resize for print is on.400. Minimum 10

Changing either control clears the cut list.

Cuts

ControlWhat it doesDefault and range
Find CutsPlaces the cut planes automatically for the chosen printer and draws them in the viewport. Reports how many cuts were found, or that the model fits the bed and no cut is needed.
Show cuts in viewportShows or hides the planes in the viewport. Appears once a cut list exists.On
Cut row: axis, position, XOne row per plane. The label is X, Y or Z. The number is the distance in millimetres from the start of the model along that axis. The X button removes the plane.Position 0 or more
Add cut: X Y ZAdds a plane across that axis in the middle of the largest remaining piece.

Status lines in this box:

  • Automatic: no cut list yet. Split to Bed will find the cuts itself.
  • No cuts: model fits the bed: the automatic search found nothing to cut.

Rules worth knowing:

  • Planes closer than 0.5 mm to an end of the model, or within 0.5 mm of another plane on the same axis, are ignored.
  • The list belongs to one object at one position and size. If you move, rotate or scale the object, or change the size settings, the list is dropped and the panel returns to Automatic.
  • When a cut list exists, Split to Bed uses exactly that list. Moving a plane while it is hidden shows it again.
  • A manual cut list is not checked against the bed. The Result panel tells you afterwards if a part is still too big.

Dowels

ControlWhat it doesDefault and range
Dowel diameter, mmDiameter of the dowel.6.0, range 2 to 20
Depth in each part, mmHow far the dowel goes into each part. The dowel is twice this long.6.0, range 2 to 30
Clearance, mmGap between dowel and socket. 0.2 suits most printers. Raise it when the dowels do not go in.0.2, range 0 to 1
Dowels per jointThe largest number of dowels placed on one cut face.2, range 1 to 3

How the sockets are placed:

  • The socket is as wide as the dowel plus the clearance on every side, and as deep as the depth plus the clearance.
  • At least 1.6 mm of material must remain around a socket in both parts. With the default dowel that means a section roughly 10 mm across; thinner walls get no dowel.
  • Dowels on the same joint are kept at least three dowel diameters apart.
  • Every separate patch of a cut face is treated on its own, so a joint with two limbs can get dowels in both.

Split to Bed

The large button at the bottom of the BedSplit panel. It:

  1. Reads the mesh (including modifiers) in world axes, scaled to millimetres.
  2. Repairs it if needed.
  3. Cuts it along the cut list, or along automatically chosen planes.
  4. Adds sockets and checks every part.
  5. Turns each part so its largest cut face lies on the ground that still fits the bed, and places the parts in a square grid beside the model with a 15 mm gap.

The result is a collection named "BedSplit - " followed by the source name. Parts are named like "Knight part 01" and each has its own colour, repeated after eight. All dowels are one extra object named like "Knight dowel x6", where the number is how many to print. The original model is unchanged and stays active. The parts are selected. The cuts are hidden after the split. A new split of the same source replaces the previous collection. Undo removes the split.

The button is available only in Object Mode with a mesh. If the model already fits the bed and there are no cuts, you get "the model fits the bed, nothing to split. Add a cut to split it anyway".

Result panel

The title shows the add-on version. Before any split it says "No result yet". After a split it shows:

LineMeaning
N parts, M dowelsCount of parts and of dowels to print. A check mark means the parts are closed and fit the bed.
Source name and secondsWhich object was split and how long it took.
MessagesWhat was repaired and what needs attention (see below).
Part n: W × D × H mmOne row per part, with a check mark when it fits the bed and is closed.
Export STLOpens a folder chooser.

Possible messages:

MessageMeaning
Repaired: holes closed, normals fixedLight repair was enough.
Repaired: overlapping shells joinedSeveral overlapping shells were merged into one solid.
Repaired: surface rebuilt (within x mm)The surface was rebuilt. The detail stayed within x mm.
Heavy repair: surface rebuilt, fine detail smoothed (x mm)The rebuild moved the surface by more than 0.5 mm for 99 percent of it. Check the result.
N part(s) not watertight: move a cut plane and split againSee troubleshooting.
N part(s) larger than the bed: add a cut planeSee troubleshooting.
N joint(s) without dowel (wall too thin): glue theseThose joints are flat cuts only.
A dowel socket came out wrong: check the jointsInspect the sockets before printing.

Export STL

Saves every part of the last split as a binary STL in millimetres, plus one dowel file. File names come from the object names, with spaces and unusual characters replaced by underscores, so the dowel file keeps its count, for example "Knight_dowel_x6.stl". The button needs a result in the scene. If you cancel the folder chooser or leave it empty you get "choose a folder". The folder is created if it does not exist.

For use of these controls in order, see the workflows.

Install BedSplit in Blender
Previous page
BedSplit workflows: model to printed parts
Next page