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