# MyBenchLab

> Visual mechanism simulator. Compose a bench of connected mechanical components (gears, shafts, …) and watch motion propagate in 3D. Kinematic, deterministic, extensible via a plugin registry.

## Guide
- [MyBenchLab — documentation](https://mybenchlab.ai/docs): Overview of what MyBenchLab is, the mental model, and where to go next.
- [Guide — building your first bench](https://mybenchlab.ai/docs/guide): End-to-end walkthrough of composing, editing, simulating, and saving a bench.
- [Peças — desenho paramétrico](https://mybenchlab.ai/docs/pecas): Desenhe uma peça em 2D (esboço), restrinja com intenção, transforme em sólido 3D (pad, revolução, pocket, filete, chanfro), salve na biblioteca e use na bancada.
- [Ficha técnica](https://mybenchlab.ai/docs/ficha-tecnica): O documento de usinagem pronto para imprimir de uma peça salva: bloco de título, tolerância geral ISO 2768, cotas e tolerâncias, desenho cotado e anotações de usinagem — tudo derivado do histórico paramétrico.
- [DSL reference](https://mybenchlab.ai/docs/dsl): Authoring surface of the bench source: defineBench, category namespaces, connections, drivers, groups, and inline kinds.
- [Groups — subassemblies with explicit ports](https://mybenchlab.ai/docs/groups): Wrap a sub-graph behind an id namespace and a ports map so it can be reused like a single component.
- [Static workbench — assembling benches and frames](https://mybenchlab.ai/docs/static-workbench): How to build a non-moving structure from steel profiles, sheets, wood panels and fasteners, joined by weld and rest, validated for connectivity, envelope and interference.
- [File format — .mbl, .mblext and import/export](https://mybenchlab.ai/docs/file-format): The portable .mbl container (bench) and .mblext (extension pack): what they hold, how import/export works, the scene3d converter, and the automatic bill of materials.
- [MCP — connect an AI agent to your benches](https://mybenchlab.ai/docs/mcp): How to mint a Personal Access Token, connect Claude or any MCP client, and author, validate, simulate and export benches through the MyBenchLab MCP tools.
- [Custom components](https://mybenchlab.ai/docs/custom-components): How to register a new component or connection kind. The plugin API contract and versioning rules.

## Components
- [Bevel gear](https://mybenchlab.ai/docs/components/bevel-gear): Cone-shaped gear for transmitting rotation between intersecting axes. Two bevel gears of the same module mesh with their axes meeting at `pitchAngle_a + pitchAngle_b` (usually 90°).
- [Hex bolt (metric)](https://mybenchlab.ai/docs/components/bolt): Simplified metric hex bolt: hex head plus plain shank (no thread modeled). Runs along local Z, head at the +Z end. For fastened joints and the BOM.
- [Caster wheel (rodízio)](https://mybenchlab.ai/docs/components/caster-wheel): Swivel caster: square mounting plate + steel fork + nylon wheel. Bolts under a leg or a base frame so the assembly rolls. Plate faces up (+Y), wheel touches the floor (−Y).
- [Crank (lever)](https://mybenchlab.ai/docs/components/crank): Rigid arm that rotates around a pivot. The pivot sits at the component origin; the arm extends along the local +X axis for `length` mm. Same single rotational port as a shaft, different visual footprint.
- [Custom part (peça própria)](https://mybenchlab.ai/docs/components/custom-part): A part you drew in the sketch/body editor (the parts library) placed into a bench. It carries a reference to the saved body plus a denormalized snapshot of its bounding box, weight and material, so the bench renders the real evaluated mesh while its graph, layout and BOM stay self-contained.
- [Drawer slide (corrediça)](https://mybenchlab.ai/docs/components/drawer-slide): A telescopic steel drawer slide. Runs along its local Z axis; the section is width (X) × height (Y). Comes in pairs (one per side).
- [Generic solid](https://mybenchlab.ai/docs/components/generic-solid): Neutral rectangular block used as a bounding-box stand-in for parts that do not yet have a dedicated kind (round bar, channel, custom profiles). Sized width (X) × height (Y) × length (Z), centered on the local origin.
- [Pull handle (puxador)](https://mybenchlab.ai/docs/components/handle): A tubular U-shaped pull handle: a grip along local X standing off the surface by its two legs along local Y. For drawers, doors and lids.
- [Helical gear](https://mybenchlab.ai/docs/components/helical-gear): Cylindrical gear with teeth cut at a helix angle. Quieter engagement than a spur gear; meshes with another helical of the same normal module and equal helix angle with opposite hand on parallel axes via `mech.helicalMesh`.
- [Butt hinge (dobradiça)](https://mybenchlab.ai/docs/components/hinge): A flat steel butt hinge: two leaves and a knuckle pin. Shown open and flat — leaves span local X (width), pin runs along local Z (length), thin along local Y.
- [HTD 5M pulley](https://mybenchlab.ai/docs/components/htd5m-pulley): Synchronous timing-belt pulley with the HTD 5M profile (5 mm pitch, curved teeth) and optional side flanges. Meshes with HTD5M timing belts; 3D-printable.
- [Leveling foot (pé nivelador)](https://mybenchlab.ai/docs/components/leveling-foot): Adjustable foot: a round base pad and a threaded stud that screws into a leg to level a bench on an uneven floor. Pad at the bottom (−Y), stud pointing up (+Y).
- [Motor](https://mybenchlab.ai/docs/components/motor): Rotational source. Produces a constant RPM on its axis port every tick; connecting a shaft or gear via `mech.couple` / `mech.mesh` drives the downstream chain.
- [Extruded profile (gusset / plate)](https://mybenchlab.ai/docs/components/profile): A custom 2D polygon extruded along local Z — for gussets, brackets, mão-francesa braces and cut plates. Points are [x, y] pairs in mm, authored counter-clockwise; the shape is centered and extruded by `thickness`.
- [Pulley](https://mybenchlab.ai/docs/components/pulley): Smooth rotating disc used as a belt anchor. Pairs with another pulley via `mech.belt`; the ratio is driven by the pitch diameters.
- [Rack](https://mybenchlab.ai/docs/components/rack): Straight toothed bar. Engages a spur gear (the pinion) via `mech.rackPinion`; the pair converts rotation into linear translation along the rack local X axis.
- [Shaft](https://mybenchlab.ai/docs/components/shaft): Cylindrical rotating axle. Typically anchors one or more gears via `mech.couple` so they spin together.
- [Sprocket](https://mybenchlab.ai/docs/components/sprocket): Toothed wheel that engages a chain without slipping. Pairs with another sprocket via `mech.chain`; the ratio is driven by tooth counts (not diameters, unlike pulleys).
- [Spur gear](https://mybenchlab.ai/docs/components/spur-gear): Cylindrical gear with straight teeth. The canonical mechanical building block: mates with other spur gears of the same module via `mech.mesh`.
- [Steel angle (L-profile)](https://mybenchlab.ai/docs/components/steel-angle): Equal-leg L-section steel bar for brackets, gussets and reinforcement. Cross-section leg × leg, length along local Z.
- [U steel channel](https://mybenchlab.ai/docs/components/steel-channel-u): Open U (channel) steel section — a stiff cross member. Web along local X, flanges rising along local Y, length along local Z.
- [Steel flat bar](https://mybenchlab.ai/docs/components/steel-flat-bar): Solid rectangular steel bar (barra chata) for braces, straps, feet and gussets. Width along local X, thickness along local Y, length along local Z.
- [Steel sheet](https://mybenchlab.ai/docs/components/steel-sheet): Flat steel plate. Lies flat: length along X, width along Z, thickness along Y. Use as a metal worktop, gusset, or base plate.
- [Rectangular steel tube](https://mybenchlab.ai/docs/components/steel-tube-rectangular): Hollow rectangular-section steel profile for frame rails and stretchers. Section w (X) × h (Y), length along local Z.
- [Round steel tube](https://mybenchlab.ai/docs/components/steel-tube-round): Hollow round-section steel tube for handrails, legs and light frames. Runs along its local Z axis; rotate it to stand or lie as needed.
- [Square steel tube (metalon)](https://mybenchlab.ai/docs/components/steel-tube-square): Hollow square-section steel profile — the primary structural member for benches and frames. Runs along its local Z axis; rotate it to stand or lie as needed.
- [Wood panel](https://mybenchlab.ai/docs/components/wood-panel): Flat wood board — OSB, MDF, plywood or pine. The classic bench worktop or shelf. Length along X, width along Z, thickness along Y.
- [Worm](https://mybenchlab.ai/docs/components/worm): Single- or multi-start helical screw. Pairs with a spur gear (the worm wheel) via `mech.wormMesh` for very high reduction ratios (typical 1:20 up to 1:100).

## Connections
- [Belt](https://mybenchlab.ai/docs/connections/belt): Flexible loop coupling two pulleys. Preserves direction (open belt) or flips it (crossed belt).
- [Bevel gear mesh](https://mybenchlab.ai/docs/connections/bevel-mesh): Couples two bevel gears of the same module. Axes meet at pitchAngle_a + pitchAngle_b (typically 90° for mitre bevels).
- [Bolted joint](https://mybenchlab.ai/docs/connections/bolted): Fastened face-to-face junction: the driven part is placed flush against a named face of the anchor (like a weld), but the joint is bolted rather than welded — it feeds the fastener BOM. Zero gap by default.
- [Chain](https://mybenchlab.ai/docs/connections/chain): Toothed loop coupling two sprockets of the same pitch. Non-slipping — driven sprocket ratios by tooth count (not diameter).
- [Gear mesh](https://mybenchlab.ai/docs/connections/gear-mesh): Couples two spur gears of the same module. The layout solver places the driven gear tangent to the anchor on the chosen side.
- [Helical gear mesh](https://mybenchlab.ai/docs/connections/helical-mesh): Couples two helical gears of the same normal module on parallel axes. A mating pair must share the helix angle magnitude and have opposite hands.
- [Inset (snug fit)](https://mybenchlab.ai/docs/connections/inset): Interlocking junction: the driven part fits into the anchor. v1 places the driven flush against a named anchor face (`align: "center"` for a concentric let-in). Zero gap by default.
- [Rack and pinion](https://mybenchlab.ai/docs/connections/rack-pinion): Couples a spur gear (pinion) to a rack. Converts rotational motion into linear translation along the rack local X axis.
- [Rest](https://mybenchlab.ai/docs/connections/rest): Gravity rest: the driven part sits on the top surface of the anchor. The layout solver aligns the driven bottom face with the anchor top face and centers it over the support.
- [Shaft coupling (rigid)](https://mybenchlab.ai/docs/connections/shaft-coupling): Rigid 1:1 coupling between two rotational ports. Propagates ω unchanged; typically used to mount a gear on a shaft or to join two collinear shafts.
- [Weld](https://mybenchlab.ai/docs/connections/weld): Rigid face-to-face junction between two structural parts. Prefer the assembly-solver hints (`face` + `align`): the driven part is placed flush against a named face of the anchor, gap 0 by default. Without hints it keeps the legacy world-axis `axis`/`side` placement.
- [Worm mesh](https://mybenchlab.ai/docs/connections/worm-mesh): Couples a worm (driver) to a spur gear (the worm wheel). Yields very high reduction ratios; when `starts = 1` the pair is often self-locking.

## Raw markdown

Every page above is also available as plain markdown for direct ingestion. Append `.md` to the URL, or fetch `/docs-raw<path>.md`. For example:

- https://mybenchlab.ai/docs-raw/docs.md
- https://mybenchlab.ai/docs-raw/docs/guide.md
- https://mybenchlab.ai/docs-raw/docs/pecas.md
- https://mybenchlab.ai/docs-raw/docs/ficha-tecnica.md