Files
spigot-tree-feller/design/user-stories/us-006-announce-tree-unlocks.md
T

1.6 KiB

type, title, description, status
type title description status
User Story US-006: Announce tree unlocks Celebrate each newly earned species and explain how to control or undo automatic felling. in-progress

US-006: Announce tree unlocks

As a player, I want visible and actionable feedback when I unlock a species so that I notice the achievement and understand Tree Feller's safety controls.

Acceptance criteria

  • Earning a species unlock displays a configurable on-screen title and subtitle naming the species.
  • Earning a species unlock also sends a configurable chat message that explains that sneaking prevents automatic felling and names /treefeller undo.
  • Title text, subtitle text, fade-in time, display time, fade-out time, and chat text are configurable.
  • Messages support the project's chosen Spigot formatting convention and a documented species placeholder.
  • The boss bar for the newly unlocked species is removed when its unlock announcement is shown.
  • An earned species produces its unlock announcement exactly once unless an administrator later resets that species and the player earns it again.
  • An administrative grant clearly informs an online target that access was granted but does not falsely present it as a mined-block achievement.
  • Invalid or cancelled breaks never generate an unlock announcement.