01 – Introdução ao mod Visiting Villagers

Bem-vindo à documentação oficial do Visiting Villagers!

O Visiting Villagers é um mod desenvolvido para Minecraft 1.21.1 (Forge) que transforma as vilas ger veces pelo mundo em comunidades vivas, dinâmicas e repletas de movimento.

Esqueça as vilas estáticas onde os aldeões apenas vagam sem rumo. Com este mod, o mundo ganha vida orgânica através de novos visitantes que chegam para interagir com o jogador e com a própria vila.

Como Funciona a Mecânica do Mod? #

A principal proposta do mod é dar vida às vilas de forma totalmente integrada à progressão do jogo. Aqui estão os pilares de funcionamento:

1. Sistema Orgânico de Spawn #

Os NPCs não aparecem do nada; o mundo monitora o desenvolvimento da sua vila.

• Condições de Crescimento: Para que os visitantes comecem a aparecer, a vila precisa atender a requisitos básicos de população (como um número mínimo de aldeões e Golems de ferro).
• Ciclo de Vida: O mod introduz três novas entidades principais:
  • Visitantes Adultos (VisitorEntity): Chegam às vilas com profissões e skins variadas (são mais de 14 variantes visuais + a padrão). Eles trazem sistemas de trocas exclusivos.
  • Bebês Visitantes (BabyVisitorEntity): Trazem mais imersão ao ambiente, brincando entre si, emitindo sons e trazendo vida para as praças da vila.
  • Andarilhos (WanderingVisitorEntity): Viajantes raros que aparecem por biomas específicos e podem trazer recursos preciosos ou animais (como cavalos e lobos).

2. Comportamento Inteligente de IA #

Os visitantes reagem ao ambiente ao seu redor através de objetivos de inteligência artificial avançados:

• Seguir o Jogador: Eles conseguem seguir o jogador até bancadas de trabalho específicas.
• Sistema de Trocas Dinâmico: Você pode interagir com eles para realizar transações comerciais únicas.
• Rotina Natural: Eles chegam durante o dia e possuem rotinas de limpeza e dispersão baseadas no horário ou quando o jogador vai dormir.

3. Fontes de Troca 100% Customizáveis (JSON) #

Quer alterar o que os visitantes compram ou vendem? O mod utiliza um sistema robusto baseado em arquivos JSON (config/visitingvillagers/trades/):

• Suporta itens fixos, famílias dinâmicas (como madeiras, corantes e fragmentos) e sorteios aleatórios.
• Alterações podem ser aplicadas em tempo de jogo utilizando o comando /visitors reloadtrades direto no chat do servidor, sem precisar reiniciar o jogo!

Por onde começar? #

Explore os guias detalhados da nossa documentação para dominar todas as configurações:

1. ⚙️ Guia de Configuração do Spawn (TOML) — Aprenda a ajustar taxas, tempos, intervalos e regras de aparecimento dos visitantes no servidor.
2. 📄 Guia de Configuração de Trocas (JSON) — Entenda como funciona a estrutura dos arquivos de trocas e como criar novas ofertas personalizadas.
3. 💡 Guia de Exemplos — Veja exemplos práticos prontos para copiar e aplicar nas profissões dos NPCs.