Minecraft:Commands/spreadplayers

File:Spreadplayer command example.jpg

Example of the /spreadplayers command used on zombies. The /spreadplayers command spreads the entities in a square. This example uses 10 as the radius.

Teleports entities to random surface locations within an area. Despite its name, this command can be used to teleport any entities, not just players.

Usage

in Template:Editions, targets are always placed on the highest non-Minecraft:air block at a horizontal position. If in under mode, targets are always placed on the highest non-Minecraft:air block that is under the specified maximum height and with two air blocks above it. The horizontal coordinates are invalid if there's no such non-Minecraft:air block.

in Template:Editions, targets are always placed one block above the highest solid block at a horizonal position. If with maxHeight: value argument, targets are always placed one block above the highest solid block that is under the specified maximum height. The horizontal coordinates are invalid if there's no such solid block, or if the solid block does not have two air blocks above it.

Targets are never placed on Minecraft:lava, Minecraft:water, bubble column, or Minecraft:fire. Positions above these blocks are invalid. in Template:Editions, magma block, wither rose, Minecraft:campfire, soul campfire, sweet berry bush, nether portal, end portal, and end gateway are also invalid positions.

in Template:Editions, the entities are spread into the command's execution dimension.

in Template:Editions, the command changes an entity's position without changing dimension. But the valid position is calculated in the command's execution dimension.

If there are no valid position, or the targets are too many to satisfy the minimum distance (<spreadDistance> or spreadDistance: float) requirement within valid positions, no entities are spread.

Syntax

• Java Edition

spreadplayers <center> <spreadDistance> <maxRange> <respectTeams> <targets>

Spreads players to positions on the top non-air block.

spreadplayers <center> <spreadDistance> <maxRange> under <maxHeight> <respectTeams> <targets>

Spreads players to positions under the maximum height, on the highest non-Minecraft:air block with two air blocks above it.

• Bedrock Edition

spreadplayers <x: value> <z: value> <spreadDistance: float> <maxRange: float> <victim: target> [maxHeight: value]

Arguments

1. REDIRECT Template:Edition

Template:Rcat: <center>: vec2

1. REDIRECT Template:Edition

Template:Rcat: x: value: RelativeFloat and z: value: RelativeFloat

Specifies the center of the region to spread targets to.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|vec2}}{{#vardefine:be-arg|relativefloat}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Template:El: <spreadDistance>: float
Template:El: spreadDistance: float: float

Specifies the minimum distance between each two targets.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|float}}{{#vardefine:be-arg|float}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}} And it should be at least 0.0.

Template:El: <maxRange>: float
Template:El: maxRange: float: 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).

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|float}}{{#vardefine:be-arg|float}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}} in Template:Editions, it should be at least 1.0 greater than spreadDistance: float.

1. REDIRECT Template:Edition

Template:Rcat: <maxHeight>: integer

1. REDIRECT Template:Edition

Template:Rcat：maxHeight: value: RelativeFloat

Specifies the maximum height for the target positions.

in Template:Editions, {{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|integer}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

in Template:Editions, {{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|relativefloat}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

1. REDIRECT Template:Edition

Template:Rcat: <respectTeams>: bool

Specifies whether to keep entities on the same team together. If true, targets on the same team are teleported to the same position.

{{#vardefine:onlyje|}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|bool}}{{#vardefine:be-arg|}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Template:El: <targets>: entity
Template:El: victim: target: CommandSelector<Actor>

Specifies the targets to spread.

{{#vardefine:onlyje|Template:IN,}}{{#vardefine:onlybe| Template:IN,}}{{#vardefine:je-arg|entity}}{{#vardefine:be-arg|entity}}Template:Error{{#vardefine:onlyje|}}{{#vardefine:onlybe|}}{{#vardefine:je-arg|}}{{#vardefine:be-arg|}}

Output

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

{{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|0}}{{#vardefine:output3-{{#var:output-table-lines}}|0}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|je}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|the number of teams that these targets are in}}{{#vardefine:commands-num|}}{{#vardefine:command-{{#var:commands-num}}|/spreadplayers ... true ...}}{{#vardefine:command-row-{{#var:commands-num}}|1}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|1}}{{#vardefine:output3-{{#var:output-table-lines}}|the number of targeted entities}}{{#vardefine:commands-num|}}{{#vardefine:command-{{#var:commands-num}}|/spreadplayers ... false ...}}{{#vardefine:command-row-{{#var:commands-num}}|1}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On fail}}{{#vardefine:output1-{{#var:output-table-lines}}|0}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:commands-num|}}{{#vardefine:command-{{#var:commands-num}}|Any}}{{#vardefine:command-row-{{#var:commands-num}}|1}}{{#vardefine:output-editions-num|}}{{#vardefine:output-edition-{{#var:output-editions-num}}|be}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|1}} {{#vardefine:output-table-lines|}}{{#vardefine:situation-{{#var:output-table-lines}}|On success}}{{#vardefine:output1-{{#var:output-table-lines}}|1}}{{#vardefine:output2-{{#var:output-table-lines}}|N/A}}{{#vardefine:output3-{{#var:output-table-lines}}|N/A}}{{#vardefine:command-row-{{#var:commands-num}}|}}{{#vardefine:output-edition-row-{{#var:output-editions-num}}|}}

{{#vardefine:output-table-lines|}}{{#vardefine:output-table-lines|-2}}{{#vardefine:output-table-lines-now|}}{{#vardefine:command-num-now|}}{{#vardefine:command-line-now|}}{{#vardefine:commands-num|}}{{#vardefine:output-edition-num-now|}}{{#vardefine:output-edition-line-now|}}{{#vardefine:output-editions-num|}}{{#vardefine:je-outputs-dis|}}

Examples

• in Template:Editions, 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:
  • spreadplayers 0 0 200 500 true @aTemplate:Only
• in Template:Editions, 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:
  • spreadplayers 0 0 50 100 false @r[team=Red] @r[team=Blue] @r[team=Green] Alice BobTemplate:Only

History

See also

1. REDIRECT Template:Command

Template:Redr and

1. REDIRECT Template:Command

Template:Redr — different commands that teleport a single player or entity to a specific position (even underground).

References

<references/>

External links

• Template:Cite

Navigation

All editions	clear clone damage deop difficulty effect enchant execute fill function gamemode gamerule give help kick kill list locate loot me msg op particle place playsound recipe reload ride say schedule scoreboard setblock setworldspawn spawnpoint spreadplayers stopsound summon tag teleport tell tellraw time title tp transfer w weather xp Removed placefeature
Template:El only	advancement attribute ban ban-ip banlist bossbar data datapack debug defaultgamemode dialog experience fetchprofile fillbiome forceload item jfr pardon pardon-ip publish random return save-all save-off save-on seed setidletimeout spectate stopwatch swing team teammsg tm test tick trigger version waypoint worldborder Debug chase debugconfig debugmobspawning debugpath raid serverpack spawn_armor_trims warden_spawn_tracker Removed ? achievement banip blockdata broadcast chunk entitydata home iron locatebiome replaceitem setspawn solid stats testfor testforblock testforblocks toggledownfall unban wood
Template:Els only	stop whitelist
Template:El only	aimassist allowlist changesetting clearrealmevents controlscheme dedicatedwsserver gametips packstack project reloadconfig reloadpacketlimitconfig save sendshowstoreoffer set_movement_authority Removed aigoals automate automateactivetool automatebreakblock automatefindblock automatefly automategetinteractionpositionforblock automatelookat automatemove automatemoveto automateplaceblock bhave bossbar bounds cleanroom clearslot clearinventory crash crashclient crashserver createlocalworld destroyblock detect dumpblocknames dumpentitiesclient dumpentitiesserver enchantrandom fillchestblock filldrive findanchoredbuildpos findflatarea findnearbypickups fixbiomes fly getactivescreen getavgendframerate getavgremaindertimepercent getavgrendertime getavgticktime getavgunaccountedtimepercent getblockname getbrightness getchestcontents getchunkdirtycount getchunkrebuildcount getchunksortcount getcpu getdurability getexperience getfps getgpu getgpumemory getguiscale getmsaalevel getos getplayerbiome getplayerid getpos getpower getprofilersecondsperupdate getresolution getselecteditemcount getskin getstructure getsysteminfo getsystemmem getviewdistance getworldname health hunger islargechestblock isplayercrouching isplayerflying isplayergrounded isworldloaded kit leaveworld loadbehaviortreedefinitions log lookat memwarn mixer nearbyentityisbaby networkstats notifyprofiler paths pause placefromhand playerstat profile redstonetest register3pserver resupply rot selectinventoryitem sendmodalform setbrightness setguiscale setskin setviewdistance showallitems showfrustum simlock simscale simulationtype skin spawnfeature spawning spawnitem spawnmob stoptime systemstat testassets timelock tptobiome tptosuitabletree villages volumearea wipeout
Template:El only	classroommode closechat code codebuilder lesson remove videostream Removed position videostreamaction
Template:Els only	? ability agent alwaysday camera camerashake clearspawnpoint codebuilder_actorinfo connect daylock dialogue drop enableencryption event fog getlocalplayername gettopsolidblock hud immutableworld inputpermission listd mobevent music ops permission playanimation querytarget replaceitem script scriptevent setmaxplayers structure takepicture testfor testforblock testforblocks tickingarea titleraw toggledownfall wb worldbuilder wsserver Removed clearfixedinv executeasself move place setfixedinvslot setfixedinvslots test transferserver
Joke	debugdim transform vote warp
Related	Argument types Permission level Slot Target selectors

de:Befehl/spreadplayers ja:コマンド/spreadplayers pt:Comandos/spreadplayers ru:Команды консоли/spreadplayers uk:Команди консолі/spreadplayers zh:命令/spreadplayers