# The /spreadplayers command in Minecraft: spread players across the map

> How to use /spreadplayers in Minecraft Java: scatter everyone at random for a UHC or Manhunt, by team, in the Nether, and what to do if they don't fit.

Original page: https://napnodes.com/en/guides/minecraft-spreadplayers-command · Updated: 2026-11-08

/spreadplayers takes a group of players and drops them at random points in an area of the map, spaced apart and always on solid ground. It's how almost every UHC, Manhunt and team survival game starts, and it's also the simplest /rtp there is without plugins. Here's what each number does, in the form today's Java version uses.

## How it's written

The form is `/spreadplayers <x> <z> <spread> <range> <teams> <targets>`, and no part is optional: if one is missing, the game won't accept it.

You need to be an operator (level 2) or have cheats on in a single-player world. On a server, you op yourself from the console with `op YourName` ([the guide to giving op](https://napnodes.com/en/guides/op-player-minecraft-server)).

Despite the name, it isn't just for players: it spreads anything a selector picks, including mobs (`@e[type=minecraft:cow]`) or armor stands you use as markers.

1. **x and z: the centre**: The point it spreads around. No height: just x and z. `0 0` is the centre of the world and `~ ~` is where you are (or the command block).
2. **The spread**: The minimum number of blocks between two players. With `0` they can land right next to each other; with `300`, nobody starts less than 300 blocks from anyone else.
3. **The range**: How far from the centre anyone can land, in each direction. With `1000`, the area is a 2000 × 2000 block square with the centre in the middle (it's a square, not a circle). It has to be 1 or more.
4. **Teams: true or false**: With `true`, players on the same team land together in the same spot and the spread counts between teams. With `false`, everyone goes their own way.
5. **Targets**: A name, `@a` for everyone online or any selector: `@a[team=red]`, `@a[gamemode=survival]`… They're all in [the selectors guide](https://napnodes.com/en/guides/minecraft-target-selectors).

## The ones used most

1. **Starting a UHC or a free-for-all**: `/spreadplayers 0 0 300 1000 false @a` drops everyone at least 300 blocks from each other and within 1000 of the centre. For the rest of the UHC (border, regeneration, teams), [the UHC guide](https://napnodes.com/en/guides/minecraft-uhc-server).
2. **By team**: `/spreadplayers 0 0 500 1500 true @a` keeps each team together and 500 blocks from the next. First, put everyone on a team with /team: [the teams guide](https://napnodes.com/en/guides/minecraft-team-command).
3. **Sending the runner away in a Manhunt**: `/spreadplayers ~ ~ 0 200 false Ana` sends Ana to a random point within 200 blocks of where you are, so the hunters can't see her at the start ([the Manhunt guide](https://napnodes.com/en/guides/minecraft-manhunt-server)).
4. **A random teleport**: `/spreadplayers 0 0 0 3000 false Ana` sends Ana anywhere within 3000 blocks of the centre. To let each player use it with just a button and a cooldown, [the random teleport guide](https://napnodes.com/en/guides/minecraft-random-teleport-rtp).
5. **Scattering mobs**: `/spreadplayers ~ ~ 5 40 false @e[type=minecraft:sheep,distance=..30]` spreads the sheep near you over 40 blocks around. Handy for a map or a farm you don't want crammed together.

## Where they land and where they don't

Each one lands on top of the highest block at their point, so nobody ends up buried or falls from the sky. What can happen is that someone ends up on top of a tree.

If their point is water, lava or fire, the game looks for another one. That's why it never leaves anyone in the middle of the ocean, and why it can fail on a map that's almost all water.

When it's done, the game answers with something like «Spread 12 entity/entities around 0, 0 with an average distance of 640 block(s) apart». That average distance tells you whether the game ended up too close together or too spread out.

## In the Nether: with under

In the Nether, «the highest block» is the bedrock ceiling, and that's where it puts people unless you stop it. That's what `under` is for, with the maximum height it can leave anyone at, just before the teams part: `/spreadplayers 0 0 50 500 under 120 false @a`.

From the console, or if you're in the overworld, also tell it the dimension with execute: `execute in minecraft:the_nether run spreadplayers 0 0 50 500 under 120 false @a`. That takes them to the Nether even if they're somewhere else ([the /execute guide](https://napnodes.com/en/guides/minecraft-execute-command)).

In the Nether, 120 works well: it's below the ceiling and well above the lava sea. If you give a height below the bottom of the world, it fails with «Invalid maxHeight '-80'; expected higher than world minimum -64» (or the bottom of that dimension).

## If it says they don't fit

The most common error is «Could not spread 20 entity/entities around 0, 0 (too many entities for space - try using spread of at most …)». It happens when you ask for a very big spread in a small area: 20 players 500 blocks apart don't fit in a range of 600 blocks.

You have two ways out: raise the range or lower the spread. The number at the end of the message is the biggest spread that fits with that range: use that or a smaller one.

With teams set to `true`, the message talks about teams instead of entities, and the count is per team. Watch out: players with no team can all end up in the same spot, as if they were one more team. Before using `true`, put everyone on one.

## Keeping it lag-free

If the points land on ground nobody has walked on, the server has to generate those chunks right then, and with 20 players at once and thousands of blocks of range you'll notice it: a few seconds of stutter right at the start.

For an event, generate the area beforehand with Chunky: the [pre-generation guide](https://napnodes.com/en/guides/pregenerate-minecraft-world-chunky) explains how and the [Chunky calculator](https://napnodes.com/en/tools/minecraft-chunky-pregen-calculator) tells you how long it takes and how much disk it uses for the range you'll use.

And set the world border a little beyond the range, so nobody lands outside the play area ([the world border guide](https://napnodes.com/en/guides/minecraft-server-world-border)).

## On NapNodes

Minecraft servers run Paper on the latest version, so everything in this guide applies. From the panel's «Console» you run /spreadplayers without the slash and without being logged in.

If you're going to spread a lot of people across a big map, check the memory you have left in «Home» first: generating world all at once is one of the things that asks most of the server.

## Questions

### How do I spread all players at random in Minecraft?

With /spreadplayers 0 0 300 1000 false @a: it drops them at least 300 blocks from each other and within 1000 of the centre of the world.

### What does each number in /spreadplayers mean?

The first two are the centre (x and z), the third is the minimum spread between players, the fourth is how far from the centre they can land, and then true or false to keep teams together and who gets spread.

### Why does /spreadplayers say there are too many entities?

Because they don't fit with that spread in that area. Raise the range or lower the spread; the number at the end of the message is the biggest spread that fits.

### How do I use /spreadplayers in the Nether?

With under and a height below the ceiling: execute in minecraft:the_nether run spreadplayers 0 0 50 500 under 120 false @a.

### Can /spreadplayers drop someone in water?

No. If the point is water, lava or fire, the game looks for another one, and it always leaves each player on top of the highest block.

### How do I keep each team together with /spreadplayers?

Put true in the teams part: each team lands together and the spread counts between teams. Put everyone on a team with /team first.

---

NapNodes gives you a free Minecraft server, no card and no end date: it isn't always on (it switches itself off after an hour with nobody on, and you start it again with one click). How it works: https://napnodes.com/en/free. Paid plans, always on and with no commitment: https://napnodes.com/en/pricing.
