---
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)