Files
spigot-leaf/design/user-stories/us-004-introduce-new-players-to-leaf.md
T

28 lines
1.4 KiB
Markdown

---
type: User Story
title: "US-004: Introduce new players to Leaf"
description: Remind players how to control Leaf during their first seven calendar days on the server.
status: backlog
---
# US-004: Introduce new players to Leaf
As a **new player**, I want a brief explanation of Leaf when I join so that I know protection is available and understand how to control it.
## Acceptance criteria
- [ ] Leaf records the first observed join time for each player by UUID as an RFC 3339 UTC timestamp.
- [ ] On every login before the first-join timestamp plus seven calendar days, the player receives a concise welcome message explaining Leaf protection.
- [ ] The welcome message tells the player to use `/leaf on`, `/leaf off`, and `/leaf status`.
- [ ] The message makes clear that attacking another player automatically opts the attacker out.
- [ ] Players no longer receive the welcome message once their seven-day onboarding period expires.
- [ ] Existing first-join timestamps are not reset by logout, restart, opt-in changes, or global disablement.
- [ ] No onboarding reminders are shown while Leaf is globally disabled.
- [ ] Re-enabling Leaf allows reminders to resume on subsequent logins only for players whose original seven-day period has not expired.
## Related
- [US-001: Opt into Leaf protection](us-001-opt-into-leaf-protection.md)
- [US-005: Administer Leaf](us-005-administer-leaf.md)
- [US-006: Configure and persist Leaf](us-006-configure-and-persist-leaf.md)