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-004: Configure and persist stature behavior"
+description: Give operators validated settings and durable UUID-keyed player scales.
+status: done
+---
+
+# US-004: Configure and persist stature behavior
+
+As a **server operator**, I want validated stature and launcher settings with durable state so that behavior remains safe and predictable.
+
+## Acceptance criteria
+
+- [x] Defaults are minimum `0.4`, maximum `2.0`, adjustment step `0.1`, launcher threshold `0.5`, speed `1.5`, and cooldown `20` ticks.
+- [x] Configuration requires finite positive values, minimum no greater than maximum, and a launcher threshold within the supported scale range.
+- [x] Invalid startup configuration disables the plugin with a clear error.
+- [x] Player scales are stored by UUID using atomic file replacement where supported.
+- [x] Updating known state preserves unknown forward-compatible YAML fields.
+- [x] Missing state defaults safely to scale `1.0` clamped to the configured range.
+- [x] Saved out-of-range state is clamped before it is applied.
+- [x] Configuration and state behavior have automated tests.
+
+## Related
+
+- [User-story catalog](index.md)