1.9 KiB
1.9 KiB
type, title, description, status
| type | title | description | status |
|---|---|---|---|
| User Story | US-008: View and set player height | Let administrators inspect and persistently set online player scales through tab-completed commands. | 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
/heights player <name>reports the online player's scale, where1.0is normal size./heights player <name> <scale>immediately applies and saves the scale by UUID for reconnects and respawns.- Operators and senders with
spigotheights.admincan use the commands, including console and targeting themselves. - Tab completion suggests online player names and valid example sizes, filtered by prefix; unauthorized senders receive no suggestions.
- Values must be finite and within current configured limits, except exact
1.0is always allowed as the restoration exception. - Invalid input, unknown/offline players, and persistence failures produce clear messages; failed saves do not change live or cached player height.
- Automated tests and README documentation cover viewing, setting, permissions, completion, validation, and persistence.
Verification
./gradlew clean check jarpassed 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.