30 lines
1.6 KiB
Markdown
30 lines
1.6 KiB
Markdown
---
|
|
type: User Story
|
|
title: "US-002: View tree progress"
|
|
description: Show players which species are unlocked and their progress toward the remaining unlocks.
|
|
status: done
|
|
---
|
|
|
|
# US-002: View tree progress
|
|
|
|
As a **player**, I want clear unlock and progress information so that I know which trees I can fell and what to work on next.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] `/treefeller unlocked` lists every supported species in a readable locked or unlocked state.
|
|
- [x] Each locked species includes the player's current qualifying-block count and active threshold.
|
|
- [x] Each unlocked species is clearly distinguished and is not presented as needing further progress.
|
|
- [x] Mining a qualifying block for a locked species displays or updates a boss bar with the species name and numeric progress toward its active threshold.
|
|
- [x] The boss bar reflects a changed threshold the next time qualifying progress is recorded.
|
|
- [x] The boss bar disappears after no qualifying block has been mined for five seconds by default.
|
|
- [x] Mining another qualifying block before timeout restarts the configured visibility period.
|
|
- [x] Boss-bar visibility duration, text, color, and style are configurable.
|
|
- [x] Progress feedback is not displayed for cancelled, ineligible, automatically felled, or already-unlocked blocks.
|
|
- [x] `/treefeller unlocked` and its autocomplete expose no administrative functionality.
|
|
|
|
## Related
|
|
|
|
- [US-001: Earn tree-type unlocks](us-001-earn-tree-type-unlocks.md)
|
|
- [US-006: Announce tree unlocks](us-006-announce-tree-unlocks.md)
|
|
- [US-008: Configure and persist Tree Feller](us-008-configure-and-persist-tree-feller.md)
|