Folha de referências do seletor de alvo Minecraft
8 min de leitura
Os seletores são pequenos, mas decidem quem recebe o comando. Um bom seletor é estreito o suficiente para ser seguro e simples o suficiente para depurar. Use esta referência quando um comando funciona na Output, mas atinge o alvo errado no jogo.
Resultado
Uma lista de verificação de seletor prática que ajuda a evitar que os comandos tenham como alvo nada ou muito.
Caminho recomendado
- Escolha primeiro o seletor de base: jogador mais próximo, todos os jogadores, todas as entidades ou o executor de comando.
- Adicione um filtro por vez, começando com tipo, tag, distância ou equipe.
- Use pontuações somente depois que o objetivo existir e tiver valores conhecidos.
- Adicione ordenação e limite quando mais de um destino é possível.
- Teste o seletor com um comando inofensivo antes de usar dano, morte, teletransporte ou alterações de inventário.
Decisão do seletor base
Use o menor seletor de base que corresponda ao trabalho. Se um comando afetar um jogador, comece com o jogador mais próximo ou com o executor de comando em vez de todos os jogadores. Se afetar entidades, decida se os participantes devem ser incluídos antes de usar um seletor amplo de entidades.
Seletores amplos são úteis para configuração e limpeza, mas devem ser combinados com filtros de tipo, tag, equipe ou distância.
- Use @s para o executor de comando ao executar como uma entidade conhecida.
- Use @p para interações do jogador mais próximo.
- Use @a para mensagens ou configurações para todo o jogador.
- Use @e somente quando a filtragem de entidade estiver limpa.
Filtros que evitam acidentes
Tags costumam ser a maneira mais limpa de conectar fluxos de trabalho com vários comandos. Adicione uma tag quando a entidade for criada e, em seguida, direcione essa tag posteriormente. Isso é mais fácil de manter do que repetir um filtro NBT longo em cada comando subsequente.
Os filtros de distância e limite protegem comandos executados a partir de blocos de comando ou funções. Um filtro de distância ausente pode afetar entidades fora da área de encontro.
Falhas no seletor de depuração
Quando um seletor parar de corresponder, remova os filtros até que ele corresponda novamente. Adicione novamente os filtros em ordem e verifique qual deles quebra o comando. As pontuações e os filtros NBT são pontos de falha comuns porque dependem de um estado que pode ainda não existir.
NBTForge pode ajudar a construir o comando circundante, mas o estado do seletor no jogo ainda depende do seu mundo, objetivos do scoreboard, tags e posições da entidade.
Envie o artefato copiado
Use este guia para produzir o artefato que um jogador ou criador de mapas irá realmente executar: um comando copiado, um pacote Project ordenado ou um recurso de datapack. A revisão final deve acontecer na Output copiada, não apenas no estado editável do construtor.
Quando o fluxo de trabalho for sensível à versão, rotule a versão de destino ao lado do comando. Ao usar seletores, placares, bossbars, tags, tabelas de saque ou ordem de Project, teste essas dependências em um mundo limpo antes de publicar a configuração.
- Copie de Output para um comando e de Project para pacotes solicitados.
- Mantenha Java, Bedrock e variantes de snapshot separadas.
- Teste primeiro seletores destrutivos com Output inofensiva.
- Atualize as presets relacionadas quando o guia se tornar o fluxo de trabalho canônico.
Guias e presets relacionados
FAQ
Qual é o seletor mais seguro para teste?
Use @s ou uma tag aplicada a uma entidade de teste conhecida. Evite seletores amplos, como todas as entidades, ao testar comandos destrutivos.
Por que um seletor corresponde em um lugar, mas não em outro?
Distância, posição, executor, dimensão, estado do scoreboard e tags podem mudar entre blocos de comando, funções e comandos de chat.
Quando este guia deve se tornar um pacote Project?
Use Project quando o fluxo de trabalho precisar de mais de um comando, tiver ordem de configuração e limpeza ou precisar ser editado novamente após o teste. Comandos únicos podem permanecer em Output.