feat: add stature potions and tiny-player launchers

2026-09-04 11:28:24 -04:00
commit 7bccc727b1
37 changed files with 1490 additions and 0 deletions
@@ -0,0 +1,25 @@
+---
+type: User Story
+title: "US-003: Launch tiny players through dispensers"
+description: Launch sufficiently small players from a dispenser connected to the hopper beneath them.
+status: done
+---
+
+# US-003: Launch tiny players through dispensers
+
+As a **tiny player**, I want connected hoppers and dispensers to act as launch tubes so that my stature enables playful transport systems.
+
+## Acceptance criteria
+
+- [x] A player strictly below the configured threshold triggers when walking onto a hopper whose output points into a dispenser.
+- [x] No redstone signal is required.
+- [x] The player moves to a safe centered position immediately in front of the dispenser and receives velocity in its facing direction.
+- [x] Velocity magnitude and cooldown are configurable and default to 1.5 blocks per tick and 20 ticks.
+- [x] Obstructed or unsafe exits abort without moving the player.
+- [x] Players at or above the threshold are not launched.
+- [x] Cooldown prevents immediate repeated or cyclic launching.
+- [x] Automated tests cover threshold boundaries, orientations, cooldown, and obstruction policy.
+
+## Related
+
+- [US-004: Configure and persist stature behavior](us-004-configure-and-persist.md)