conversor3mf

Print MakerWorld multicolor models on an Anycubic Kobra X without recoloring anything. Português

Most multicolor 3MF files on MakerWorld are made for Bambu Lab printers. When you open one in Anycubic Slicer Next, the colors come in the file's filament order, not the order of the spools in your ACE. After syncing the ACE they end up swapped. Painted models are the worst case: the per-object color menu only shows one color, so you end up repainting by hand.

conversor3mf rewrites the project so that each color of the model goes to the ACE slot where that spool already is. It also includes an MCP server, so you can ask Claude to do it for you.

Not affiliated with Anycubic or Bambu Lab. All trademarks belong to their owners. Respect each model's license: the tool converts files you downloaded for your own use and never redistributes anything.

What it does

• Remaps colors. Rewrites per-triangle paint, the filament of each part and per-layer filament changes to your ACE slot order. It picks the closest color (CIEDE2000) and merges identical colors.
• Opens as a native Kobra X project. No "Printer parameter switching" dialog and no geometry-only import.
• Keeps the designer's choices. Layer height, walls, infill, supports, brim, ironing and fuzzy skin carry over. Speeds and temperatures come from the Kobra X system profile.
• Recenters plates. Objects on every plate are centered on the 260 mm Kobra X bed.
• Warns you. It flags colors with no similar spool, more colors than ACE slots, and PLA/PETG mixes.
• Recolors whole regions ("islands"). Turns all holly leaves green or all stars red, including the side walls of raised details, without touching the paint brush.
• Never overwrites anything. It writes <name>_KobraX.3mf next to the original.

Requirements

• Windows with Anycubic Slicer Next installed. It is detected automatically; if not, set CONVERSOR3MF_SLICER to its folder.
• Python 3.10+.
• An Anycubic Kobra X with ACE. Other Anycubic printers may work but are untested; see Limitations.

Install

pip install git+https://github.com/JohnnyTrindade/conversor-3mf

Use with Claude (MCP)

claude mcp add conversor3mf --scope user -- conversor3mf-mcp

Then just ask, in any language:

"Convert C:\Downloads\coaster.3mf for my Kobra X"

"I swapped slot 4 for a yellow PLA"

"In the coaster, make the holly leaves green and the stars red"

Claude shows where each color will go before converting. When recoloring, it looks at a numbered map of the model.

First-time setup: tell it what is in your ACE

1. In Anycubic Slicer Next, select the Kobra X, sync the ACE and save any project.

2. Run this command, or ask Claude to "set up my ACE from that project":

   conversor3mf ace definir "C:\path\to\saved_project.3mf"
   

This saves the printer profile and your slot colors and materials. When you only change a spool's color, update it like this:

conversor3mf ace slot 4 --cor "#FFD700" --tipo PLA

For a material that is not in any slot yet (ABS, TPU…), save a new project with it and run ace definir again.

Your data lives in %APPDATA%\conversor3mf. Change it with CONVERSOR3MF_DADOS.

Command line

conversor3mf planejar  model.3mf               # show which slot each color goes to
conversor3mf converter model.3mf --mapa 1=3    # convert; force filament 1 into slot 3
conversor3mf ilhas     model_KobraX.3mf --vista cima    # numbered map of color regions
conversor3mf repintar  model_KobraX.3mf 32=4,3=3        # recolor islands 32 and 3
conversor3mf verificar model_KobraX.3mf        # reopen in Anycubic Slicer Next and compare

Command and option names are in Portuguese. Run conversor3mf --help for the full list.

How it works

• Color format. A Bambu/Orca 3MF stores filament numbers, not colors. The paint of each triangle is a hex-encoded subdivision tree with a filament number on every leaf. The converter decodes that tree, swaps the numbers and encodes it back. Every other part of the file is left untouched.
• Printer settings. They come from a project saved by your own Anycubic Slicer Next, so no Anycubic profiles are shipped with this package.
• Islands. Connected triangles of the same color, after welding duplicate vertices. When a triangle has several colors, recoloring only changes the leaves of that island's color, including on the island's border.

Limitations

• Verification of multi-plate projects. Anycubic Slicer Next 2.0.0.3 crashes from the command line on any project with more than one plate. Those projects are only checked internally, so open them in the slicer before slicing.
• Plate grid spacing. It is measured only for the Kobra X (314.4 × 328.8 mm). Other printers fall back to 1.2 × the bed size.
• More colors than slots. Similar colors get merged. For multi-plate projects you can print plate by plate and use --mapa.
• Mesh-only 3MF files. Files without a slicer project inside have no colors to convert.

Development

python -m venv .venv
.venv\Scripts\pip install -e .
.venv\Scripts\python -m unittest discover -s tests

The tests use synthetic 3MF files built in tests/fixtures.py and do not need the slicer. ferramentas/testar_na_interface.ps1 opens a file in the slicer GUI, takes a screenshot and closes it.

License

MIT