Teleporta entidades para locais de superfície aleatórios dentro de uma área.
Sintaxe[]
- Edição Java
spreadplayers <center> <spreadDistance> <maxRange> <respectTeams> <targets>
spreadplayers <center> <spreadDistance> <maxRange> under <maxHeight> <respectTeams> <targets>
- Espalha os jogadores para a posição resultante abaixo da altura máxima.
- Edição Bedrock
spreadplayers <x: value> <z: value> <spreadDistance: float> <maxRange: float> <victim: target>
Argumentos[]
EJ: <center>
: vec2
EB: x: value
: RelativeFloat e z: value
: RelativeFloat
- Especifica o centro da região para onde os destinos serão distribuídos.
- Deve ser uma coordenada bidimensional com elementos de número de ponto flutuante. Aceita notação de til e circunflexo.
EJ: <spreadDistance>
: float
EB: spreadDistance: float
: float
- Especifica a distância mínima entre os alvos.
- Deve ser um no número de formato de ponto flutuante de precisão única. E deve ser pelo menos 0,0.
EJ: <maxRange>
: float
EB: maxRange: float
: float
- Especifica a distância máxima em cada eixo horizontal do centro da área para espalhar os alvos (portanto, a área é quadrada, não circular).
- Deve ser um no número de formato de ponto flutuante de precisão única. Na Edição Java, it must be greater than or equal to 1.0. Na Edição Bedrock, deve ser pelo menos 1,0 maior que
<spreadDistance>
.
- Especifica a altura máxima para posições resultantes.
- Deve ser um no número de formato de ponto flutuante de precisão única. And it must be greater than or equal to 1.0.
- Especifica se as equipes devem ser mantidas juntas. Se
true
, alvos da mesma equipe são teletransportados para o mesmo local. - Deve ser um booleano (ou
true
oufalse
).
EJ: <targets>
: entity
EB: victim: target
: CommandSelector<Actor>
- Especifica os destinos a serem distribuídos.
- Deve ser um nome de jogador, seletores de destino ou o UUID[Edição Java apenas].
Resultado[]
Comando | Gatilho | Edição Java | Edição Bedrock |
---|---|---|---|
qualquer | os argumentos não estão especificados corretamente | não analisável | falha |
<targets> ou player: target falha ao resolver para uma ou mais entidades (os jogadores nomeados devem estar online) | falha | ||
há muitos destinos para atender ao requisito <spreadDistance> dentro da área especificada | |||
/spreadplayers ... under ... | não há espaço suficiente em <maxHeight> para se espalhar para | N/A | |
qualquer | sucesso | Teleporta alvos para locais de superfície aleatórios dentro da área especificada. |
Saída[]
Comando | Edição | Situação | Contagem de sucesso | /execute store succeess ... | /execute store result ... |
---|---|---|---|---|---|
qualquer | Edição Java | Em caso de falha | 0 | 0 | 0 |
/spreadplayers ... true ... | Em caso de sucesso | 1 | 1 | o número de equipes em que esses alvos estão | |
/spreadplayers ... false ... | Em caso de sucesso | 1 | 1 | o número de entidades segmentadas | |
qualquer | Edição Bedrock | Em caso de falha | 0 | N/A | N/A |
Em caso de sucesso | 1 | N/A | N/A |
Nota[]
Os alvos são sempre colocados no bloco superior não aéreo (seja sólido ou não) em um local (se não estiver no modo sob
) e nunca em lava, água, Coluna de bolhas, ou fogo.
O comando /spreadplayers
não tem uma distribuição uniforme sobre a superfície. Tem uma distribuição Gaussiana, pois as posições mais próximas da posição definida no comando têm maior chance de ter uma entidade nelas. Este efeito é muito sutil e não é visível para raios curtos, mas pode ser um problema se você quiser uma geração aleatória uniforme. Este problema não ocorre para o seletor e dispensadores @r.
Exemplos[]
- Para teletransportar todos os jogadores por equipe para locais aleatórios de superfície em uma área de 1.000 × 1.000 blocos centralizada em (0,0), com uma distância mínima entre as equipes de 200 blocos:
spreadplayers 0 0 200 500 true @a
[Edição Java apenas]
- Para teletransportar um jogador aleatório de cada uma das três equipes (Vermelho, Azul e Verde), bem como Alice e Bob, para locais aleatórios de superfície em uma área de 200×200 blocos centralizada em (0,0), com um mínimo distância entre jogadores de 50 blocos: **
spreadplayers 0 0 50 100 false @r[team=Red] @r[team=Blue] @r[team=Green] Alice Bob
[Edição Java apenas]
Veja também[]
/tp
e/teleport
— comandos diferentes que teletransportam um único jogador ou entidade para uma posição específica (mesmo no subsolo).
História[]
Edição Java | |||||
---|---|---|---|---|---|
1.6.1 | 13w23a | Adicionado /spreadplayers . | |||
1.16 | 20w21a | Adicionado um argumento opcional maxHeight para especificar a altura máxima. | |||
Edição Pocket | |||||
1.0.5 | alpha 1.0.5.0 | Adicionado /spreadplayers . |