Comandos/testforblock

Não confundir com Comandos/testforblocks.

testforblock
Nível de permissão exigido	2‌[EJ apenas] 1‌[EB apenas]
Restrições	Apenas Comandos

Testa se um determinado bloco está em um local específico.

Sintaxe

testforblock <position: x y z> <tileName: Block> [blockStates: block states]

testforblock <position: x y z> <tileName: Block> [dataValue: int]

Argumentos

position: x y z: CommandPosition

Especifica as coordenadas do bloco a testar.

It Deve ser uma coordenada tridimensional composta de <x>, <y> e <z>, cada um dos quais deve ser um número de ponto flutuante ou notação de til e circunflexo.

tileName: Block: enum

Especifica o bloco a ser testado.

Deve ser um id de bloco.

blockStates: block states: BlockStateCommandParam

Especifica os estados do bloco para corresponder quando testfor.

Deve ser um argumento estado de bloco como["<state1>":<value1>,"<state2>":<value2>,...]. Por exemplo: ["old_leaf_type":"birch","persistent_bit":true].

dataValue: int: int

Especifica os dados do bloco para corresponder quando testfor. Os valores (bit a bit E 0xFFFF) que são inválidos para o ID de bloco especificado revertem para 0. Se for negativo, todos os blocos que correspondem a tileName: Block são testados.

Deve ser um número inteiro de 32 bits.

Resultado

Comando	Gatilho	Edição Bedrock
qualquer	os argumentos não estão especificados corretamente	não analisável
	a posição especificada está descarregada ou fora do mundo	Falha
	o bloco na posição especificada não corresponde ao ID ou estados do bloco especificados
qualquer	Com sucesso	Retorna a mensagem de sucesso.

Saída

Comando	Edição	Situação	Contagem de sucesso
qualquer	Edição Bedrock	On fail	0
		On success	1

Exemplos

• Para testar se o bloco em (0,64,0) é algum tipo de lã:
  • testforblock 0 64 0 wool
  • testforblock 0 64 0 wool -1
• Para testar se o bloco em (0,64,0) é de lã laranja:
  • testforblock 0 64 0 wool 1
• Para testar se o bloco abaixo é um toca-discos:
  • testforblock ~ ~-1 ~ jukebox -1

Histórico

Edição Java
1.7.2		13w37a			Adicionado /testforblock.
1.11		16w32a			Adicionado suporte de estados de bloco para /testforblock.
1.13		17w45a			Removido /testforblock em favor de /execute if.
Edição Pocket Alpha
v0.16.0		build 1			Adicionado /testforblock.
Edição Bedrock
1.18.0		beta 1.18.0.20			Adicionado suporte para estados de bloco.

Comandos

Ver em: Template:Comandos/content [editar]