Files
purpur-tyrant/design/user-stories/us-021-claim-tyrant-legacy-armor.md
T
dmg 0c4a95801a
Release / release (push) Successful in 2m56s
CI / build (push) Successful in 1m12s
feat(gear): add Tyrant legacy tools and weapons
2026-09-09 22:02:59 -04:00

3.0 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 total rewards without any armor-first requirement; armor commands, enchantments, and saved claims remain compatible.

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.