spigot-heights/design/user-stories/us-004-configure-and-persist.md

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.
• Configuration and state behavior have automated tests.

Related

• User-story catalog