---
title: 01 – Introdução ao mod Visiting Villagers
description: "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…"
url: "https://redstonegames.com.br/docs/visiting-villagers/"
updated: "2026-11-04"
category: Mods Java / Visiting Villagers Mod
---

# 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)](https://redstonegames.com.br/knowledge-base/guia-de-configuracao-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)](https://redstonegames.com.br/knowledge-base/guia-de-configuracao-de-trocas-json/) — Entenda como funciona a estrutura dos arquivos de trocas e como criar novas ofertas personalizadas.
3. 💡 [Guia de Exemplos](https://redstonegames.com.br/knowledge-base/guia-de-exemplos/) — Veja exemplos práticos prontos para copiar e aplicar nas profissões dos NPCs.