feat(border): add base boundary particles

2026-08-10 22:12:16 -04:00
parent 4278e08bf3
commit 26aeb8c416
18 changed files with 458 additions and 27 deletions
@@ -0,0 +1,31 @@
+---
+type: User Story
+title: "US-013: Visualize the base border"
+description: Let players display a bounded, owner-only particle arc along the current edge of their established base.
+status: done
+---
+
+# US-013: Visualize the base border
+
+As a **player with Base I**, I want to display a particle effect at my base border so that I can understand where base benefits begin and end while building.
+
+## Acceptance criteria
+
+- [x] Border visualization requires Base I and an established base.
+- [x] `/basesettings border enable` enables visualization idempotently, and `/basesettings border disable` disables it idempotently.
+- [x] `border`, `enable`, and `disable` are offered through contextual autocomplete.
+- [x] Border visualization is disabled by default and the preference persists across reconnects and restarts.
+- [x] Older state files without the preference load it as disabled.
+- [x] `/basesettings status` and `/baseadmin status` display the border preference.
+- [x] Particles are visible only to the base owner.
+- [x] Particles trace the current circular horizontal boundary at the player's current Y-level and follow base expansion or relocation immediately.
+- [x] Particles render only while the player is in the base world, within the base's vertical range, and reasonably close to the boundary.
+- [x] Particle generation is bounded to avoid excessive server and client load.
+- [x] A complete administrative reset disables border visualization.
+
+## Related
+
+- [US-001: Unlock and establish Base I](us-001-unlock-and-establish-base.md)
+- [US-003: Expand the base](us-003-expand-the-base.md)
+- [US-009: View progression and unlock notifications](us-009-view-progression-and-notifications.md)
+- [US-010: Administer player progression](us-010-administer-player-progression.md)