Blender 3MF Format是一款Blender插件，用于导入、编辑和导出3MF（3D制造格式）文件，保留真正的切片器感知数据。

它涵盖的远不止原始网格导出。该插件处理几何体、材质、纹理、元数据、三角集、Orca/Bambu修改器部件、大多数切片器的MMU绘制工作流、切片器配置文件往返以及符合规范的3MF打包。

• 版本 2.0.0
• 兼容 Blender 4.2+
• 主要开发目标：Blender 5.0
• 积极维护

对于Blender版本 2.80–3.6，请参阅原始发布版本。

• 导入和导出真正的3MF文件，而不是将所有内容扁平化为STL风格的几何体
• 保留颜色、材质、纹理、元数据和特定于切片器的项目数据
• 为标准3MF、Orca Slicer / BambuStudio和PrusaSlicer / SuperSlicer工作流程导出
• 使用内置的MMU Paint Suite直接在Blender中创建绘制、接缝和支撑数据
• 将现有纹理和顶点颜色烘焙为量化后的切片器就绪绘制数据
• 保存和重复使用切片器配置文件，使导出的文件以正确的机器和耗材设置打开
• 从3MF侧面板将对象转换为切片器修改器、支撑、阻挡或负部件
• 通过公共Python API自动化导入/导出/检查

完整的用户指南托管在CloneCore上，比本README更详细地介绍了该插件。

• 从这里开始：入门与导入
• 选择合适的模式 / 标准导出
• 对象或面颜色
• 绘制或纹理烘焙
• 元数据、部件类型与三角集
• 切片器配置文件
• 故障排除与常见问题

API和面向开发者的文档：

• 本仓库中的生成的API文档
• 本地API参考源码

官方Blender扩展平台（推荐） – 包括自动更新！

1. 打开Blender
2. 前往 编辑 → 偏好设置 → 获取扩展
3. 搜索 “3MF”
4. 点击 3MF导入/导出 的 安装

方式一：拖放

1. 从发布页面下载ZIP
2. 打开Blender
3. 将下载的ZIP文件拖入Blender
4. 启用插件

方式二：偏好设置

1. 从发布页面下载ZIP
2. 打开 编辑 → 偏好设置 → 插件
3. 点击 安装… 并选择下载的ZIP文件
4. 启用 3MF导入/导出

安装后，插件会出现在以下位置：

• 文件 → 导入 → 3D制造格式 (.3mf)
• 文件 → 导出 → 3D制造格式 (.3mf)
• 3D视口 → N → 3MF选项卡，用于元数据、对象信息、三角集和MMU工具

从文件 → 导入 → 3D制造格式 (.3mf)导入。

主要的导入选项是材质模式：

• 导入材质：最适合查看颜色、材质、纹理和往返文件
• 导入MMU绘制数据：将支持的切片器分割转换为可编辑的绘制纹理
• 仅几何体：忽略颜色/材质数据，仅导入网格数据

导入器还可以保留：

• 几何体和组件层级
• 基础材质、颜色组、纹理和PBR属性
• Orca paint_color数据和Prusa mmu_segmentation数据
• 场景/对象元数据
• 三角集
• 用于后续往返导出的嵌入切片器配置文件

从文件 → 导出 → 3D制造格式 (.3mf)导出。

关键的导出设置是材质导出模式：

• 自动：检查场景并选择合适的导出器
• 标准3MF：写入符合规范的单模型3MF
• 绘制分割：为MMU工作流写入面向切片器的绘制分割

当需要用于通用工具或打印服务的符合规范的干净文件时，使用标准3MF。

当面向具有对象/面颜色或绘制耗材区域的切片器时，使用自动或绘制分割。

这包括插件支持的两种工作流：

• 简单的逐对象或逐面材质颜色工作流
• 具有可编辑绘制、接缝和支持层的完整绘制工作流

外部指南页面详细介绍了两种工作流：

• 标准导出指南
• 多色导出指南

3MF侧面板选项卡提供的功能超出了导入/导出对话框：

• 场景元数据编辑
• 对象信息和保留的对象元数据
• Orca/Bambu修改器部件类型，包括修改器、支撑强化、支撑阻挡和负部件
• 从导入文件获取的切片器信息
• 通过三角集扩展进行三角集命名和导出

完整指南请参见：

• 元数据、部件类型与三角集

该插件包含一个基于纹理的内置多材质绘制工作流，用于创建切片器就绪的颜色区域。

• 直接在Blender的纹理绘制模式下绘制耗材区域
• 在颜色、接缝和支撑绘制层之间切换
• 在整个绘制纹理上重新分配耗材颜色
• 在纹理绘制模式下通过引导面板从零开始
• 将材质、纹理或顶点颜色驱动的外观烘焙为MMU绘制数据
• 在导出前量化并清理绘制区域
• 将绘制结果导出为Orca/Bambu和Prusa系列切片器能够识别的切片器原生绘制数据

完整指南：

• 绘制或纹理烘焙

您可以保存从现有切片器生成的3MF文件中提取的打印机/耗材配置，并将其嵌入到未来的导出中。

• 从Orca/Bambu或Prusa生成的3MF项目中加载配置文件
• 在Blender会话之间重复使用已保存的配置文件
• 在导出期间嵌入正确的配置，以便切片器以预期的机器和耗材设置打开

指南：

• 切片器配置文件

2.0.0+版本包含一个公共Python API，用于无需bpy.ops的无头操作和脚本化工作流：

from io_mesh_3mf.api import import_3mf, export_3mf, inspect_3mf

# 在不导入的情况下检查
info = inspect_3mf("model.3mf")
print(info.unit, info.num_objects, info.num_triangles_total)

# 导入
result = import_3mf("model.3mf", import_materials="PAINT")
print(result.status, result.num_loaded)

# 导出特定对象
result = export_3mf("output.3mf", objects=my_objects, use_orca_format="AUTO")

# 批量操作
from io_mesh_3mf.api import batch_import
results = batch_import(["a.3mf", "b.3mf"], target_collection="Imports")

在以下情况下使用API：

• 批量处理3MF文件
• 在不创建Blender对象的情况下检查归档文件
• 将3MF导入/导出集成到另一个插件中
• 围绕Blender 3MF工作流构建自定义自动化

文档：

• GitHub上生成的API文档
• CloneCore上的更美观的生成文档

• 标准3MF几何体和构建数据
• 材质扩展数据，包括颜色、纹理和活动PBR属性
• 生产扩展项目
• 切片器风格的MMU分割数据
• 元数据、自定义字段和保留的切片器配置块
• 三角集和特定于切片器的对象注释

• 符合规范的标准3MF归档文件
• 切片器风格的多色、绘制、接缝、支撑和修改器部件导出
• 嵌入式缩略图
• 组件层级或扁平化导出，适用于要求更严格的下游工具
• 元数据和保留的往返数据

• 用于元数据和对象信息的3MF侧面板
• 为Orca/Bambu工作流分配修改器部件类型（不兼容Prusa）
• 三角集命名UI
• MMU绘制、烘焙到绘制、支撑/接缝绘制和清理工具
• 插件偏好设置中保存的切片器配置文件管理

此插件面向3MF核心规范v1.4.0，并支持超越纯几何体的现代3MF工作流。

支持的扩展系列包括：

• 核心材质/基础材质
• 材质扩展
• 生产扩展
• 三角集支持
• 特定于供应商的Orca/Bambu和Prusa兼容数据路径

对于格式错误或不完整的文件，插件会尝试在可行的范围内恢复，同时仍然强制执行关键的导出端要求，如有效的归档结构、模型XML、单位和构建定义。

如果导入或导出时出现问题，请从这里开始：

• 故障排除与常见问题

其中涵盖的常见问题包括：

• 导入后缺少颜色
• MMU绘制数据未显示为可编辑绘制区域
• 密集绘制网格上的导入/导出速度慢
• 切片器未拾取耗材分配
• 打印服务拒绝组件层级

从Ghostkeeper的原始Blender 3MF插件分支，并由Jack（2025–）现代化。

• 原作者：Ghostkeeper（2020–2023）
• 分支与维护：Jack（2025–）

所有原始署名和GPL v2+许可证均保留。

GPL v2+