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) #
A) Item Fixo #
Item específico, com quantidade exata:
{ "id": "minecraft:emerald", "count": 5 }B) Família 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) #
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) #
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) #
- 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 #
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.