---
title: 03 – Guia de Configuração de Trocas (JSON)
description: "As trocas dos visitantes ficam na pasta `config/visitingvillagers/trades/` — cada arquivo `.json` representa uma variante de NPC. --- ## 1. Tipos de Itens nas Ofertas (`cost` e `result`) [https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#1-tipos-de-itens-nas-ofertas-cost-e-result](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#1-tipos-de-itens-nas-ofertas-cost-e-result) ### A) Item Fixo [https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#a-item-fixo](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#a-item-fixo) Item específico, com quantidade exata: ```…"
url: "https://redstonegames.com.br/docs/guia-de-configuracao-de-trocas-json/"
updated: "2026-11-04"
category: Mods Java / Visiting Villagers Mod
---

# 03 – Guia de Configuração de Trocas (JSON)

As trocas dos visitantes ficam na pasta `config/visitingvillagers/trades/` — cada arquivo `.json` representa uma variante de NPC.

---

## 1. Tipos de Itens nas Ofertas (`cost` e `result`)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#1-tipos-de-itens-nas-ofertas-cost-e-result](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#1-tipos-de-itens-nas-ofertas-cost-e-result)

### A) Item Fixo

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#a-item-fixo](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#a-item-fixo)

Item específico, com quantidade exata:

```
{ "id": "minecraft:emerald", "count": 5 }
```

### B) Família Completa (sorteada)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#b-fam%C3%ADlia-completa-sorteada](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#b-fam%C3%ADlia-completa-sorteada)

O mod sorteia aleatoriamente **qualquer variação** válida da família a cada reabastecimento de ofertas (todas as cores de corante, todos os tipos de madeira...):

```
{ "family": "log", "count": 16 }
```

### C) Família com Filtro (restrita)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#c-fam%C3%ADlia-com-filtro-restrita](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#c-fam%C3%ADlia-com-filtro-restrita)

Igual à anterior, mas o sorteio fica restrito às opções listadas em `colors` ou `variants`:

```
{ "family": "wool", "colors": ["white", "black", "gray"], "count": 4 }
```

### D) `one_of` (lista de ids completos)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#d-one_of-lista-de-ids-completos](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#d-one_of-lista-de-ids-completos)

Para grupos que **não** compartilham sufixo no nome (comidas, flores, sementes...), liste os ids completos e o mod sorteia **um** deles por oferta — funciona com itens de qualquer mod registrado:

```
{ "one_of": ["minecraft:dandelion", "minecraft:poppy", "minecraft:blue_orchid", "minecraft:lily_of_the_valley"], "count": 12 }
```

---

## 2. Famílias Suportadas (exemplos)

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#2-fam%C3%ADlias-suportadas-exemplos](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#2-fam%C3%ADlias-suportadas-exemplos)

- **Corantes / Vidros / Lanternas:** `dye`, `wool`, `carpet`, `stained_glass`, `stained_glass_pane`, `bed`, `candle`, `terracotta`.
- **Madeiras / Blocos:** `log`, `sapling`, `planks`.

> 💡 **Dica:** uma família ou id que não existe no jogo gera **aviso no log do servidor** e o mod volta ao arquivo padrão (*fallback*) — o jogo não fecha com erro (*crash*).

---

## 3. Como Aplicar as Mudanças no Jogo

[https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#3-como-aplicar-as-mudan%C3%A7as-no-jogo](https://github.com/redstonegamesb/Visiting-Villagers-Forge-1.21/blob/master/DOCS/Wiki/Configurando-Trocas.md#3-como-aplicar-as-mudan%C3%A7as-no-jogo)

Não precisa reiniciar o jogo: edite os arquivos JSON em `config/visitingvillagers/trades/` e use no chat do servidor:

```
/visitors reloadtrades
```

O mod recarrega as trocas e atualiza instantaneamente os NPCs que já estão no mundo.