Files
spigot-tyrant/design/user-stories/us-001-start-pause-and-administer.md
T
dmg e5de6b76e7
Release / release (push) Successful in 2m27s
CI / build (push) Successful in 1m4s
feat(admin): add Tyrant point grant command
2026-09-04 22:12:47 -04:00

31 lines
1.9 KiB
Markdown

---
type: User Story
title: "US-001: Start, pause, and administer the game"
description: Give server operators safe control over the Tyrant game's lifecycle and state.
status: done
---
# US-001: Start, pause, and administer the game
As a **server operator**, I want to start, pause, resume, and inspect the game so that it can coexist safely with maintenance and other server events.
## Acceptance criteria
- [x] An administrator can start the first game by assigning the initial Tyrant.
- [x] The administrator may assign the first Vigilante or leave the role vacant for the configured Vigilante arena challenge.
- [x] An administrator can pause and resume the game without deleting game state.
- [x] Pausing freezes progression, cooldowns, daily-use timers, inactivity checks, and pending-selection deadlines.
- [x] Role and class effects are suppressed while paused and restored when play resumes.
- [x] Administrative commands require the `spigottyrant.admin` permission, granted to server operators by default.
- [x] Administrators can inspect lifecycle state, roles, classes, Followers, purchases, levels, cooldowns, participation, legacy pending selections, and the configured shared role arena location.
- [x] `/tyrantadmin grantpoint` requires administrative permission and grants the current Tyrant exactly one level and one unspent unlock choice.
- [x] A successful administrative point grant persists immediately and confirms the updated level and choice count to the administrator.
- [x] If the game is not running or has no current Tyrant, an administrative point grant changes nothing and reports a clear error.
- [x] Destructive administrative operations require explicit confirmation.
## Related
- [Tyrant game state machine](../concepts/game-state-machine.md)
- [Configure and persist game state](us-012-configure-and-persist-state.md)
- [Claim the Vigilante role in the arena](us-019-claim-vigilante-in-arena.md)