spigot-heights/design/log.md

type, title, description

type	title	description
Log	Spigot Heights Design Log	Chronological record of material decisions affecting Spigot Heights.

Spigot Heights Design Log

2026-09-04 — Initial design approved

• Player scale defaults to a configurable range of 0.4 through 2.0.
• A moderate recipe creates a random stature potion; more expensive upgrades create targeted growth and diminution potions.
• Random stature is selected uniformly in configurable 0.1 increments.
• Players strictly below scale 0.5 can be launched through a dispenser fed by the hopper beneath them.
• Launcher speed defaults to 1.5 blocks per tick with a 20-tick cooldown and safe-exit checks.
• The project follows the neighboring Spigot Base Java 25, Purpur, Gradle, OKF, CI, and release conventions.

2026-09-04 — Implementation started

• Approved implementation began with user stories, tests, and the Gradle/Purpur foundation.

2026-09-04 — Initial release scope completed

• Implemented authenticated random, growth, and diminution potions with approved recipes and durable UUID-keyed player scale.
• Added validated stature and launcher configuration with safe clamping to Minecraft's scale range.
• Implemented cooldown-protected hopper-to-dispenser launch tubes for tiny players with six-axis launch support and empty-exit checks.
• Added the Java 25 Purpur build, automated tests, Gitea CI and semantic-release workflows, README, and project-specific agent guidance.
• Verified the implementation with ./gradlew clean check jar and created the public dmg/spigot-heights Gitea repository.