---
title: 04 – Guia de Exemplos
description: "Trocas reais tiradas dos arquivos do mod (todos os valores já testados em jogo). Referência das opções: **[Configurando-Trocas.md](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md)**. --- ## 1. Família de madeira (compra) [https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#1-fam%C3%ADlia-de-madeira-compra](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#1-fam%C3%ADlia-de-madeira-compra) O lenhador compra **uma** tora sorteada de qualquer madeira — uma entrada cobre as…"
url: "https://redstonegames.com.br/docs/04-guia-de-exemplos/"
updated: "2026-11-04"
category: Mods Java / Visiting Villagers Mod
---

# 04 – Guia de Exemplos

Trocas reais tiradas dos arquivos do mod (todos os valores já testados em jogo). Referência das opções: **[Configurando-Trocas.md](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md)**.

---

## 1. Família de madeira (compra)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#1-fam%C3%ADlia-de-madeira-compra](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#1-fam%C3%ADlia-de-madeira-compra)

O lenhador compra **uma** tora sorteada de qualquer madeira — uma entrada cobre as 8 madeiras com `<madeira>_log` (bamboo/crimson/warped têm nomes próprios e ficam de fora):

**Antes (repetitivo):**

```
{ "cost": { "id": "minecraft:oak_log", "count": 16 }, ... },
{ "cost": { "id": "minecraft:spruce_log", "count": 16 }, ... },
{ "cost": { "id": "minecraft:birch_log", "count": 16 }, ... }
```

**Depois (`family`):**

```
{
  "cost": { "family": "log", "count": 16 },
  "result": { "id": "minecraft:emerald", "count": 1 },
  "max_uses": 10,
  "xp": 2
}
```

- **No jogo:** o NPC sorteia uma tora concreta (ex.: *Cherry Log*) e o jogador entrega exatamente ela. No `/visitors reloadtrades` a exigência pode virar outra madeira.
- **Filtro por espécie:** use `variants` — `{ "family": "log", "variants": ["oak", "spruce", "birch"], "count": 16 }` (é o que o visitante default usa).

## 2. Família colorida (compra de todas as cores)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#2-fam%C3%ADlia-colorida-compra-de-todas-as-cores](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#2-fam%C3%ADlia-colorida-compra-de-todas-as-cores)

O vidreiro compra 16 corantes de **qualquer cor**:

```
"cost": { "family": "dye", "count": 16 }
```

- Sem `color`/`colors`, o sorteio usa as **16 cores** de `DyeColor` — vale para `wool`, `banner`, `terracotta`, `candle`...

## 3. Família colorida restrita (venda)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#3-fam%C3%ADlia-colorida-restrita-venda](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#3-fam%C3%ADlia-colorida-restrita-venda)

Venda de vidro tingido apenas nas cores da lista:

```
"result": { "family": "stained_glass", "colors": ["white", "light_gray", "gray", "black"], "count": 3 }
```

- **Cor única fixa:** substitua o array por `"color": "red"`.

## 4. Variante fixa (venda)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#4-variante-fixa-venda](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#4-variante-fixa-venda)

Muda de espécie vendida com `variant`:

```
"result": { "family": "sapling", "variant": "cherry", "count": 1 }
```

- A mesma família sem `variant` (`{ "family": "sapling", "count": 1 }`) sorteia entre as 7 espécies de `SAPLING_TYPES` (mangrove é `mangrove_propagule`).

## 5. `one_of` — grupo de flores (compra)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#5-one_of--grupo-de-flores-compra](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#5-one_of--grupo-de-flores-compra)

Visitante default aceita **uma** flor sorteada das 4:

```
{
  "cost": { "one_of": ["minecraft:dandelion", "minecraft:poppy", "minecraft:blue_orchid", "minecraft:lily_of_the_valley"], "count": 12 },
  "result": { "id": "minecraft:emerald", "count": 1 },
  "max_uses": 3,
  "xp": 2
}
```

- Compra exige o item exibido na oferta (`ItemCost` não aceita tag).

## 6. `one_of` — consumíveis (venda)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#6-one_of--consum%C3%ADveis-venda](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#6-one_of--consum%C3%ADveis-venda)

Bandeja de comidas: o item vendido é sorteado por oferta:

```
{
  "cost": { "id": "minecraft:emerald", "count": 1 },
  "result": { "one_of": ["minecraft:bread", "minecraft:apple", "minecraft:cookie",
                "minecraft:cooked_beef", "minecraft:melon_seeds"], "count": 4 },
  "max_uses": 12,
  "xp": 1
}
```

---

## Lembrete

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#lembrete](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Guia-de-Exemplos.md#lembrete)

Após editar o JSON em `config/visitingvillagers/trades/`, recarregue com:

```
/visitors reloadtrades
```