feat(commands): view and set online player heights

2026-09-06 20:05:41 -04:00
parent e802319f45
commit f011410b17
15 changed files with 380 additions and 16 deletions
@@ -6,6 +6,18 @@ description: Chronological record of material decisions affecting Spigot Heights

 # Spigot Heights Design Log

+## 2026-09-07T00:00:54Z — Player-height commands completed
+
+- Added `/heights player <name> [scale]` for exact online-player lookup, base/effective scale reporting, immediate saved changes, and permission-protected name/size completion.
+- Command-set scales honor live limits and the exact `1.0` restoration exception. The player-state store now publishes cached changes only after successful persistence, and commands save before applying scale.
+- Verified `./gradlew clean check jar`: all 33 tests passed, including permissions, input validation, completions, scale reporting, reload, and failed-save protection. Inspected Bukkit lookup/attribute and join/respawn wiring; live-server/client verification remains unperformed.
+- Updated README and completed US-008 and related US-004/US-007 criteria.
+
+## 2026-09-06T23:54:36Z — Player-height commands approved and started
+
+- Approved [US-008](user-stories/us-008-manage-player-height.md): `/heights player <name> [scale]` for online players, admin permissions, tab completion, and UUID persistence.
+- Values follow current min/max bounds with the exact `1.0` exception; failed saves must not change cached or live player height.
+
 ## 2026-09-06T23:51:22Z — Settings commands completed

 - Added `/heights settings` and `/heights set min|max <value>` with `spigotheights.admin` (default op), generic sender support, and prefix-filtered tab completion of valid example values.