Files
spigot-trigger-spawn/design/user-stories/us-005-manage-spawn-bans.md
T
dmg edab7f03db
Release / release (push) Failing after 11s
CI / build (push) Successful in 57s
feat(access): manage spawn bans
2026-08-08 13:23:29 -04:00

28 lines
1.4 KiB
Markdown

---
type: User Story
title: "US-005: Ban and unban spawn access"
description: Let administrators prevent selected players from using or reacquiring spawn teleportation until unbanned.
status: done
---
# US-005: Ban and unban spawn access
As a **server administrator**, I want to ban and unban players from spawn teleportation so that access can be withheld regardless of progression or grants.
## Acceptance criteria
- [x] `/spawnadmin ban <player>` immediately prevents the player from using `/spawn`.
- [x] Banning a player clears their administrative grant, enemy progress, and active cooldown.
- [x] Qualifying kills made while banned are not recorded.
- [x] A banned player cannot receive an administrative grant until unbanned.
- [x] `/spawnadmin bans [page]` displays a paginated list of banned players, including offline players.
- [x] `/spawnadmin unban <player>` removes the ban without restoring any prior grant, enemy progress, or cooldown.
- [x] An unbanned player begins with no access and can earn access again by defeating a qualifying enemy or receiving a new grant.
- [x] Ban and unban commands support online players and previously known offline players when they can be resolved safely.
- [x] Ban state is associated with player UUIDs and survives server and plugin restarts.
## Related
- [US-001: Earn progressive spawn access](us-001-earn-progressive-spawn-access.md)
- [US-004: Grant and remove spawn access](us-004-manage-spawn-access.md)