Editing MinecraftCommands (section)

=== spreadplayers ===

{{/infobox
|spreadplayers
|op
|1.6.1|13w23a
}}

Teleports entities (players, mobs, items, etc.) to random surface locations within an area.

;Syntax

: <code>spreadplayers <''x''> <''z''> <''spreadDistance''> <''maxRange''> <''respectTeams''> <''player …''></code>

;Arguments

: ''x z''
:: Specifies the center of the region to spread targets to. ''x'' and ''z'' must be between [[World boundary|-30,000,000 and 30,000,000]] (exclusive). May use [[#Tilde notation|tilde notation]] to specify coordinates relative to the command's execution.

: ''spreadDistance''
:: Specifies the minimum distance between targets. Must be at least 0.0.

: ''maxRange''
:: 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 at least 1.0 greater than ''spreadDistance''.

: ''respectTeams''
:: Specifies whether to keep teams together. Must be <code>true</code> or <code>false</code>. If <code>true</code>, targets on the same team will be teleported to the same location.

: ''player''
:: Specifies the targets to spread. Must be one or more player names and/or [[#Target selectors|target selectors]] separated by spaces (<code>@e</code> is permitted to target entities other than players).

;Result

: Fails if the arguments are not specified correctly, if there are too many targets to satisfy the ''spreadDistance'' requirement within the specified area, or if a target is attempted to be spread to outside the [[world boundary]].

: On success, teleports targets to random surface locations within the specified area. Targets will always be placed on the top block at a location, and never on [[lava]].

;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:
:: <code>spreadplayers 0 0 200 500 true @a</code>

: 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:
:: <code>spreadplayers 0 0 50 100 false @r[team=Red] @r[team=Blue] @r[team=Green] Alice Bob</code>

;See also

: {{cmd|tp}} and {{cmd|teleport}} — different commands that teleport a single player or entity to a specific position (even underground).


<!-- please retain double newline above for section differentiation -->