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

1.4 KiB

type, title, description, status
type title description status
User Story US-004: Introduce new players to Leaf Remind players how to control Leaf during their first seven calendar days on the server. done

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.