Villager API Mod Wiki
Villager API Mod Wiki & Guide
wiki.9minecraft.net/villager-api-mod/
Provides an API framework for modifying and extending villager behavior and trades.
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 ›
Related mods
Other wikis you may find useful.
Villager Names Mod
Villager Config Mod
Custom Villager Trades