Villager API
No reviews yet
An API to add custom villager professions and villager biome types with custom trades without writing code.
Does not follow a specific thematic focus apart from vanilla Minecraft.
Used for mods with little to no gameplay elements.
Contains enhancements to village mechanics, expanding on existing features or adding entirely new ones.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Provides a framework or library for other mods to use.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Quilt is a fork of the Fabric mod loader. Many Fabric mods are compatible with Quilt and vice versa.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
Must be installed on both the client and the server.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
Villager API
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.
What does it do?
This mod lets you create completely custom villagers with your own:
- Professions - New jobs with custom workstations and trading lists
- Types - Different villager appearances tied to specific biomes
- Trades - Full control over what villagers buy and sell at each level
- Hero Gifts - Custom loot tables for post-raid rewards
Everything is handled through JSON files in the villagerpacks folder. No coding, no complex setup—just make your files and load up the game.
Quick Example
Want an Alchemist villager who uses a crying obsidian block as their workstation?
- Create
villagerpacks/my_pack/villagers/poi_types/alchemist.jsonandvillagerpacks/my_pack/villagerapi_config.json - Define the workstation block
- Add the profession file linking to that POI type
- Set up your trades
- Drop in textures for the profession overlay
That's it. The mod handles registration, trade mechanics, and everything else.
What can you customize?
- Workstations - Any block can be a job site
- Trading pools - Define exactly what villagers offer at each experience level (Novice through Master)
- Item components - Full support for enchantments, custom names, potions, and all the data components Minecraft uses
- Treasure maps - Sell maps to modded or vanilla structures with custom markers
- Biome appearances - Make villagers look different depending on where they spawn
- Biome-specific trades - Same profession, different inventory based on location
Who and what is this for?
If you've ever wanted to add villagers to your modpack or mod without dealing with Java code, this is for you. It's built for pack makers and modders who want villager content without the headache of getting into learning and writing java code.
Works with both regular resource pack like villager packs and as part of mods by simply putting a villagers folder in your mods main directory. Multiple packs can run at once—later packs override earlier ones where there's overlap.
Full Documentation
Check the complete documentation with examples and all available options here:
https://github.com/frikinjay/villagerapi/blob/main/DOCUMENTATION.md
You can generate a pack online here without having to manually create all the files: Villager Pack Generator
The docs include the full pack structure, all JSON formats, item component examples, and a complete example pack to get you started.
Villager API
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.
What does it do?
This mod lets you create completely custom villagers with your own:
- Professions - New jobs with custom workstations and trading lists
- Types - Different villager appearances tied to specific biomes
- Trades - Full control over what villagers buy and sell at each level
- Hero Gifts - Custom loot tables for post-raid rewards
Everything is handled through JSON files in the villagerpacks folder. No coding, no complex setup—just make your files and load up the game.
Quick Example
Want an Alchemist villager who uses a crying obsidian block as their workstation?
- Create
villagerpacks/my_pack/villagers/poi_types/alchemist.jsonandvillagerpacks/my_pack/villagerapi_config.json - Define the workstation block
- Add the profession file linking to that POI type
- Set up your trades
- Drop in textures for the profession overlay
That's it. The mod handles registration, trade mechanics, and everything else.
What can you customize?
- Workstations - Any block can be a job site
- Trading pools - Define exactly what villagers offer at each experience level (Novice through Master)
- Item components - Full support for enchantments, custom names, potions, and all the data components Minecraft uses
- Treasure maps - Sell maps to modded or vanilla structures with custom markers
- Biome appearances - Make villagers look different depending on where they spawn
- Biome-specific trades - Same profession, different inventory based on location
Who and what is this for?
If you've ever wanted to add villagers to your modpack or mod without dealing with Java code, this is for you. It's built for pack makers and modders who want villager content without the headache of getting into learning and writing java code.
Works with both regular resource pack like villager packs and as part of mods by simply putting a villagers folder in your mods main directory. Multiple packs can run at once—later packs override earlier ones where there's overlap.
Full Documentation
Check the complete documentation with examples and all available options here:
https://github.com/frikinjay/villagerapi/blob/main/DOCUMENTATION.md
You can generate a pack online here without having to manually create all the files: Villager Pack Generator
The docs include the full pack structure, all JSON formats, item component examples, and a complete example pack to get you started.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers