feat(potions): add restoration potion for default player size

2026-09-06 19:42:17 -04:00
parent a06d6480fe
commit fd601961eb
13 changed files with 155 additions and 9 deletions
@@ -0,0 +1,28 @@
+---
+type: User Story
+title: "US-006: Restore default stature"
+description: Let players craft a potion that permanently restores their scale to 1.0.
+status: done
+---
+
+# US-006: Restore default stature
+
+As a **player**, I want a Potion of Restoration so that I can return to normal size.
+
+## Acceptance criteria
+
+- [x] Drinking the potion sets scale to exactly `1.0`, regardless of configured limits.
+- [x] The potion uses distinct persistent metadata rather than its display name for identity.
+- [x] The new scale is reported and saved by UUID, and retained across reconnects and respawns.
+- [x] The recipe is `GAG/ASA/GUG`, where `G` is Gold Ingot, `A` is Amethyst Shard, `S` is an authenticated Potion of Shifting Stature, and `U` is Sugar.
+- [x] Automated tests cover restoration, saved-scale handling, recipe shape, and distinct identity; the README documents the recipe and behavior.
+
+## Verification
+
+- `./gradlew clean check jar` passed all 17 tests.
+- Automated coverage checks scale calculation, storage reload, range exceptions, recipe shape, and enum identity. Code inspection confirms metadata authentication, ingredient registration, and the shared consumption/join/respawn adapters; no live-server gameplay test was performed.
+
+## Related
+
+- [US-002: Make precise stature adjustments](us-002-adjust-stature.md)
+- [US-004: Configure and persist stature behavior](us-004-configure-and-persist.md)