---
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: 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

- [x] Leaf records the first observed join time for each player by UUID as an RFC 3339 UTC timestamp.
- [x] On every login before the first-join timestamp plus seven calendar days, the player receives a concise welcome message explaining Leaf protection.
- [x] The welcome message tells the player to use `/leaf on`, `/leaf off`, and `/leaf status`.
- [x] The message makes clear that attacking another player automatically opts the attacker out.
- [x] Players no longer receive the welcome message once their seven-day onboarding period expires.
- [x] Existing first-join timestamps are not reset by logout, restart, opt-in changes, or global disablement.
- [x] No onboarding reminders are shown while Leaf is globally disabled.
- [x] 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)