30 lines
1.6 KiB
Markdown
30 lines
1.6 KiB
Markdown
---
|
|
type: User Story
|
|
title: "US-003: Configure each world's spawn area"
|
|
description: Let administrators define an independent center and circular safe-spawn radius for every world.
|
|
status: done
|
|
---
|
|
|
|
# US-003: Configure each world's spawn area
|
|
|
|
As a **server administrator**, I want to configure the spawn area independently in each world so that `/spawn` sends players to an appropriate safe area in their current world.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Every world has an independent spawn center and maximum spawn distance.
|
|
- [x] Until an administrator sets a custom center, a world uses its native world spawn point.
|
|
- [x] `/spawnadmin set` stores the executing administrator's current world, coordinates, yaw, and pitch as that world's center and facing direction.
|
|
- [x] `/spawnadmin distance <blocks>` sets the current world's maximum spawn distance in blocks.
|
|
- [x] `/spawnadmin info` displays the current world's effective center, whether it is native or custom, and maximum distance.
|
|
- [x] The default maximum spawn distance is 20 blocks.
|
|
- [x] The spawn area is circular, and random horizontal points are sampled uniformly by area within its radius.
|
|
- [x] A maximum distance of `0` targets the configured center and adjusts it to the nearest safe block.
|
|
- [x] Negative, non-numeric, or otherwise invalid distances are rejected with an explanatory message.
|
|
- [x] Random destinations use the center's saved yaw and pitch.
|
|
- [x] Per-world centers and distances survive server and plugin restarts.
|
|
|
|
## Related
|
|
|
|
- [US-002: Teleport safely to spawn](us-002-teleport-safely-to-spawn.md)
|
|
- [US-006: Configure plugin behavior](us-006-configure-plugin-behavior.md)
|