Files
spigot-harvest/design/user-stories/us-005-view-crop-progress-and-notifications.md
T

2.1 KiB

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

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.