---
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, except exact scale `1.0`, which is preserved for restoration.
- [x] Configuration and state behavior have automated tests.

## Related

- [User-story catalog](index.md)
- [US-006: Restore default stature](us-006-restore-default-stature.md)