/spreadplayers Command in Minecraft Bedrock Edition

Teleport Entities to Random Locations

Bedrock EditionPlayers & EntitiesPermission: Game DirectorsCheats: YesJava version →

The /spreadplayers command in Minecraft Bedrock Edition teleports entities to random locations within a chosen area. You can control the center point, how far apart the targets land from each other, and the overall boundary of the drop zone.

Players and server operators use this command to start survival games, scatter friends across a map for a challenge, or place entities randomly without teleporting each one by hand.

Syntax (1 form)

  1. /spreadplayers <x: rotation> <z: rotation> <spreadDistance: float> <maxRange: float> <victim: target> [maxHeight: rotation]

    Spread players

Arguments

ArgumentTypeWhat it means
maxHeightrotationThe maximum height that players can spawn. Default: `0.0`.
maxRangefloatThe furthest distance that players can spawn from each other. Default: `0.0`.
spreadDistancefloatThe distance between players when they spawn. Default: `0.0`.
victimtargetA player name `string` or `target selector` to identify the player.
xrotationThe initial `x` position of the player.
zrotationThe initial `z` position of the player.

Examples

Tips

Common mistakes

Bedrock vs Java

In Minecraft Java Edition, the syntax includes a <respectTeams> argument to keep team members together and uses the word under before <maxHeight>: /spreadplayers <center> <spreadDistance> <maxRange> [under <maxHeight>] <respectTeams> <targets>.

See /spreadplayers in Java Edition →

FAQ

Who has permission to use the /spreadplayers command?

You need the Game Directors permission level and cheats must be enabled in the world to use /spreadplayers.

Can I use /spreadplayers on mobs as well as players?

Yes, the command teleports entities, so you can use a target selector like @e in the victim argument to move non-player entities.

How do I limit how high players can be teleported?

You can add the optional maxHeight argument at the very end of the command to set the maximum height where players can spawn.

Related commands

/aimassist/camera/camerashake/clearspawnpoint/controlscheme/damage/effect/event/gamemode/hud/inputpermission/kill/ride/spawnpoint/summon/teleport