SolidCraft Gears

Run SolidCraft in your browser

The official web build, loaded right here. No install, no account. Desktop browser with a mouse recommended.

Loads the open-source web build (a few MB). Your models stay in your browser.

Next: get the desktop app

We picked your system. Files come straight from the official GitHub release (always the latest version).

Latest release: v0.44.1 (17 November 2026)

The installers are not code-signed yet, so Windows or macOS may warn you the first time. How to get past the warning.

Open SolidCraft above to try a gear train in your browser, or download it for your desktop. This page covers how gears, internal gears, rack and pinion and screw motion work in SolidCraft. Everything here comes from SolidCraft's own documentation, linked at the bottom.

New to the app? Start with the SolidCraft tutorial first. This page assumes you already know how to place parts and add a joint; see SolidCraft assembly for that groundwork.

The gear joint

Gear, on the ASSEMBLE panel, couples two joints that turn. It is a motion link, not a joint type of its own: you still connect each gear to its shaft with a revolute joint, then add a Gear link between the two revolute joints.

The ratio comes from the parts, not a number you make up:

With a plain Gear link, the second joint turns the opposite way to the first, scaled by the ratio. Internal gear flags one side as a ring gear instead of an external gear, and the two joints then turn the same way — the usual behaviour of a planet turning inside a ring.

Rack and pinion, and screws

Two related links sit next to Gear on the same panel:

SolidCraft has no dedicated worm-gear link. A worm-and-wheel pair is normally built as a Screw joint on the worm's shaft driving the wheel, since a worm is mechanically a single-start or multi-start screw.

Why the ratio keeps up with your design

A radius, tooth count or pitch can be an expression of the design's own parameters, and a picked face is re-found every time the design changes. Resize a gear or edit its tooth count, and the ratio follows automatically — the link does not need to be redone. Creating or redefining a link (including Reverse) leaves the driven joint exactly where it is, so teeth you modelled in mesh stay in mesh instead of snapping to a default pose.

Gears in motion studies and gear trains

Once the link exists, a gear behaves like any other motion link in SolidCraft:

Drive the joint that drives the coupling — the pinion's shaft, or the screw's turn — not the one being driven; SolidCraft refuses a link that would have a joint drive its own driver.

One practical note for a full gear train with detailed tooth geometry: interference checking has a fixed work budget per run, and a train with many meshing teeth can use it up before finishing. Give the check a budget_s (seconds) to let it run longer instead of truncating.

Where to go next

For how gears sit inside the wider joint system — grounding, the seven joint types and the bill of materials — see SolidCraft assembly. For cam-driven motion instead of gears, see SolidCraft CAM. To set ratios and tooth counts from a script or an AI agent instead of the UI, see the SolidCraft CLI and SolidCraft MCP server.

Ready to start? Go back to SolidCraft online and open the app.

FAQ

Does SolidCraft have a gear tool?

Yes, on the ASSEMBLE panel. The Gear link couples two joints that turn, with a ratio you either pick (the round face of each gear) or type as radii or tooth counts.

Can SolidCraft model an internal (ring) gear?

Yes. Internal gear is the same link with one side flagged as a ring gear, and it turns both joints the same way instead of opposite ways.

Does SolidCraft support rack and pinion?

Yes, as its own joint: the rack travels the pinion's pitch radius times its turn in radians. Either the rack or the pinion can drive the other.

What about worm gears or lead screws?

There is no separate worm-gear link. A lead screw is the Screw joint, which advances a set pitch per turn and can be reversed to left-handed; a cylindrical joint is a screw on its own axis.

Do the gears stay meshed when I change a parameter?

Yes. A radius or pitch can be a design parameter, and the picked gear face is found again whenever the design changes, so resizing a gear keeps the ratio current without unmeshing the teeth.

Sources

Last updated: