← Minecraft guides

Minecraft · updated 8 November 2026

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

/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.

Different case? Ask with this guide inChatGPTClaude

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

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.

Rather not set it up yourself? Minecraft servers from €6 a month, no contract and a full refund within 72 hours. Or create a free Minecraft server, no card needed.

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.

  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.

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

  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.

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

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 explains how and the Chunky 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).

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.

Frequently asked 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.

Shall we set it up for you?

Minecraft servers from €6 a month, never oversold: your RAM is yours alone. And if you'd rather start without paying, there's a free Minecraft server, no card needed.

Your server doesn't show up in the game? Check it in a second with “Is my Minecraft server online?”: players, version and MOTD, free. Need a player's UUID for the whitelist or permissions? Look it up here. Handing out enchanted items? Build the command with the /give generator.

Keep reading

All Minecraft guides, sorted →