Repository navigation
CamCraft 0.24.0 - a clean-room CAM system that turns 3D models into
NC programs for CNC milling and turning.
- Full history: CHANGELOG.md
- Roadmap: the open issues are the current roadmap
- Questions: ask on Discord
What's in this release
Released 2026-11-18.
Breaking
Two changes are breaking. The project file format goes from version 67 to
69. 0.24.0 opens the files of 0.23.0 and older. 0.23.0 and older builds
refuse a file that 0.24.0 saves.
- 2D Pocket no longer has the Adaptive strategy (#1517, PR #2253;
format 69). Use the 2D Adaptive operation. A project from an older build
that has a Pocket with Adaptive opens with that operation changed to 2D
Adaptive (Spiral). If a setting could not be carried over (rest machining,
predrilled holes), the operation is marked "needs review" and its post is
held until you mark it reviewed (MCPmark_operation_reviewed). - A through hole breaks through by the full drill diameter by default
(#2441, PR #2504; format 68). The drill point length is added to the
break-through (Full diameter;Tipkeeps the old depth). Holes in a
project from an older build keep the oldTipbehaviour. The stock
simulation now cuts the drill cone, and MCPlist_operation_typesshows
break_through.
A minor release headlined by WCS Flip X / Flip Y carried into Fanuc and
Haas programs, move and rotate handles for parts in the viewport, a
Mach4 milling post, STEP tool holders converted to DXF profiles,
2D Contour tabs that leave a bridge of the width you set, and more
dwell words refused by name instead of dropped. 92 pull requests merged
since 0.23.0 (12 features, 60 fixes, 1 performance change, 2 refactors,
docs, tests and process).
Upgrade notes
- Save a project in 0.24.0 only when each person who opens it also has
0.24.0. Older builds refuse format 69 (see "Breaking"). - Projects with 2D Contour tabs get wider gaps in the tool path on the next
generate, so that the bridge that stays on the part is the tab width
(#2480, PR #2486). Before, a tab width equal to or less than the tool
diameter left no tab, and the part came free. - Tools get stable tool numbers (the lowest unused number) when they are
added, imported, or loaded from an older project (#2442, PR #2488). Check
the T numbers of an older project before you post it. - A program can now be refused where 0.23.0 posted it without a dwell (see
"Changes to posted G-code"). Set the dwell to 0, or use a cycle that has a
dwell on that control.
Changes to posted G-code
These change the program that an existing project posts, or stop a post that
went through before.
- Flip X / Flip Y is posted on the Fanuc and Haas posts (#1649,
PR #2492): the program mirrors the flipped axis, with the arc direction and
the compensation side kept correct. A flipped Z, a probe operation in a
flipped setup and the other posts still refuse by name. - Dwells that a cycle cannot carry are refused by name, never dropped:
- grblHAL and Tormach write P0 on the opening G86 block when the bore
dwell is 0 (#2362, PR #2532). - Tormach PathPilot refuses a move with no A word inside an operation
indexed away from A0 (#2473, PR #2490). Before, the post turned A back to
A0 in the middle of the operation. - Tormach 770MX + microARC 4 no longer has the unverified -360..360
A-travel limit; continuous multi-turn A programs post (#2471, PR #2513). - Fanuc lathe threading can post optional in-pass chip-break dips as
continuous G32 segments (#419, PR #468). - The opening approach starts over the setup's WCS origin, not the world
origin (#2382, PR #2420). - Toolpath changes that show in the posted program:
- 2D Contour tab width is the bridge that stays (#2480, PR #2486); picked
open contour runs join, and inside corners offset correctly (#2277,
PR #2487). - Whole-model 2D Contour continues across lower stepped, chamfered and
slotted outlines down to Bottom Z, or refuses by name (#2436, PR #2460). - A no-pick 2D Chamfer on an edge that is already chamfered rides the wall
under the bevel; verify blocks a cone tip inside the part (#2435,
PR #2450). - Raster 3D finishes cross a hole or slot narrower than the tool in one
feed (#2431, PR #2478). - Adaptive 3D Pocket cuts the stock ring around a whole model from the air
outside the stock where that is proved clear (#1950, PR #2035). - Outside containment on clearing operations clears from the setup stock
(#2232, PR #2383). Whole-model and stock-source 2D clearing keeps part
islands blocked when it extends outside the stock (#2438, PR #2503). - Multi-piece pockets keep their pass starts (#2426, PR #2427).
- A tilted (3+2) operation measures its reference heights along its tool
axis (#2389, PR #2418).
- 2D Contour tab width is the bridge that stays (#2480, PR #2486); picked
Highlights
Posts and machines
- A clean-room Mach4 milling post with 3-axis G94 and 3+2 AC trunnion
support (#1968). - The post engine reports script errors at your own line and column, refuses
endless loops, deep recursion and oversized output, and has a blank post
template and preview samples (#2069). - The machine and post lists follow their folders; the Setup page lists your
own machines first (#2380, #2358). - Bake states that it posts table coordinates without a control rotation
(#2359).
Operations
- Part alignment: all ten 5-axis and rotary operations (#2286), Deburr
(#2284), and Lathe, MillTurn, Plasma, Wire EDM and Sinker EDM operations
(#2287) work in aligned setups. - A Drill operation names each hole that is wider than its drill (#2496).
- The Heights tab shows clearance advice when the clearance plane is inside
the stock (#2131).
Tools
- ISO 13399 STEP tool holders convert to half-profile DXFs; DXF profiles
import and export in the UI and MCP (#743). - A refused tool names itself and the rule that it breaks (#1186).
Viewport and UI
- Move handles drag a part along an axis (#1198); a Rotate mode turns it by
a ring (#2047). Each drag is one undo step. - The WCS page has Set origin in its footer, flags unapplied edits, and says
where the origin is in words (#870). - Picked geometry has one readable name instead of a hexadecimal id (#2403).
- Tab, Shift+Tab and Enter move between the value fields of a page (#2516).
- Tilted height planes follow the tool axis (#2416). The near plane no
longer clips while zooming (PR #1689). A lathe without a Y axis hides Y on
the gizmo (#2019). - Property labels, dropdowns and Geometry rows fit narrow panels (#2295,
#2065, #1688). - A Donate button in the top bar (#2385).
Simulation
- The simulation draws the stock body again during playback (#2396), and
plays up to the first operation that has no toolpath (#2280).
MCP, examples and diagnostics
- MCP can delete a model as an undoable step (#2444). Generate without a
name regenerates operations that became stale in the same call (#2439). - An example catalog (
examples/catalog/), seeded with2d/first-part
(#2393); refreshed first-part and router NC examples (#2422). - Library and UI diagnostics go through the filtered terminal log (#163).
Desktop startup keeps GPU diagnostics and backtraces (#2421). - The User Guide has reproducible screenshots (#1902) and a Windows
troubleshooting guide (#2423).
Not exercised on a real control
No real control ran the output of these changes. The test goldens are
regression records. Check the first program on the machine before cutting.
- The Flip X / Flip Y mirror on Fanuc and Haas (#1649).
- The G73, G84 and G85 dwell refusals (#2354, #2356, #2357) and the grblHAL
and Tormach G86 P0 (#2362). - The Tormach A-word refusal (#2473) and the microARC 4 multi-turn A travel
(#2471). - The Mach4 post (#1968) and the Fanuc lathe chip-break dips (#419).
- The drill point break-through depth (#2441).
Known issues
No P1 or P2 issue was open at the cut line (2026-11-18 17:33 UTC), and
none was filed during the cut. Two open defects have a workaround:
- #2561 (P3): 2D Contour tabs - the bridge check compares only neighbouring
cuts. Check the bridges in the simulation when tabs stand close together. - #1950 (P3, blocked): 3D Pocket Adaptive on a whole model. The stock ring
around the part exceeds the planner limits. The planner then refuses
Adaptive on that level with a note, and Offset rings cut the level. The
output is safe. The release gate skips the three tests that pin this issue
and checks that they still fail (xtask/src/known_fail.rs).
Process changes
PROCESS_VERSION went from 89 to 100 (pinned issue #681):
- 90: the cut list and the cut line replace the P1/P2 start condition; a
gate-map pin for the rotated WCS control suite. - 91: the FreeBSD backfill workflow.
- 92:
cargo xtask docs-images. - 93-94: MCP skill rows for
set_stock_material,cutting_dataand
delete_model;cargo xtask catalog. - 95: the release gate runs its suites in a longest-first queue.
- 96: the
set_wcs_fliprow names the refused operations. - 97: heavy release tests run first; AGENTS.md "Agent roles".
- 98:
merge-planwarns on a stale review marker; LF endings for shipped
NC examples. - 99: the MCP skill drops Pocket Adaptive.
- 100: the MCP skill documents operation notes and corner checks.
Report a bug or ask for a feature
- Found a bug? Open a bug report: a
toolpath that looks wrong, a crash, or a refusal you think is mistaken. - Want a feature or an enhancement? Request it:
say what you are trying to machine and what is in the way. - Not sure? Ask on Discord first.
Thanks
Thank you to everyone who contributed to this release: