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

02. Guia de Configuração de Spawn (TOML) — Wiki Oficial

Posted
Updated
ByRed

Esta página detalha como personalizar o aparecimento dos visitantes no Visiting Villagers através do arquivo de configuração TOML ou pelas telas nativas do jogo.

📂 Arquivo de Configuração e Acesso

As configurações de spawn ficam localizadas em: config/visitingvillagers-common.toml

Formas de Edição

  1. Via Menu do Jogo (Forge): Clique no botão Config na lista de mods para abrir as 5 telas de sliders (1 tela raiz + 4 submenus divididos por categorias).
  2. Edição Direta de Arquivo: Abra o arquivo visitingvillagers-common.toml em qualquer editor de texto.

⚠️ Importante: Alterações no arquivo .toml exigem o reinício do servidor ou do jogo para entrarem em vigor. Diferente dos arquivos JSON de trocas, o sistema de spawn não possui recarga em tempo real.

📋 As 4 Categorias e 10 Chaves de Configuração

Todas as 10 chaves utilizam valores inteiros (integer) com limites definidos de mínimo e máximo (min–max).

1. Configurações Gerais (General Settings)

Define as regras globais para atração de visitantes pela vila.

ChavePadrãoIntervaloDescrição do Efeito
spawnCheckIntervalSeconds101–60Intervalo em segundos entre as verificações de spawn ao redor do jogador.
minVillagersForSpawn61–100Mínimo de aldeões estabelecidos na vila para permitir a chegada de visitantes.
minGolemsForSpawn10–50Mínimo de Golems de Ferro na vila para permitir o aparecimento de visitantes.

2. Visitantes Adultos (Adult Visitors)

Controla o limite de população e a taxa de chegada de comerciantes adultos (VisitorEntity).

ChavePadrãoIntervaloDescrição do Efeito
visitorSpawnPercentage1000–100Porcentagem da população da vila usada para definir o limite máximo de visitantes adultos (ex: 100% = 1 visitante adulto por aldeão).
maxSpawnsPerCycle31–10Quantidade máxima de adultos que podem surgir em uma única verificação.
defaultVisitorTradeChance400–100Chance (%) de o visitante da variante default possuir um catálogo de trocas.

3. Bebês Visitantes (Baby Visitors)

Regula o nascimento e a quantidade de crianças brincalhonas (BabyVisitorEntity).

ChavePadrãoIntervaloDescrição do Efeito
minAdultsForBaby21–10Mínimo de visitantes adultos estabelecidos na vila para que os bebês comecem a surgir.
babySpawnPercentage600–100Porcentagem em relação ao número de adultos que determina o limite máximo de bebês (ex: 60% = até 3 bebês para 5 adultos).

4. Visitantes Andarilhos (Wandering Visitors)

Ajusta a presença de viajantes raros por bioma (WanderingVisitorEntity).

ChavePadrãoIntervaloDescrição do Efeito
maxWanderingVisitors20–10Número máximo de andarilhos presentes simultaneamente no mundo/área.
wanderingSpawnDelaySeconds12010–600Tempo de espera (em segundos) entre as tentativas de spawn de andarilhos.

🧠 Como Funciona o Algoritmo de Spawn

O servidor executa o ciclo de decisão a cada spawnCheckIntervalSeconds na área ao redor do jogador, seguindo três gatilhos em cascata:

  1. Gatilho de Vila Estabelecida: O mod checa se a vila local atinge o mínimo de aldeões (minVillagersForSpawn) e o mínimo de golems (minGolemsForSpawn). Se a vila não atender aos dois requisitos, nenhum visitante é gerado.
  2. Gatilho de Adultos e Bebês:
    • Limite de Adultos: Limite = (Aldeões × visitorSpawnPercentage) / 100. Havendo vaga, o mod gera até maxSpawnsPerCycle adultos por ciclo, próximos a um aldeão.
    • Limite de Bebês: Quando Adultos ≥ minAdultsForBaby, calcula-se Limite = (Adultos × babySpawnPercentage) / 100. Os bebês surgem próximos a um visitante adulto.
  3. Gatilho de Andarilhos: Calculados separadamente (respeitando o limite maxWanderingVisitors). Cada tentativa ocorre após o tempo definido em wanderingSpawnDelaySeconds, e o spawn ocorre obrigatoriamente próximo a um Golem de Ferro.

Regras Fixas de Spawn

  • Período Diurno: Visitantes adultos e bebês aparecem exclusivamente durante o dia (entre 500 e 12000 ticks). Andarilhos surgem um pouco mais tarde no ciclo (a partir do tick 1500).
  • Superfície Válida: O aparecimento só ocorre sobre blocos naturais marcados com a tag #visitingvillagers:visitors_spawnable_on (como blocos de grama).

🩺 Checklist de Diagnóstico (Visitantes Não Aparecem?)

Se os visitantes não estiverem aparecendo na vila, verifique os 5 pontos abaixo antes de alterar as configurações:

  1. Requisitos de População: Verifique se há aldeões e golems suficientes na área próxima ao jogador. O cálculo é local em relação ao jogador, não global no mapa.
  2. Horário do Dia: Certifique-se de que é dia (entre o amanhecer e o meio-dia). Durante a tarde, noite ou tempestades, o aparecimento é bloqueado.
  3. Bloco de Aparição: Garanta que há blocos válidos de grama/terra sem obstrução na vila (tag visitors_spawnable_on).
  4. Reinício do Servidor: Lembre-se de reiniciar o servidor/jogo após editar o arquivo visitingvillagers-common.toml.
  5. Vila Pequena: Com os valores padrão, uma vila com apenas 4 aldeões não atinge o requisito mínimo (4 < 6) e não gerará visitantes.