00 – Visiting Villagers — Wiki Oficial

Skip to main content
How can we help?
Table of Contents
< All Topics
Print
Posted
Updated
ByRed

Bem-vindo à documentação oficial do Visiting Villagers! Este mod para Minecraft 1.21.1 (Forge) transforma vilas estáticas em assentamentos vivos e dinâmicos, introduzindo visitantes temporários com profissões e variantes visuais, crianças brincalhonas e viajantes raros de biomas.

Visão Geral

O Visiting Villagers expande a experiência das vilas do Minecraft através de um sistema orgânico de população. Quando uma vila atinge os critérios mínimos de desenvolvimento e segurança, novos visitantes começam a chegar durante o dia para interagir com os moradores, utilizar bancadas de trabalho e realizar trocas exclusivas.

Principais Funcionalidades

  • 3 Categorias de Visitantes: Adultos com profissões (VisitorEntity), bebês (BabyVisitorEntity) e andarilhos raros (WanderingVisitorEntity).
  • IA Inteligente de Vila: Movimentação orientada por pontos de interesse, rotina diurna e dispersão automática ao anoitecer.
  • Sistema de Trocas em JSON: Catálogos independentes de compra e venda por variante, com suporte a famílias dinâmicas de itens (family), listas aleatórias (one_of) e Data Components.
  • Configuração de Spawn em TOML: Controle preciso sobre limites de população, intervalos de verificação e condições da vila.
  • Recarga em Tempo Real: Aplique alterações nos arquivos de trocas instantaneamente via comando /visitors reloadtrades, sem precisar reiniciar o jogo ou servidor.

Índice da Wiki

Acesse os guias detalhados através dos links abaixo:

01. Mecânicas e Entidades
  • Tipos de entidades, variantes visuais e comportamentos de IA.
  • Ciclo de vida dos visitantes e regras de dispersão noturna.
02. Guia de Configuração de Spawn (TOML)
  • Requisitos mínimos da vila (número de moradores e golems de ferro).
  • Detalhamento do arquivo config/visitingvillagers-common.toml.
  • Checklist de diagnóstico para solucionar problemas de spawn.
03. Guia de Configuração de Trocas (JSON)
  • Estrutura da pasta config/visitingvillagers/trades/.
  • Sintaxe de itens fixos, famílias dinâmicas (family) e seleções aleatórias.
  • Configuração de encantamentos, poções e Data Components.
04. Compatibilidade e Comandos
  • Requisitos de ambiente (Minecraft 1.21.1, Forge 52.1.0, Java 21).
  • Tabela de comandos de administração (/visitors check, /visitors population, etc.).
  • Sistema de validação e fallback contra erros de sintaxe.

Início Rápido

  • Para Jogadores: Instale o mod no cliente ou servidor. Desenvolva uma vila até que ela possua no mínimo 6 aldeões e 1 golem de ferro. Os visitantes começarão a surgir durante o período diurno.
  • Para Criadores de Modpacks: Navegue até a pasta config/visitingvillagers/ para ajustar as taxas de spawn no arquivo TOML ou personalizar os catálogos de trocas de cada profissão nos arquivos JSON.