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, except exact scale 1.0, which is preserved for restoration.

• Configuration and state behavior have automated tests.

• Approved min/max commands validate and persist changes before publishing live settings to gameplay listeners, without immediately resizing players.

• Command-set player heights persist by UUID under existing reload rules; failed saves do not publish a new cached or live height.

Related

• US-008: View and set player height

• User-story catalog

• US-007: Manage stature settings with commands

• US-006: Restore default stature