Files
spigot-heights/design/user-stories/us-003-launch-tiny-players.md
T
dmg 7bccc727b1
Release / release (push) Failing after 15s
CI / build (push) Successful in 3m6s
feat: add stature potions and tiny-player launchers
2026-09-04 11:28:24 -04:00

26 lines
1.2 KiB
Markdown

---
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)