spigot-base/design/user-stories/us-001-unlock-and-establish-base.md

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