---
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)