feat(base): implement progression system

2026-08-09 15:01:44 -04:00
commit c87d923cad
76 changed files with 5092 additions and 0 deletions
@@ -0,0 +1,26 @@
+---
+type: User Story
+title: "US-002: Unlock Base II navigation"
+description: Let players earn toggleable particle guidance toward their established base.
+status: in-progress
+---
+
+# 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
+
+- [ ] Base II requires Base I and an established base.
+- [ ] Base II unlocks at a configurable cumulative grass-or-dirt threshold that defaults to 500 blocks, 250 more than Base I.
+- [ ] Base II provides particle-based navigation and does not grant or require a physical compass item.
+- [ ] While enabled and in the base's world, particles are drawn along the ground to indicate the direction toward the base.
+- [ ] Particle generation is bounded to avoid excessive server or client load.
+- [ ] A player in another world receives a clear message instead of a misleading particle direction.
+- [ ] `/basenavigation` toggles guidance on and off after Base II is unlocked.
+- [ ] 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)