Files
purpur-tyrant/design/user-stories/us-021-claim-tyrant-legacy-armor.md
T
dmg afd8a03f1b
Release / release (push) Successful in 2m51s
CI / build (push) Successful in 1m10s
feat(gear): add final unbreakable Elytra reward
2026-09-09 22:28:40 -04:00

3.5 KiB

type, title, description, status
type title description status
User Story US-021: Claim Tyrant legacy armor Let a fully unlocked Tyrant spend later choices on unique tradable armor rewards. done

US-021: Claim Tyrant legacy armor

As a fully unlocked Tyrant, I want to turn later progression choices into named armor so that continued victories create lasting trophies with ordinary player value.

Acceptance criteria

  • Once all six standard reign unlocks are purchased, the active Tyrant may spend each additional unspent choice on one legacy armor piece.

  • Available rewards are a Netherite Helmet, Netherite Chestplate, Netherite Leggings, and Netherite Boots.

  • Each piece has Protection V and Mending I, a display name in the form Tyrant's <player name> <piece>, and lore identifying the named Tyrant and reign reward.

  • Each armor slot may be claimed only once during a reign, limiting a Tyrant to four legacy armor rewards per reign.

  • A successful claim consumes exactly one unspent choice and records the claimed slot durably.

  • Armor is delivered to normal inventory rather than auto-equipped; insufficient inventory space does not consume a choice or record a claim.

  • The armor is ordinary transferable equipment: it may be worn, repaired, enchanted, dropped, traded, stored, or retained after the reign ends.

  • Lost or transferred armor is not recoverable and does not permit that slot to be claimed again during the same reign.

  • Claimed-slot state survives logout and restart, resets when the reign ends, and loads missing legacy state as no claimed pieces.

  • Paused games, non-Tyrants, incomplete standard unlocks, exhausted choices, duplicate slots, malformed requests, and stale or repeated interactions cannot create or duplicate armor.

  • The Tyrant can select and confirm an available armor piece through the existing control panel, using the same domain and persistence rules as the command path.

  • /tyrant armor <helmet|chestplate|leggings|boots> remains available as an alternative and supports contextual completion.

  • The four armor claims coexist with five independent tool and weapon claims, for nine regular rewards without any armor-first requirement; armor commands, enchantments, and saved claims remain compatible.

US-023 extension

Verified with 221 passing tests via ./gradlew clean check jar; see US-023 verification and limitations.

  • Armor remains independently purchasable and unchanged; its four current-reign claims count toward the final Elytra, which is not an armor prerequisite or armor-command option.

US-022 validation

Verified armor delivery/full-inventory safety across all four pieces, armor-only command parsing/completion, existing item specification, older saved claims, and tool-first purchasing with ./gradlew clean check jar (177 passing tests); see US-022 verification.