Files
spigot-leaf/design/user-stories/us-003-identify-protected-players.md
T
dmg e064c7398c
Release / release (push) Successful in 2m11s
CI / build (push) Successful in 57s
fix(identity): remove stale Leaf prefixes
2026-08-10 21:13:02 -04:00

1.8 KiB

type, title, description, status
type title description status
User Story US-003: Identify protected players Mark actively protected players with a visible leaf prefix wherever Spigot supports it. done

US-003: Identify protected players

As a server participant, I want protected players to be visibly identified so that their Leaf status is clear before I interact with them.

Acceptance criteria

  • An actively protected player has a configurable leaf prefix before their name in the player list.
  • An actively protected player has the same prefix before their overhead name where Spigot supports it.
  • An actively protected player has the same prefix in standard Spigot chat where the active chat format supports it.
  • The default prefix uses a leaf symbol with readable spacing and Minecraft-compatible formatting.
  • The prefix is removed immediately when the player opts out or is opted out by PvP or an administrator.
  • Prefixes are suppressed while Leaf is globally disabled and restored for online opted-in players when it is re-enabled.
  • Prefix updates do not overwrite unrelated display-name text where the Spigot API allows the values to coexist.
  • Scoreboard-team and third-party chat-plugin compatibility limitations are documented, and unsupported integrations fail without affecting protection state.
  • Repeated opt-in or reconciliation never produces multiple Leaf prefixes.
  • Opt-out removes every managed Leaf prefix while preserving unrelated name formatting.
  • A stale Leaf prefix left by an earlier plugin instance is normalized instead of duplicated.