---
type: User Story
title: "US-002: View tree progress"
description: Show players which species are unlocked and their progress toward the remaining unlocks.
status: backlog
---

# 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

- [ ] `/treefeller unlocked` lists every supported species in a readable locked or unlocked state.
- [ ] Each locked species includes the player's current qualifying-block count and active threshold.
- [ ] Each unlocked species is clearly distinguished and is not presented as needing further progress.
- [ ] 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.
- [ ] The boss bar reflects a changed threshold the next time qualifying progress is recorded.
- [ ] The boss bar disappears after no qualifying block has been mined for five seconds by default.
- [ ] Mining another qualifying block before timeout restarts the configured visibility period.
- [ ] Boss-bar visibility duration, text, color, and style are configurable.
- [ ] Progress feedback is not displayed for cancelled, ineligible, automatically felled, or already-unlocked blocks.
- [ ] `/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)