Skip to content

multimaterial_settings_advanced

Jump to bottom
github-actions[bot] edited this page Oct 15, 2026 · 10 revisions

Multimaterial Advanced

Interlocking Beam

Mode: Advanced.
Variable: interlocking_beam.
Type: Boolean.
CLI Example: --interlocking-beam=1.
Generates an interlocking beam structure at the locations where different filaments touch. This improves the adhesion between filaments, especially for models printed in different materials.

Toolchange Ordering

Mode: Advanced.
Variable: toolchange_ordering.
Type: Choice.
Options: default, cyclic.
CLI Example: --toolchange-ordering=default.

Important

NEW FEATURE: Toolchange ordering
Available in: Nightly builds or Releases greater than 2.4.2.

Determines the order of tool changes on each layer:

  • Default: starts with the last used extruder to minimize tool changes.
  • Cyclic: uses a fixed tool sequence each layer. This sacrifices speed for better surface quality, as the extra tool changes allow layers more time to cool.

Toolchange Order

Mode: Expert.
Variables: toolchange_cyclic_order, toolchange_cyclic_first_layer.
Type: toolchange_cyclic_order (Text), toolchange_cyclic_first_layer (Boolean).
CLI Example: --toolchange-cyclic-order=value (toolchange_cyclic_order shown; other variables above follow their own type).

Important

NEW FEATURE: Custom cyclic toolchange sequence
Available in: Nightly builds or Releases greater than 2.4.2.

Only available when Toolchange Ordering is set to Cyclic.

Cyclic order sets the filament sequence the cyclic ordering follows, written as filament numbers separated by commas (e.g. 3,2,1,4). Each layer prints its filaments in that order, and filaments left out of the sequence are printed last, in ascending order. Leave it empty to cycle through all filaments in ascending order.

Entries that cannot be used are dropped and the rest of the sequence still applies:

  • Numbers outside the range of your filaments, such as 0 or a number higher than your filament count.
  • Repeated numbers, where only the first occurrence counts.
  • Anything that is not a plain number, such as abc or 2x.

Apply cyclic order to first layer extends that sequence to the first layer as well. It is disabled by default, because the first layer is instead ordered for the best bed adhesion: filaments that print small, fragile first-layer features are printed last, so the following tool changes and travel moves are less likely to knock those weakly anchored parts loose. This adhesion order also honors a custom first layer filament sequence when one is set. The cooling benefit of the cyclic order does not apply to the first layer anyway, since it is printed slowly and hot for adhesion.

Tip

Enable it only if you need the exact same tool sequence on every layer, including the first, at the cost of that adhesion optimization.

Interface Shells

Mode: Advanced.
Variable: interface_shells.
Type: Boolean.
CLI Example: --interface-shells=1.
Forces the generation of solid shells between adjacent materials/volumes. Useful for multi-extruder prints with translucent materials or manual soluble support material.

Maximum Width of Segmented Region

Mode: Advanced.
Variable: mmu_segmented_region_max_width.
Type: Float.
CLI Example: --mmu-segmented-region-max-width=1.
Maximum width of a segmented region. Zero disables this feature. Ignored when Interlocking Beam is enabled.

Interlocking depth of Segmented Region

Mode: Advanced.
Variable: mmu_segmented_region_interlocking_depth.
Type: Float.
CLI Example: --mmu-segmented-region-interlocking-depth=1.
Interlocking depth of a segmented region. On every other layer, the painted region reaches only this deep into the model instead of the Maximum Width of Segmented Region, so consecutive layers interlock. Zero disables this feature. Hidden and ignored when Interlocking Beam is enabled.

Interlocking Beam Width

Mode: Advanced.
Variable: interlocking_beam_width.
Type: Float.
CLI Example: --interlocking-beam-width=1.
The width of the interlocking structure beams.

Interlocking Direction

Mode: Advanced.
Variable: interlocking_orientation.
Type: Float.
CLI Example: --interlocking-orientation=1.
Orientation of the interlocking beams.

Interlocking Beam Layers

Mode: Advanced.
Variable: interlocking_beam_layer_count.
Type: Integer.
CLI Example: --interlocking-beam-layer-count=1.
The height of the beams of the interlocking structure, measured in number of layers. Fewer layers are stronger, but more prone to defects.

Interlocking Depth

Mode: Advanced.
Variable: interlocking_depth.
Type: Integer.
CLI Example: --interlocking-depth=1.
The distance from the boundary between filaments to generate interlocking structure, measured in cells. Too few cells will result in poor adhesion.

Interlocking Boundary Avoidance

Mode: Advanced.
Variable: interlocking_boundary_avoidance.
Type: Integer.
CLI Example: --interlocking-boundary-avoidance=1.
The distance from the outside of a model where interlocking structures will not be generated, measured in cells.

Clone this wiki locally