---
type: User Story
title: "US-005: View crop progress and notifications"
description: Give players command and boss-bar feedback about each crop's current progression.
status: done
---

# US-005: View crop progress and notifications

As a **player**, I want to inspect crop progression and see recent progress updates so that I understand my current benefits and next unlock.

## Acceptance criteria

- [x] `/harvest` and `/harvest status` display a concise summary of all supported crop paths and the player's current boss-bar preference.
- [x] `/harvest status <crop>` displays that crop's earned level, current level-local progress, next requirement, and current and next operation caps.
- [x] Level X status clearly reports that the crop path is complete.
- [x] `/harvest bossbar enable` enables progress boss bars idempotently, and `/harvest bossbar disable` disables them idempotently.
- [x] Boss bars are enabled by default.
- [x] Disabling boss bars does not affect progression, unlock notifications, or command-based status display.
- [x] Crop names and boss-bar modes are offered through autocomplete, and invalid or extra arguments show friendly usage guidance.
- [x] Every qualifying manual or automated harvest updates a crop-specific progress boss bar for the initiating player when boss bars are enabled.
- [x] Boss-bar text identifies the crop and accurately displays current level-local progress and its requirement.
- [x] Boss-bar fill never falls below zero or exceeds 100 percent.
- [x] The boss bar remains visible for a configurable duration after the latest progress update, defaulting to five seconds.
- [x] A new qualifying update resets the boss bar's disappearance timer.
- [x] Unlocking a crop level displays a prominent one-time notification identifying the crop, new level, and new operation cap.
- [x] Unlock notifications do not repeat after reconnecting or restarting.

## Related

- [US-001: Track crop harvesting progression](us-001-track-crop-harvesting-progression.md)
- [US-002: Unlock crop auto-harvest levels](us-002-unlock-crop-auto-harvest-levels.md)
- [US-006: Administer player harvest progression](us-006-administer-player-harvest-progression.md)