feat(notification): announce earned tree unlocks

This commit is contained in:
dmg
2026-08-11 17:33:54 -04:00
parent 8c7c008ca0
commit 2664f7c68b
6 changed files with 142 additions and 9 deletions
+7
View File
@@ -2,6 +2,13 @@
## 2026-08-11
### US-006 unlock announcement checkpoint
- Added configurable, placeholder-aware titles, subtitles, timing, and chat guidance for newly earned species.
- Progress presentation now removes the completed boss bar before showing the one-time achievement and guidance about sneaking and undo.
- Verified earned and ordinary progress paths plus the complete build with `./gradlew clean check jar`.
- US-006 remains in progress until US-007 verifies distinct online messaging for administrative grants.
### US-005 safe undo completed
- Added one runtime-only latest-felling record per player with original world, coordinates, material, block-data string, and completion time.
@@ -2,7 +2,7 @@
type: User Story
title: "US-006: Announce tree unlocks"
description: Celebrate each newly earned species and explain how to control or undo automatic felling.
status: backlog
status: in-progress
---
# US-006: Announce tree unlocks
@@ -11,14 +11,14 @@ As a **player**, I want visible and actionable feedback when I unlock a species
## 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.
- [x] Earning a species unlock displays a configurable on-screen title and subtitle naming the species.
- [x] Earning a species unlock also sends a configurable chat message that explains that sneaking prevents automatic felling and names `/treefeller undo`.
- [x] Title text, subtitle text, fade-in time, display time, fade-out time, and chat text are configurable.
- [x] Messages support the project's chosen Spigot formatting convention and a documented species placeholder.
- [x] The boss bar for the newly unlocked species is removed when its unlock announcement is shown.
- [x] 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.
- [x] Invalid or cancelled breaks never generate an unlock announcement.
## Related