Wiki 9Minecraft Wiki 9Minecraft

Villager API Mod Wiki & Guide

Java EditionModGuides 4FAQ 10Related mods 60

Provides an API framework for modifying and extending villager behavior and trades.

DownloadVillager API Mod

Get the files on 9Minecraft

Contents (4)
  1. Guides
  2. Frequently asked questions
  3. Gallery
  4. You May Also Like

Guides

Step-by-step, in-game.

Add Treasure Maps and Raid Gifts to Villager TradesIncluding Treasure Maps in Trades You can make villagers sell treasure maps that point to custom structures or…Create a Custom Villager ProfessionSetting Up Your Profession File Custom professions are defined in simple text configuration files. Navigate to your…Make Villagers Trade Different Items by BiomeBiome-Specific Trade Variants The mod allows the same profession to have different trade lists depending on which…Set Up Multi-Level Trading for a VillagerUnderstanding Villager Levels Villagers progress through five levels: Novice, Apprentice, Journeyman, Expert, and…

Frequently asked questions

Where do I put my custom villager files?
Create a folder called `villagers` in your world's `datapacks` directory, then organize your JSON files inside it by profession name. The mod will automatically scan this folder when the world loads.
Can I use the same profession in multiple biomes with different trades?
Yes—set up one profession file, then use the biome-specific trade system to assign different trade lists to the same job depending on where the villager spawns. This lets you create region-specific merchants without duplicating professions.
What blocks can I use as workstations?
You can use any solid block in the game as a workstation—the mod doesn't restrict you to vanilla job blocks. Just reference the block's ID in your profession file.
How do I make a villager sell enchanted items or custom potions?
In your trade list, use the item NBT syntax to specify enchantments, potion effects, or custom names directly in the trade entry. The mod will handle applying these properties when the trade occurs.

See all 10 Villager API questions ›