Comandos/clear

De Minecraft Wiki
Ir para: navegação, pesquisa
clear
Restrições

Operador

Introduzido pela primeira vez

Edição Java 1.4.2 (12w37a )
PE 1.0.5 (Edição Pocket alpha 1.0.5.0 )

Limpa itens do inventário de jogadores.

Sintaxe[editar | editar código-fonte]

  • Edição Java
clear [<alvos>] [<item>] [<contMax>]
  • Edição Bedrock
clear [player: alvo] [itemName: Item] [data: int] [maxCount: int]

Argumentos[editar | editar código-fonte]

<alvos> (EB: player: alvo)

Deve ser um nome de jogador ou um seletor de alvo. Se não especificado, o padrão é o jogador que executou o comando. Não é opcional nos blocos de comando.

<item> (EB: itemName: Item)

Especifica o id do item a ser limpo. Se não especificado, todos os itens no inventário do jogador são limpos.

data: int[Edição Bedrock apenas]

Especifica o valor de dado do item a ser limpo. Se não especificado, ou se -1, todos os itens que correspondem ao item são limpos, independentemente de seus dados.

<contMax> (EB: maxCount: int)

Especifica o número máximo de itens a serem limpos. Se não especificado, ou se é -1, todos os itens que correspondem ao item e data são limpos. Se 0, não limpa itens, mas retorna com êxito se houver itens que poderiam ter sido limpos (permitindo a detecção de itens em vez de limpar os itens).

Resultado[editar | editar código-fonte]

Falha se os argumentos não forem especificados corretamente, se <targets> falha na resolução de um ou mais players on-line ou se nenhum item for removido (exceto quando <maxCount> é 0)

Em caso de sucesso, remove os itens especificados do(s) jogador(es). Se contMax for 0, nenhum item será removido e o número de itens correspondentes será exibido no bate-papo.

As saídas específicas são as seguintes:

Gatilho Tipo Mensagem
O item não existe Falha Item desconhecido <id do item>
/clear <seletor> <id do item><--[AQUI]
A marcação do item não existe Falha Unknown item tag <tag id>

O jogador tem um inventário vazio
O jogador não possui os itens especificados

Falha

Um jogador: Nenhum item foi encontrado no player <nome do jogador>
Vários jogadores: Nenhum item foi encontrado em <número> jogadores[verificar]

O seletor segmenta entidades que não são jogadores Falha Somente jogadores podem ser afetados por este comando, mas o seletor fornecido inclui entidades
Nenhum jogador é afetado, dado o seletor Falha Nenhum jogador foi encontrado
Os itens são removidos do inventário Sucesso

Um jogador: Removido <número> itens do jogador <nome do jogador>
Vários jogadores: Removido <number> itens do <número> jogadores[verificar]

O maxCount está definido como 0 e o jogador tem os itens especificados em seu inventário Sucesso

Um jogador: Encontrado <número> itens correspondentes no jogador <nome do jogador>
Vários jogadores: Encontrado <número> itens correspondentes em <número> jogadores[verificar]

Exemplos[editar | editar código-fonte]

  • Para limpar todo o seu inventário: clear
  • Para limpar todos os itens do inventário de Alice: clear Alice
  • Para limpar todos os itens de lã do inventário de Alice: clear Alice minecraft:wool
  • Para limpar todos os itens de lã laranja do inventário de todos os jogadores: clear @a minecraft:wool 1[Edição Bedrock apenas] ou clear @a minecraft:orange_wool[Edição Java apenas]
  • Para limpar todas as espadas de ouro com o encantamento "Afiação I" do jogador mais próximo
    • clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}[Edição Java apenas]
  • Para testar se um jogador aleatório tem pedra em seu inventário: clear @r minecraft:stone -1 0[Edição Bedrock apenas] ou clear @r minecraft:stone 0[Edição Java apenas]

Veja também[editar | editar código-fonte]

/data — pode alterar ou remover itens nos inventários de blocos ou de entidades
/give — dá itens ao jogador
/kill — pode destruir entidades de itens
/replaceitem — pode substituir itens nos inventários de blocos ou de entidades

Histórico[editar | editar código-fonte]

Esta seção é um esboço, o que significa que falta algumas informações importantes. Você pode ajudar por expandindo com mais informações relacionadas ao tópico.
Edição Java
1.3.1 12w37a Adicionado /clear
12w38a Adicionado o argumento item ao /clear.
1.8 14w02a Adicionado o argumento data ao /clear.
Edição Pocket
1.0.5 alpha 1.0.5.0 Adicionado /clear