Files
spigot-base/design/user-stories/us-001-unlock-and-establish-base.md
T
dmg 00aa7566ad
Release / release (push) Successful in 2m21s
CI / build (push) Successful in 53s
feat(commands): add base command aliases
2026-08-10 19:58:09 -04:00

34 lines
1.9 KiB
Markdown

---
type: User Story
title: "US-001: Unlock and establish Base I"
description: Let players earn and establish a persistent personal base by breaking dirt and grass blocks.
status: done
---
# US-001: Unlock and establish Base I
As a **player**, I want to earn and set a personal base so that later quality-of-life progression has a location associated with it.
## Acceptance criteria
- [x] Only blocks broken while the player is in Survival mode contribute progression.
- [x] Breaking `GRASS_BLOCK` or `DIRT` contributes one unit of Base I progress.
- [x] Other dirt-like materials, including coarse dirt, rooted dirt, podzol, mycelium, and dirt paths, do not contribute by default.
- [x] Player-placed blocks may contribute when broken; natural-generation detection is not required.
- [x] Base I unlocks when the player reaches the configured threshold, which defaults to 250 qualifying blocks.
- [x] `/setbase` is unavailable before Base I and explains the unmet requirement.
- [x] `/sethome` is an alias for `/setbase` with identical behavior.
- [x] After Base I unlocks, `/setbase` records the player's current world and block location as the center of a cylindrical base.
- [x] The initial cylinder has a configurable 10-block horizontal radius and extends a configurable 25 blocks above and 25 blocks below the set Y coordinate.
- [x] The first successful `/setbase` is immediately available.
- [x] A successful relocation starts a configurable elapsed-time cooldown that defaults to 24 hours.
- [x] Failed attempts do not start or extend the relocation cooldown.
- [x] Progress and base state are associated with the player's UUID and survive restarts.
## Related
- [US-002: Unlock Base II navigation](us-002-unlock-base-navigation.md)
- [US-003: Expand the base](us-003-expand-the-base.md)
- [US-004: Unlock and control base flight](us-004-unlock-and-control-base-flight.md)
- [US-005: Unlock Base III teleportation](us-005-unlock-base-teleportation.md)