feat(commands): view and set online player heights

design/user-stories/index.md

@@ -13,3 +13,4 @@ description: Catalog of user stories for the Spigot Heights plugin.
 5. [US-005: Build and release the plugin](us-005-build-and-release.md)
 6. [US-006: Restore default stature](us-006-restore-default-stature.md)
 7. [US-007: Manage stature settings with commands](us-007-manage-settings-commands.md)
+8. [US-008: View and set player height](us-008-manage-player-height.md)

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

@@ -21,8 +21,12 @@ As a **server operator**, I want validated stature and launcher settings with du
 - [x] Configuration and state behavior have automated tests.
 - [x] Approved min/max commands validate and persist changes before publishing live settings to gameplay listeners, without immediately resizing players.
 
+- [x] 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](us-008-manage-player-height.md)
+
 - [User-story catalog](index.md)
 - [US-007: Manage stature settings with commands](us-007-manage-settings-commands.md)
 - [US-006: Restore default stature](us-006-restore-default-stature.md)

design/user-stories/us-007-manage-settings-commands.md

@@ -19,12 +19,18 @@ As a **server administrator**, I want commands with tab completion so that I can
 - [x] Existing players are not immediately resized; subsequent potion use, joins, and respawns use current limits, preserving the restoration exception for `1.0`.
 - [x] Automated tests and README documentation cover commands, permissions, completion, validation, persistence, and live settings.
 
+- [x] Command help and completion include the player-height subcommand without changing existing min/max command behavior.
+
 ## Verification
 
+- Player-command extension verified with `./gradlew clean check jar` (33 passing tests), including existing settings-command regressions and new player-name/size completions.
+
 - `./gradlew clean check jar` passed all 26 tests, including command execution with authorized/unauthorized generic senders, prefix-filtered valid completions, argument validation, failed saves, YAML reload/preservation, and live domain behavior.
 - Code inspection confirms command/permission registration and shared settings suppliers in consumption, join, respawn, and launcher adapters. No live-server command or client tab-completion test was performed.
 
 ## Related
 
+- [US-008: View and set player height](us-008-manage-player-height.md)
+
 - [US-004: Configure and persist stature behavior](us-004-configure-and-persist.md)
 - [US-006: Restore default stature](us-006-restore-default-stature.md)

design/user-stories/us-008-manage-player-height.md

@@ -0,0 +1,30 @@
+---
+type: User Story
+title: "US-008: View and set player height"
+description: Let administrators inspect and persistently set online player scales through tab-completed commands.
+status: done
+---
+
+# US-008: View and set player height
+
+As a **server administrator**, I want to view and set a player's height so that I can manage individual stature without potions.
+
+## Acceptance criteria
+
+- [x] `/heights player <name>` reports the online player's scale, where `1.0` is normal size.
+- [x] `/heights player <name> <scale>` immediately applies and saves the scale by UUID for reconnects and respawns.
+- [x] Operators and senders with `spigotheights.admin` can use the commands, including console and targeting themselves.
+- [x] Tab completion suggests online player names and valid example sizes, filtered by prefix; unauthorized senders receive no suggestions.
+- [x] Values must be finite and within current configured limits, except exact `1.0` is always allowed as the restoration exception.
+- [x] Invalid input, unknown/offline players, and persistence failures produce clear messages; failed saves do not change live or cached player height.
+- [x] Automated tests and README documentation cover viewing, setting, permissions, completion, validation, and persistence.
+
+## Verification
+
+- `./gradlew clean check jar` passed all 33 tests. Coverage includes command routing and permissions, completion, base/effective scale reporting, live limits, the restoration exception, UUID reload, and failed-save protection for live/cached/disk state.
+- Code inspection confirms exact online lookup, scale-attribute access, shared storage with join/respawn handlers, and command registration. No live-server/client test was performed.
+
+## Related
+
+- [US-004: Configure and persist stature behavior](us-004-configure-and-persist.md)
+- [US-007: Manage stature settings with commands](us-007-manage-settings-commands.md)