feat(pocket-base): add mob spawning toggle

2026-08-24 09:57:48 -04:00
parent 11e3ad1720
commit 23e8fcec6e
13 changed files with 376 additions and 17 deletions
@@ -0,0 +1,28 @@
+---
+type: User Story
+title: "US-018: Control Pocket Base mob spawning"
+description: Let Pocket Base owners control natural mob spawning in their private world, with spawning disabled by default.
+status: done
+---
+
+# US-018: Control Pocket Base mob spawning
+
+As a **Pocket Base owner**, I want to enable or disable natural mob spawning in my Pocket Base so that I can choose whether the private world supports normal mob activity.
+
+## Acceptance criteria
+
+- [x] Natural mob spawning is disabled by default in every new Pocket Base and in existing Pocket Bases that have no saved preference.
+- [x] A Pocket Base owner can use `/basesettings pocket mobs enable|disable` to control natural mob spawning in their own Pocket Base.
+- [x] The setting controls both hostile and passive natural spawning only in the owner's Pocket Base.
+- [x] The command is unavailable until Pocket Base I is unlocked.
+- [x] The command and its modes are offered through contextual autocomplete.
+- [x] `/basesettings status` displays the current Pocket Base mob-spawning setting.
+- [x] The preference persists across restarts and is reapplied when the Pocket Base world loads.
+- [x] Disabling natural spawning does not remove existing mobs or prevent explicitly spawned or summoned mobs.
+- [x] Persistence or world-application failures produce a clear failure message without reporting a successful change.
+
+## Related
+
+- [US-015: Unlock a Pocket Base](us-015-unlock-a-pocket-base.md)
+- [US-016: Build and use Pocket Base portals](us-016-build-and-use-pocket-base-portals.md)
+- [US-017: Expand a Pocket Base](us-017-expand-a-pocket-base.md)