Log inGet started
Package

mmparts.module

Newest version

README.md

mmparts

The placeable part catalog for The Marbleworks: 17 machine parts, each with a builder (visual children + explicit colliders), an optional per-frame tick (animated rotors, doors, lifts), and an optional onMarble interaction hook.

Flow convention: parts drop one full cell — entry at the top of the +Z face, exit at the bottom of a face (curves and splitters exit sideways). Flat parts (booster, gate, switch, flipper, spinner) run at cell-bottom level and rely on boosters for momentum. yaw 0-3 rotates in 90-degree steps; a free fine angle is added on top for wheel fine-turns.

Catalog: ramp, curve, halfpipe, funnel, spiral (2 cells tall), booster, bumper, flipper, splitter, gate, switch, trapdoor, spinner, chime, screw (3 cells tall, carries marbles UP), hopper, goal.

Moving parts use physics-safe mechanisms: scripted impulses for flipper, spinner, and bumper; collider remove/re-add for gate doors, trapdoor flaps, and splitter flaps (moved colliders do not track transforms).