---
title: 02 – Guia de Configuração do Spawn (TOML)
description: "Além das trocas (JSON), o mod é ajustável no arquivo `config/visitingvillagers-common.toml`, em **4 categorias**. A forma mais fácil é pelo botão **Config** na lista de mods (telas de sliders nativas do Forge); editar o `.toml` direto também funciona. > As…"
url: "https://redstonegames.com.br/docs/guia-de-configuracao-do-spawn-toml/"
updated: "2026-11-04"
category: Mods Java / Visiting Villagers Mod
---

# 02 – Guia de Configuração do Spawn (TOML)

Além das trocas (JSON), o mod é ajustável no arquivo `config/visitingvillagers-common.toml`, em **4 categorias**. A forma mais fácil é pelo botão **Config** na lista de mods (telas de sliders nativas do Forge); editar o `.toml` direto também funciona.

> As 10 chaves são inteiros com `mín–máx`. O arquivo é gerado na primeira inicialização; valores estão nos comentários do próprio `.toml`.

---

## 1. General Settings

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#1-general-settings](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#1-general-settings)

| Chave | Padrão | Faixa | Efeito |
| --- | --- | --- | --- |
| `spawnCheckIntervalSeconds` | 10 | 1–60 | Intervalo, em segundos, entre as verificações de spawn |
| `minVillagersForSpawn` | 6 | 1–100 | Aldeões mínimos na vila para começar a spawnar visitantes |
| `minGolemsForSpawn` | 1 | 0–50 | Golems de ferro mínimos na vila para começar a spawnar |

## 2. Adult Visitors

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#2-adult-visitors](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#2-adult-visitors)

| Chave | Padrão | Faixa | Efeito |
| --- | --- | --- | --- |
| `visitorSpawnPercentage` | 100 | 0–100 | % de aldeões que podem ser visitantes |
| `maxSpawnsPerCycle` | 3 | 1–10 | Máximo de visitantes adultos por ciclo de verificação |
| `defaultVisitorTradeChance` | 40 | 0–100 | Chance (%), por visitante `default`, de ter trocas |

## 3. Baby Visitors

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#3-baby-visitors](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#3-baby-visitors)

| Chave | Padrão | Faixa | Efeito |
| --- | --- | --- | --- |
| `minAdultsForBaby` | 2 | 1–10 | Visitantes adultos mínimos para começar a spawnar bebês |
| `babySpawnPercentage` | 60 | 0–100 | % de adultos que podem ser bebês |

## 4. Wandering Visitors

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#4-wandering-visitors](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#4-wandering-visitors)

| Chave | Padrão | Faixa | Efeito |
| --- | --- | --- | --- |
| `maxWanderingVisitors` | 2 | 0–10 | Andarilhos simultâneos permitidos |
| `wanderingSpawnDelaySeconds` | 120 | 10–600 | Atraso, em segundos, entre spawns individuais de andarilhos |

---

## Regras fixas (não configuráveis)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#regras-fixas-n%C3%A3o-configur%C3%A1veis](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Spawn.md#regras-fixas-n%C3%A3o-configur%C3%A1veis)

- Spawn **apenas de dia** (visitantes ao amanhecer, andarilhos um pouco mais tarde) e sobre blocos com a tag `visitingvillagers:visitors_spawnable_on`.
- Bebês **não trocam** — brincam entre si.
- Visitantes nascidos já vêm com um pool de trocas; o `default` só têm trocas se passar no sorteio de `defaultVisitorTradeChance`.
