Files
spigot-base/design/user-stories/us-014-highlight-spawnable-blocks.md
dmg 259ea9410c
Release / release (push) Successful in 2m16s
CI / build (push) Successful in 1m3s
feat(spawning): add spawnable block overlay
2026-08-10 22:46:02 -04:00

2.3 KiB

type, title, description, status
type title description status
User Story US-014: Highlight spawnable blocks Unlock an owner-only red particle overlay for nearby hostile-mob spawnable blocks after 250 placements anywhere. done

US-014: Highlight spawnable blocks

As a player with an established base, I want to highlight nearby blocks where hostile mobs can spawn so that I can find lighting gaps in my base.

Acceptance criteria

  • Every block placed in Survival mode anywhere contributes to a persistent total-placement counter.
  • The overlay unlocks permanently at a configurable 250 total placements by default.
  • Existing players begin with at least their persisted in-base placement count because those placements are known to qualify.
  • /basesettings spawnable enable enables the unlocked overlay idempotently, and /basesettings spawnable disable disables it idempotently.
  • spawnable, enable, and disable are offered through contextual autocomplete.
  • Enabling requires both the placement unlock and an established base; the persisted preference defaults to disabled.
  • /basesettings status and /baseadmin status display placement progress, unlock state, and preference.
  • Administrators can change a player's total-placement counter through /baseadmin setprogress.
  • Administrators can persistently change the required placement threshold through /baseadmin config spawnable-overlay-unlock-placements.
  • Administrators can enable or disable an unlocked player's overlay through /baseadmin setsetting <player> spawnable <enable|disable>.
  • Owner-only red particles mark nearby candidate hostile-mob spawning surfaces inside the current base bounds.
  • Candidate surfaces have block light zero, a solid spawning surface, and two passable blocks above them.
  • Scanning is bounded to 16 horizontal blocks, eight vertical blocks, and a fixed per-update work and particle budget.
  • A complete administrative reset clears total-placement progress and disables the overlay.