3D Print Model Splitting
This skill turns a single complex sculpted STL into multiple Bambu-ready, physically assemblable parts.
Core rule
Do not confuse printable with assemblable.
Also do not confuse a material-selection preview with a split part.
- MeshFix/slicers can make parts watertight and printable.
- They do not guarantee that interfaces have clearance.
- The validated workflow succeeds because it treats part interfaces as the core problem.
- A face-selection preview is only a semantic preview. It is not a valid part preview until every split part has its open contact boundary capped/filled.
Mandatory preview gates
For interactive demos or human-guided annotation, proactively generate previews; do not wait for the user to ask.
- After preparing the annotation
.blend: render a quick source/annotation preview so the user can confirm scale, orientation, and material slots.
- After the user saves material-face annotation: render an annotation preview/contact sheet with clear part colors and face counts.
- Before claiming “拆件完成” / “split complete”: generate a capped split preview, not just a face-selection preview.
- In previews, label colors explicitly. If possible, show cap/interface faces in a distinct color.
- If any part is still open at the cut/contact surface, say so clearly and call it “annotation preview only”, not “split preview”.
Split-surface capping hard rules
Every part created by material splitting must have its cut/contact surfaces filled before baseline export.
- Deleting the other material groups leaves shell openings at the interface. This is expected but not acceptable as a split baseline.
- Cap/fill all boundary loops introduced by the split before exporting baseline STLs.
- Validate capping with boundary-edge counts per part. Target:
boundary_edges = 0 for each baseline part, unless a known intentional opening is documented.
- If automatic hole filling leaves residual boundaries, retry with a more robust method or explicitly report the residual count; do not present it as final.
- Lock the first accepted baseline only after it is “split + capped”; never lock a raw material-isolated shell as baseline.
Scope boundaries
Good fit:
- figurines, statues, toys, decorative sculpts, and similar triangle-mesh STL files;
- human-guided semantic part boundaries;
- glue-fit or lightly finished assemblies;
- Bambu-ready 3MF/STL handoffs.
Poor fit unless explicitly requested:
- fully automatic semantic recognition;
- precision mechanical snap-fits;
- automatic locator pins/magnets without human-confirmed anchors;
- CAD-grade tolerance guarantees.
Dependencies
Common tools/libraries:
- Blender for STL import, face/material annotation, rendering, and optional interference checks;
- Python packages as needed by scripts:
trimesh, numpy, manifold3d, pymeshfix, Pillow;
- Bambu Studio or another slicer for final slicing/print review;
- project-local folders for generated STL/3MF/Blend/PNG outputs.
Do not write generated model outputs into the skill directory.
Progressive references
Read only what the task needs:
references/sop.md — generic workflow from STL to assemblable 3MF.
references/clearance-lessons.md — Boolean/MeshFix/clearance failure modes.
references/blender-material-annotation.md — human Blender annotation instructions.
references/versioning.md — project versioning and status conventions.
references/case-study-v13.md — optional validated example for a 5-part figurine.
Standard workflow
Prepare annotation file
- Create a Blender
.blend from the input STL.
- Add material slots for intended parts.
- Use a project-local output folder.
Human material-face annotation
- Human selects triangle faces in Blender Edit Mode.
- Assign each face to a material slot.
- Material assignment is geometry metadata (
polygon.material_index), not texture paint.
Split by material and lock a baseline
- Use material indices to export parts.
- Clean tiny islands, cap open boundaries, export STL, render preview.
- Lock a baseline that is only “split + capped”, with no clearance/pins/experimental Boolean.
- Never overwrite the baseline.
Repair only before clearance
- Use MeshFix when needed to make baseline parts watertight before clearance.
- Treat MeshFix as a printability repair, not an assembly solution.
Normalize winding before Boolean
- Ensure each STL has outward / positive-volume winding.
- If volume is negative, invert before expanding cutters.
- Wrong winding can reverse the clearance direction.
Apply interface clearance
- Decide the real remaining assembly interfaces.
- Define a responsibility table: which part subtracts which expanded neighbor.
- Use robust manifold Boolean difference for interface allowance.
- Choose clearance based on printer, scale, material, and finishing expectations.
Do not MeshFix after clearance
- After clearance, use only tiny manifold simplify/sliver cleanup.
- Strong MeshFix can fill intentional clearance cavities and recreate interference.
Validate the deliverable, not only source STL
- Export the final 3MF/STL set.
- Re-read 3MF objects and validate watertight/non-manifold properties.
- Run pairwise interference checks on adjacent parts.
Slicer and physical test
- Use Bambu Studio or another slicer for import/slicing/support/print preview.
- Do not treat “no overlap warning” as assembly proof.
- Physical assembly test is the final gate.
Interface-clearance hard rules
- Start from an un-clearanced baseline when changing the part plan.
- Do not directly merge parts that already had clearance cut between them; this leaves internal cavities/seams.
- Keep clearance work localized to real assembly interfaces.
- If assembly is tight, create a new version and increase clearance locally; do not repair a failed branch blindly.
Deliverables checklist
For a final handoff, include:
- final Bambu 3MF or slicer-ready project;
- final STL parts;
- preview/contact sheet;
- version note;
- validation summary;
- 3MF object validation report;
- pairwise interference report;
- notes on failed/disallowed routes.
Script organization
Scripts in scripts/ are reusable helpers with parameterized paths and part definitions. Keep new scripts project-agnostic: no user-specific absolute paths, no private names, and no hardcoded part schema unless the script clearly accepts a config/CLI override.
1---2name: 3d-print-model-splitting3description: Use when splitting a single complex STL / figurine / statue model into multiple 3D-printable and physically assemblable parts, especially with Blender face/material annotation, Bambu Studio, MeshFix, manifold Boolean, interface clearance/allowance, 3MF object validation, or assembly interference checks. Trigger for requests about STL hand-model splitting, Bambu-ready 3MF delivery, print-fit failures, or fixing part interfaces that print but do not assemble.4metadata:5 source: https://skillmd.com/skills/lord1egypt/3d-print-model-splitting6---78# 3D Print Model Splitting910This skill turns a single complex sculpted STL into multiple Bambu-ready, physically assemblable parts.1112## Core rule1314Do not confuse printable with assemblable.1516Also do not confuse a material-selection preview with a split part.1718- MeshFix/slicers can make parts watertight and printable.19- They do not guarantee that interfaces have clearance.20- The validated workflow succeeds because it treats part interfaces as the core problem.21- A face-selection preview is only a semantic preview. It is not a valid part preview until every split part has its open contact boundary capped/filled.2223## Mandatory preview gates2425For interactive demos or human-guided annotation, proactively generate previews; do not wait for the user to ask.2627- After preparing the annotation `.blend`: render a quick source/annotation preview so the user can confirm scale, orientation, and material slots.28- After the user saves material-face annotation: render an annotation preview/contact sheet with clear part colors and face counts.29- Before claiming “拆件完成” / “split complete”: generate a **capped split preview**, not just a face-selection preview.30- In previews, label colors explicitly. If possible, show cap/interface faces in a distinct color.31- If any part is still open at the cut/contact surface, say so clearly and call it “annotation preview only”, not “split preview”.3233## Split-surface capping hard rules3435Every part created by material splitting must have its cut/contact surfaces filled before baseline export.3637- Deleting the other material groups leaves shell openings at the interface. This is expected but not acceptable as a split baseline.38- Cap/fill all boundary loops introduced by the split before exporting baseline STLs.39- Validate capping with boundary-edge counts per part. Target: `boundary_edges = 0` for each baseline part, unless a known intentional opening is documented.40- If automatic hole filling leaves residual boundaries, retry with a more robust method or explicitly report the residual count; do not present it as final.41- Lock the first accepted baseline only after it is “split + capped”; never lock a raw material-isolated shell as baseline.4243## Scope boundaries4445Good fit:4647- figurines, statues, toys, decorative sculpts, and similar triangle-mesh STL files;48- human-guided semantic part boundaries;49- glue-fit or lightly finished assemblies;50- Bambu-ready 3MF/STL handoffs.5152Poor fit unless explicitly requested:5354- fully automatic semantic recognition;55- precision mechanical snap-fits;56- automatic locator pins/magnets without human-confirmed anchors;57- CAD-grade tolerance guarantees.5859## Dependencies6061Common tools/libraries:6263- Blender for STL import, face/material annotation, rendering, and optional interference checks;64- Python packages as needed by scripts: `trimesh`, `numpy`, `manifold3d`, `pymeshfix`, `Pillow`;65- Bambu Studio or another slicer for final slicing/print review;66- project-local folders for generated STL/3MF/Blend/PNG outputs.6768Do not write generated model outputs into the skill directory.6970## Progressive references7172Read only what the task needs:7374- `references/sop.md` — generic workflow from STL to assemblable 3MF.75- `references/clearance-lessons.md` — Boolean/MeshFix/clearance failure modes.76- `references/blender-material-annotation.md` — human Blender annotation instructions.77- `references/versioning.md` — project versioning and status conventions.78- `references/case-study-v13.md` — optional validated example for a 5-part figurine.7980## Standard workflow81821. **Prepare annotation file**83 - Create a Blender `.blend` from the input STL.84 - Add material slots for intended parts.85 - Use a project-local output folder.86872. **Human material-face annotation**88 - Human selects triangle faces in Blender Edit Mode.89 - Assign each face to a material slot.90 - Material assignment is geometry metadata (`polygon.material_index`), not texture paint.91923. **Split by material and lock a baseline**93 - Use material indices to export parts.94 - Clean tiny islands, cap open boundaries, export STL, render preview.95 - Lock a baseline that is only “split + capped”, with no clearance/pins/experimental Boolean.96 - Never overwrite the baseline.97984. **Repair only before clearance**99 - Use MeshFix when needed to make baseline parts watertight before clearance.100 - Treat MeshFix as a printability repair, not an assembly solution.1011025. **Normalize winding before Boolean**103 - Ensure each STL has outward / positive-volume winding.104 - If volume is negative, invert before expanding cutters.105 - Wrong winding can reverse the clearance direction.1061076. **Apply interface clearance**108 - Decide the real remaining assembly interfaces.109 - Define a responsibility table: which part subtracts which expanded neighbor.110 - Use robust manifold Boolean difference for interface allowance.111 - Choose clearance based on printer, scale, material, and finishing expectations.1121137. **Do not MeshFix after clearance**114 - After clearance, use only tiny manifold simplify/sliver cleanup.115 - Strong MeshFix can fill intentional clearance cavities and recreate interference.1161178. **Validate the deliverable, not only source STL**118 - Export the final 3MF/STL set.119 - Re-read 3MF objects and validate watertight/non-manifold properties.120 - Run pairwise interference checks on adjacent parts.1211229. **Slicer and physical test**123 - Use Bambu Studio or another slicer for import/slicing/support/print preview.124 - Do not treat “no overlap warning” as assembly proof.125 - Physical assembly test is the final gate.126127## Interface-clearance hard rules128129- Start from an un-clearanced baseline when changing the part plan.130- Do not directly merge parts that already had clearance cut between them; this leaves internal cavities/seams.131- Keep clearance work localized to real assembly interfaces.132- If assembly is tight, create a new version and increase clearance locally; do not repair a failed branch blindly.133134## Deliverables checklist135136For a final handoff, include:137138- final Bambu 3MF or slicer-ready project;139- final STL parts;140- preview/contact sheet;141- version note;142- validation summary;143- 3MF object validation report;144- pairwise interference report;145- notes on failed/disallowed routes.146147## Script organization148149Scripts in `scripts/` are reusable helpers with parameterized paths and part definitions. Keep new scripts project-agnostic: no user-specific absolute paths, no private names, and no hardcoded part schema unless the script clearly accepts a config/CLI override.