命令
/spreadplayers
将实体传送到围绕某个中心点散布的随机地表位置。
语法
| /spreadplayers <center> <spreadDistance> <maxRange> <respectTeams> <targets> |
| /spreadplayers <center> <spreadDistance> <maxRange> under <maxHeight> <respectTeams> <targets> |
参数
| 参数 | 值的类型 | 输入内容 |
|---|---|---|
| <center> | 平面位置 | 该区域中心的X和Z坐标。 |
| <spreadDistance> | 小数 | 各位置之间的最小距离，以方块为单位。0或更多。至少为0。 |
| <maxRange> | 小数 | 位置可以离中心多远，沿X和Z以方块为单位。1或更多。至少为1。 |
| <respectTeams> | 真或假 | true会让队伍成员待在同一位置，false会把每个实体单独分散。 |
| <targets> | 目标选择器 | 要分散的实体。任意实体，不只是玩家。一个或多个实体。 |
| <maxHeight> | 整数 | 实体可以落脚的最高Y坐标。整数，不低于世界底部。 |
详细信息
| 权限等级 | 2：管理员、开启作弊的世界、命令方块和函数 |
| 适用于 | 开启作弊的单人游戏、多人游戏服务器、命令方块和函数。需要权限等级2（游戏管理员）：管理员、开启作弊的世界中的玩家、命令方块和函数。 |
| 结果 | 提示“已将N个实体分散在X, Z周围，平均间距为D格”，对队伍则提示相同内容。/execute store 保存的数字是所用位置的数量：实体的数量，或在队伍保持在一起时队伍的数量。 |
| 范围 | 位置在以中心为圆心的正方形内选取，该正方形沿X和Z方向各延伸maxRange格方块。 |
| 分散距离 | spreadDistance是两个位置之间允许的最小距离。0允许任意间距。 |
| 实体落在哪里 | 每个实体会被放置在上方有两格空气的最高方块上，位于该方块的中心。该方块必须是固体，且不能是液体。 |
| under | under <maxHeight>限制落点的最大高度，在屋顶下或下界中很有用。寻找落脚方块的搜索从该高度开始。低于世界底部的值会失败，并提示“无效的maxHeight...；应高于世界最小值...”。 不带 under 时，使用世界的完整高度。 |
| respectTeams | 为 true 时，同一队伍的所有玩家都会被传送到同一位置。没有队伍的玩家和非玩家实体共用同一个位置。为 false 时，每个实体都有各自的位置。 |
| 失败 | 游戏最多尝试10,000次来寻找位置。如果区域对于间距来说太小，会失败并提示“无法分散……”。（实体过多，空间不足，请尝试使用最大为...的分散范围）”。 |
示例
/spreadplayers 0 0 10 50 false @a将所有玩家分散到距0，0不超过50格的范围内，彼此至少相距10格。
/spreadplayers ~ ~ 5 20 true @a将各队伍分散到你所在位置周围20格以内，每支队伍一起落地。
/spreadplayers 100 -200 0 30 false @e[type=minecraft:cow]将所有牛随机分散到X 100、Z -200周围30个方块的范围内。
/spreadplayers 0 0 20 100 under 120 false @a将所有玩家分散到距0，0不超过100格的、Y低于120的地面上，例如下界顶部之下。
/spreadplayers ~ ~ 3 15 under 64 true @a将队伍分散到你所在位置周围15格以内，仅限Y低于64的地面。
/spreadplayers ~ ~ 2 10 false @e[type=minecraft:sheep,distance=..30]将绵羊分散到你周围30个方块内、范围为10个方块的区域。
