Command/spreadplayers

spreadplayers Teleports entities to random surface locations within an area.

Syntax

 * Java Edition


 * Spreads players to resulting position under the maximum height.
 * Spreads players to resulting position under the maximum height.
 * Spreads players to resulting position under the maximum height.


 * Bedrock Edition



Arguments
JE: : vec2

BE: : RelativeFloat and  : RelativeFloat


 * Specifies the center of the region to spread targets to.
 * Must be a two-dimensional coordinates with floating-point number elements. Accepts tilde and caret notations.

JE: : float

BE: : float


 * Specifies the minimum distance between targets.
 * Must be a   Single-precision floating-point format number. And it must be at least 0.0.

JE: : float

BE: : float


 * Specifies the maximum distance on each horizontal axis from the center of the area to spread targets (thus, the area is square, not circular).
 * Must be a   Single-precision floating-point format number. In Java Edition, it must be greater than or equal to 1.0. In Bedrock Edition, it must be at least 1.0 greater than.

JE: : integer


 * Specifies the maximum height for resulting positions.
 * Must be a   Single-precision floating-point format number. And it must be greater than or equal to 1.0.

JE: : bool


 * Specifies whether to keep teams together. If, targets on the same team are teleported to the same location.
 * Must be a   boolean (either   or  ).

JE: : entity

BE: : CommandSelector


 * Specifies the targets to spread.
 * Must be a player name, a target selector or a UUID‌[Java Edition only].

Note
Targets are always placed on the top non-air block (whether it's solid or not) at a location (if not in  mode), and never on lava, water, bubble column, or fire.

The  command does not have a uniform distribution over the surface. It has a Gaussian distribution as the positions closer to the position set in the command have a higher chance of having an entity on them. This effect is very subtle and is not visible for short radius but can be a problem if you want a uniform random generation. This problem does not occur for the @r selector and dispensers.

Examples

 * To teleport all players by team to random surface locations in a 1,000×1,000-block area centered on (0,0), with a minimum distance between teams of 200 blocks:
 * ‌[Java Edition only]
 * To teleport one random player from each of three teams (Red, Blue, and Green), as well as Alice and Bob, to random surface locations in a 200×200-block area centered on (0,0), with a minimum distance between players of 50 blocks:
 * ‌[Java Edition only]

History
This section needs expansion.

You can help by expanding it.