--uptodate-settings
"s1.json;s2.json"Replace the slicer's own bundled machine and/or process presets with caller-supplied JSON files that --uptodate uses to refresh a BBL 3MF's embedded config; each file's name field must exactly match the system preset name the 3MF records in its inherits_group field.
Details
--uptodate-settings supplies the preset JSON files that --uptodate uses to refresh the machine and process configs embedded in a 3MF. It accepts a semicolon-delimited list of file paths, e.g. "machine.json;process.json". Each file is loaded individually; the slicer inspects the JSON's top-level type key to decide whether it is a "machine" or "process" config. A file whose type is anything other than "machine" or "process" (including "filament") is a fatal error. Filament presets are handled separately by --uptodate-filaments.
Each supplied JSON must carry a name field that exactly matches the system preset name the 3MF records for that config category. The 3MF stores one root system preset name per config type inside its inherits_group field; the machine system preset name occupies the last position of that array, and the process system preset name occupies the first position. Those are the values the slicer compares against each JSON's name. If the name in the supplied JSON does not match what the 3MF expects, the CLI aborts with a config-file error. Passing a renamed copy of a preset or a preset for a different printer model will always fail this check. The JSON's from field must also be present and set to "system", "User", or "user"; any other value is rejected before name matching even occurs.
When --uptodate-settings is omitted but --uptodate is active, the slicer falls back to its own bundled preset files, resolving the machine and process presets by name from the internal profiles directory. Supplying --uptodate-settings lets an automation pipeline inject presets that differ from the bundled copies -- for example, when running a slicer build that does not yet include a recently published preset, or when working with a private preset distribution that ships outside the binary.
Watch out for
- ▲ The `name` inside each JSON must match the system preset name stored in the 3MF, not the filename. Renaming the JSON file is harmless; editing its `name` key, or pointing to a preset for a different machine, is a fatal mismatch.
- ▲ Only `"machine"` and `"process"` configs are accepted. Passing a filament JSON here is an error; filament presets belong to `--uptodate-filaments`.
- ▲ The flag has no effect unless `--uptodate` is also set, and the 3MF must be in the BBL 3MF format. A standard 3MF without the BBL metadata structure skips the entire uptodate path regardless.
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.