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