Files
spigot-leaf/design/user-stories/us-001-opt-into-leaf-protection.md
T

1.5 KiB

type, title, description, status
type title description status
User Story US-001: Opt into Leaf protection Let players voluntarily receive and relinquish a persistent Resistance boost. done

US-001: Opt into Leaf protection

As a player, I want to opt into Leaf protection so that I can receive a modest defensive boost while playing on a hard server.

Acceptance criteria

  • Players with the leaf.use permission, granted by default, can use /leaf on, /leaf off, and /leaf status.
  • /leaf on records the player's opt-in choice and grants Resistance I while Leaf is globally enabled.
  • Resistance remains continuously effective without distracting expiry or renewal messages or particles.
  • /leaf off records the player's opt-out choice and immediately removes only the Resistance effect managed by Leaf.
  • /leaf status clearly distinguishes the player's saved choice, active protection, administrative lock, and global Leaf state.
  • Repeating an already-satisfied on or off command is safe and explains that no change was needed.
  • Opt-in choices are keyed by UUID and survive logout and server restart.
  • A player who joins while opted in regains protection when Leaf is enabled.
  • Player-command autocomplete suggests only valid next arguments available to the sender.