May. 4, 2026
Unofficial MakerWorld PMM OpenSCAD Reference
I made an unofficial MakerWorld PMM OpenSCAD reference.
I put this reference together with the assistance of Codex. I supplied the idea and directed the work; Codex did the research, coding, and documentation, including collecting the PMM rules and building the font index. Codex also drafted this post.
The short version is that I wanted Codex to help me make MakerWorld-customizable OpenSCAD models, and I did not want it guessing from old forum posts, UI behavior, and whatever I happened to remember at 1 AM.
This started because I wanted to use agents on my own OpenSCAD projects without re-teaching the same MakerWorld-specific weirdness every time.
The documentation problem
MakerWorld’s Parametric Model Maker is genuinely useful. OpenSCAD plus a web customizer is a great fit for 3D-printable stuff where the interesting part is “same idea, slightly different dimensions.”
If you have not run into it before, OpenSCAD is CAD by writing code. You write variables, modules, and geometry operations, and it turns that into a model. That makes it very good for customizable prints, and very annoying when a target platform has extra rules.
Unfortunately, the OpenSCAD side of PMM is documented in a very internet way. Some of it is in release posts. Some of it is in support replies. Some of it is in the actual web app. Some of it is people trying things and reporting what happened.
There is a Bambu forum thread literally titled Any Documentation on Parametric Model Maker?. The first post asks where to find the requirements for making customizable models. That felt familiar.
For a human, scattered docs are annoying. For a coding agent, they are a great way to get plausible garbage. It might write OpenSCAD that looks fine locally but misses MakerWorld’s actual rules. It might invent a PMM feature because it saw something sort of similar somewhere else.
I do not want an agent inventing // preview[...] as a PMM feature. I want it to know that // color is a thing, // font is a thing, mw_plate_N() is a thing, and default.svg is not just some random example filename.
So I had Codex collect those rules into a reference under my direction.
What the reference covers
The repo is basically a practical map of the PMM OpenSCAD surface:
- the PMM OpenSCAD API
- an agent workflow for converting normal OpenSCAD into PMM-ready OpenSCAD
- gotchas that agents are likely to mess up
- compatibility rules
- public source snapshots
- patterns and checklists
- a generated docs site
The small examples are the important ones:
accent = "#FF0000"; // color
font_name = "Roboto"; // font
module mw_plate_1() {
// printable plate here
}
module mw_assembly_view() {
// preview-only assembly here
}
svg_file = "default.svg";
None of that is hard once you know it. The problem is making sure the agent knows it before it starts “helping.”
I also had Codex build a PMM font index. It has 1881 MakerWorld PMM font families and 8267 exact PMM font strings. This got more elaborate than I expected, but fonts are exactly the kind of thing where an agent can confidently choose something that works on your machine and then does not work where the model actually runs.
Why agent-first
This is not meant to replace the official PMM UI or be a polished tutorial for someone’s first customizable model. It is mostly a pile of receipts and instructions for agents.
Point Codex or another coding agent at the repo, then ask it to adapt a .scad file for MakerWorld. The repo gives it rules to retrieve before it starts editing:
- flatten local includes when PMM probably will not have them
- do not remove bundled PMM libraries like BOSL2 just because arbitrary local includes are risky
- use PMM upload defaults like
default.svganddefault.stl - add
// colorand// fontonly where those controls are intended - treat multi-plate output as a publishing decision, not just a module name
- cite whether a claim came from an official app endpoint, official release, employee reply, community report, or inference
That last part matters. I do not want a pile of agent-generated confidence. I want the agent to say why it thinks something is true.
The repo
The project is here:
https://github.com/nelsonjchen/unofficial-makerworld-parametric-model-maker-openscad-docs
The generated docs site is here:
https://nelsonjchen.github.io/unofficial-makerworld-parametric-model-maker-openscad-docs/
This is unofficial, not endorsed by Bambu Lab or MakerWorld, and not a license grant for any font, library, model, or web asset. It is practical documentation from public sources and reverse-engineering.
It is also probably incomplete or wrong in places. PMM keeps changing, and some of this stuff only becomes obvious after someone trips over it.
Anyway, this mostly exists so my agents stop making the same MakerWorld OpenSCAD mistakes. If it saves someone else from digging through forum threads while trying to publish a customizable model, great.
