Files
spigot-base/design/user-stories/us-002-unlock-base-navigation.md
T
dmg 84e013ac11
Release / release (push) Successful in 1m59s
CI / build (push) Successful in 48s
fix(navigation): preserve disabled preference
2026-08-09 15:38:40 -04:00

30 lines
1.6 KiB
Markdown

---
type: User Story
title: "US-002: Unlock Base II navigation"
description: Let players earn toggleable particle guidance toward their established base.
status: done
---
# US-002: Unlock Base II navigation
As a **player with Base I**, I want visual guidance toward my base so that I can find it without relying on coordinates.
## Acceptance criteria
- [x] Base II requires Base I and an established base.
- [x] Base II unlocks at a configurable cumulative grass-or-dirt threshold that defaults to 500 blocks, 250 more than Base I.
- [x] Base II provides particle-based navigation and does not grant or require a physical compass item.
- [x] While enabled and in the base's world, particles are drawn along the ground to indicate the direction toward the base.
- [x] Particle generation is bounded to avoid excessive server or client load.
- [x] A player in another world receives a clear message instead of a misleading particle direction.
- [x] `/basenavigation` toggles guidance on and off after Base II is unlocked.
- [x] `/basenavigation on` enables guidance idempotently and `/basenavigation off` disables it idempotently.
- [x] Invalid navigation arguments show command usage, and `on` and `off` are offered through autocomplete.
- [x] Grass-or-dirt progress after Base II preserves the player's selected navigation preference.
- [x] The navigation preference persists across reconnects and restarts.
## Related
- [US-001: Unlock and establish Base I](us-001-unlock-and-establish-base.md)
- [US-009: View progression and unlock notifications](us-009-view-progression-and-notifications.md)