mmparts.module
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).