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:
- Pick the round face of each gear — its pitch cylinder — and SolidCraft reads the radii off the geometry.
- Or type the radii or tooth counts directly. Tooth counts work just as well as radii, since only their proportion sets the ratio.
- Picking a gear's face also tells SolidCraft which joint that gear turns on, so there is no separate step to say which shaft is which.
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:
- Rack and Pinion couples a joint that turns with one that slides. The rack travels the pinion's pitch radius times its turn, in radians — the standard r·θ relationship. Either the rack or the pinion can be the one you drive; the other follows.
- Screw advances a set pitch per turn of a revolute joint, or couples a revolute and a slider the same way. The thread is right-handed by default; Reverse makes it left-handed. A cylindrical joint (one that turns and slides on the same axis) is already a screw on its own, with no separate link needed.
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:
- It drives in Drive Joints and plays back in motion studies.
- It works inside closed loops, so a pinion can steer a linkage through a rack and its tie rods.
- It stops at contact sets, so a design with real tooth geometry can catch gears that would pass through each other.
- A motion link adds no extra freedom of its own: two meshed gears on a fixed housing share one degree of freedom between them, each turning with the one that drives it.
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.