Villager API
by frikinjay
Villager API lets pack makers and modders define custom villager professions, biome types and trades through JSON files, with no Java code required.
What it does
The mod is a data-driven framework: files placed in a villagerpacks folder define new professions with their workstation blocks and trading lists, villager types tied to specific biomes, and the trades each villager offers at every level. Packs can be loaded as a regular resource pack or as a villagers folder inside the mods directory, and several packs can run together, with later packs overriding earlier ones where they overlap.
Custom trades can also replace or merge into the vanilla or other modded villager trades. Post-raid hero gifts are configured with custom loot tables. The mod handles registration and trade mechanics itself, so a pack only needs the JSON files. Fabric API is required on every loader, and the mod runs on client and server, so both the server and every player need it. Files are published for Fabric, NeoForge and Quilt, with the 1.21.1 build and the 26.x builds 1.21.11 – 26.3 released under the GNU Lesser General Public License v3.0 only, and the source code is open source.
Key features
Custom professions
New jobs are defined with their own workstation block and trading list, linked to a point of interest type.
Biome-based villager types
Villager appearances can be tied to specific biomes, so the same profession looks different across the world.
Per-level trade control
Each villager level can have its own set of items to buy and sell, including modded items.
Hero gift loot tables
Custom loot tables define the rewards villagers give after a raid is won.
Trade merging
Custom trades can be added to or override the trades of vanilla and other modded villagers.
Gallery
Compatibility
Latest build for each game version and loader.
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Required by 2 mods
How it compares
Villager Lock is open source under the MIT License and runs on Fabric and NeoForge for 1.21.11 – 26.3 as a client and server mod. Profession Locking is server-side only, open source under the MIT License, and built for NeoForge 1.21.1 alone. Fast Piglin Trades is not open source and uses the GNU General Public License v3.0 only, with files for Fabric, Forge, NeoForge and Quilt covering 1.21.5 – 26.3.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Villager API | Fabric, NeoForge and Quilt | 1.21.1 – 26.3 | Client and server | 2026-09-28 |
| Villager Lock | Fabric and NeoForge | 1.21.11 – 26.3 | Client and server | 2026-09-24 |
| Profession Locking | NeoForge | 1.21.1 | Server-side only | 2026-07-19 |
| Fast Piglin Trades | Fabric, Forge, NeoForge and Quilt | 1.21.5 – 26.3 | Server required, client optional | 2026-10-03 |
Questions
Does Villager API need Fabric API?
Do both the server and the players need the mod?
Can custom trades change the vanilla villagers?
What does More Villagers: Re-employed need from Villager API?
In the catalog
Villager API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
More from frikinjay
Similar mods
What the author says
A simple data-driven framework for making custom villager professions, types, and trades without touching any code. Just drop JSON files in a folder and you're done. You can also override or merge custom trades into vanilla or other modded villager's trades. This mod lets you create completely custom villagers with…
Official listing
- Modrinth page
- modrinth.com/mod/villagerapi
- Owner
- frikinjay
- Published
- 2025-12-02
- Updated on Modrinth
- 2026-09-28
- Facts verified
- 2026-10-15