Files
spigot-heights/design/user-stories/us-004-configure-and-persist.md
T
dmg fd601961eb
Release / release (push) Successful in 2m11s
CI / build (push) Successful in 54s
feat(potions): add restoration potion for default player size
2026-09-06 19:42:17 -04:00

1.3 KiB

type, title, description, status
type title description status
User Story US-004: Configure and persist stature behavior Give operators validated settings and durable UUID-keyed player scales. 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

  • Defaults are minimum 0.4, maximum 2.0, adjustment step 0.1, launcher threshold 0.5, speed 1.5, and cooldown 20 ticks.
  • Configuration requires finite positive values, minimum no greater than maximum, and a launcher threshold within the supported scale range.
  • Invalid startup configuration disables the plugin with a clear error.
  • Player scales are stored by UUID using atomic file replacement where supported.
  • Updating known state preserves unknown forward-compatible YAML fields.
  • Missing state defaults safely to scale 1.0 clamped to the configured range.
  • Saved out-of-range state is clamped before it is applied, except exact scale 1.0, which is preserved for restoration.
  • Configuration and state behavior have automated tests.