01. Mecânicas e Entidades — Wiki Oficial

Esta página detalha as entidades introduzidas pelo Visiting Villagers, suas variantes visuais, comportamentos de IA, o ciclo de vida orgânico dentro das vilas do Minecraft e as ferramentas de inspeção de população [1, 2].

O mod substitui a população estática por três tipos de entidades com papéis e dinâmicas bem definidos [2]:

• Papel: Visitantes profissionais que chegam às vilas para realizar trocas com o jogador [2].
• Variantes Visuais: Possuem 14 variantes temáticas + a variante padrão (default) [2]. Lista completa (nomes no jogo): Miner (miner), Beekeeper (beekeeper), Lumberjack (lumberjack), Good Pillager (good_pillager), Glassworker (glassworker), Railwright (railwright), Piglin Trader (piglin_trader), Beachcomber (beachcomber), Mycologist (mycologist), Redstone Engineer (redstone_engineer), Pyrotechnic (pyrotechnic), Relic Scavenger (relic_scavenger), EnchantSmith (enchant_smith) e Hunter (hunter).

ℹ️ O nome entre parênteses é a chave usada nos arquivos JSON de trocas e nos IDs de textura. A variante EnchantSmith usa a chave enchant_smith (sem o “s” separador).

• Catálogo de Trocas: Cada variante possui seu próprio arquivo JSON de ofertas. Mesmo dois NPCs da mesma variante recebem ofertas embaralhadas aleatoriamente a cada visita [2].
• Interação Comercial: Possuem ofertas de compra e venda configuráveis e podem seguir o jogador até bancadas de trabalho [2, 3].

• Papel: Adicionam imersão e vida comunitária às praças e vilas [2].
• Nascimento Orgânico: Só começam a aparecer quando a vila atinge um número mínimo de visitantes adultos estabelecidos [2].
• Comportamento: Brincam entre si, emitem sons ambientes característicos e correm pelas vilas [1, 2].
• Restrição Comercial: Não realizam trocas em nenhuma hipótese [2, 4].

• Papel: Viajantes raros que aparecem conforme o bioma em que a vila está localizada [2].
• Variantes de Bioma (8 no total): Plains Wanderer (wandering_plains), Forest Wanderer (wandering_forest), Cave Wanderer (wandering_cave), Mountain Wanderer (wandering_mountain), Snow Wanderer (wandering_snow), Swamp Wanderer (wandering_swamp), Desert Wanderer (wandering_desert) e o raro Master Wanderer (wandering_master) [2].
• Recursos e Animais: Trazem recursos temáticos de seus biomas de origem e podem surgir acompanhados de animais (como cavalos, lobos e jumentos) [1, 2].

Os visitantes utilizam um conjunto de 9 rotinas de Inteligência Artificial personalizadas para interagir com o ambiente e o jogador [1, 3]:

O mod adiciona 5 itens utilizáveis, todos concentrados em uma aba criativa própria, além de um item interno usado apenas como ícone da aba [1]. Nenhum deles é fabricável em mesa de trabalho — estão disponíveis no modo criativo e para administradores via /give [1].

Observação: existe um sexto item registrado internamente, o tab_icon (Visiting Villagers Icon), que não aparece na aba criativa nem é obtível em jogo — ele existe apenas para servir de ícone da aba do mod [1].

O mod cria sua própria aba no menu criativo, chamada “Visiting Villagers”, com ícone exclusivo [1]:

• Itens na aba (nesta ordem): ovo de spawn de visitante → ovo de spawn de bebê → ovo de spawn de andarilho → visitor_checker_chat → visitor_checker [1].
• Uso dos ovos de spawn: funcionam como os ovos do vanilla — clique-direito em um bloco válido (de preferência os da tag #visitingvillagers:visitors_spawnable_on) para invocar a entidade imediatamente [1].
• Uso das ferramentas: clique-direito com o item na mão para obter o diagnóstico da vila onde você está [1]:
  • Visitor Checker (Chat): imprime o relatório no chat instantaneamente, sem alterar o item.
  • Visitor Checker (Book): o item da mão é substituído por um livro escrito (“Visitor Check Report”, com brilho de encantamento) contendo o relatório completo, que pode ser lido como qualquer livro do vanilla. O item original não é devolvido — use o livro ou pegue outro checker na aba criativa.

A aba é útil para administradores e criadores de mapas que desejam posicionar visitantes manualmente sem depender do spawn orgânico configurado nas configurações de spawn [1].

• Chegada dos Visitantes: O aparecimento de visitantes adultos e bebês ocorre exclusivamente durante o período diurno (entre 500 e 12000 ticks) [4, 5].
• Chegada dos Andarilhos: Os andarilhos chegam um pouco mais tarde no ciclo diurno (a partir do tick 1500) [5].
• Blocos de Aparecimento: Todos os visitantes aparecem em blocos válidos marcados com a tag #visitingvillagers:visitors_spawnable_on (como grama e blocos naturais similares) [1, 4].

• Retirada Orgânica: Ao entardecer e durante a noite, os visitantes encerram suas atividades e iniciam o processo de dispersão e remoção natural [3].
• Limpeza ao Dormir: Se o jogador dormir para passar a noite, a rotina de limpeza é acionada instantaneamente, renovando a vila para o próximo ciclo diurno [3].