# Villager API<\/p>\n
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.<\/p>\n
## What does it do?<\/p>\n
This mod lets you create completely custom villagers with your own:
\n– **Professions** – New jobs with custom workstations and trading lists
\n– **Types** – Different villager appearances tied to specific biomes
\n– **Trades** – Full control over what villagers buy and sell at each level
\n– **Hero Gifts** – Custom loot tables for post-raid rewards<\/p>\n
Everything is handled through JSON files in the `villagerpacks` folder. No coding, no complex setup\u2014just make your files and load up the game.<\/p>\n
## Quick Example<\/p>\n
Want an Alchemist villager who uses a crying obsidian block as their workstation?<\/p>\n
1. Create `villagerpacks\/my_pack\/villagers\/poi_types\/alchemist.json` and `villagerpacks\/my_pack\/villagerapi_config.json`
\n2. Define the workstation block
\n3. Add the profession file linking to that POI type
\n4. Set up your trades
\n5. Drop in textures for the profession overlay<\/p>\n
That’s it. The mod handles registration, trade mechanics, and everything else.<\/p>\n
## What can you customize?<\/p>\n
– **Workstations** – Any block can be a job site
\n– **Trading pools** – Define exactly what villagers offer at each experience level (Novice through Master)
\n– **Item components** – Full support for enchantments, custom names, potions, and all the data components Minecraft uses
\n– **Treasure maps** – Sell maps to modded or vanilla structures with custom markers
\n– **Biome appearances** – Make villagers look different depending on where they spawn
\n– **Biome-specific trades** – Same profession, different inventory based on location<\/p>\n
## Who and what is this for?<\/p>\n
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.<\/p>\n
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\u2014later packs override earlier ones where there’s overlap.<\/p>\n
## Full Documentation<\/p>\n
Check the complete documentation with examples and all available options here:
\n**https:\/\/github.com\/frikinjay\/villagerapi\/blob\/main\/DOCUMENTATION.md**<\/p>\n
You can generate a pack online here without having to manually create all the files:
\n**Villager Pack Generator**<\/p>\n
The docs include the full pack structure, all JSON formats, item component examples, and a complete example pack to get you started.<\/p>\n","protected":false},"excerpt":{"rendered":"
An API to add custom villager professions and villager biome types with custom trades without writing code.<\/p>\n","protected":false},"featured_media":166472,"template":"","meta":{"_minecraft_slug":"villagerapi","_minecraft_project_id":"9Tp2Becg","_minecraft_author":"frikinjay","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":48883,"_minecraft_follows":33,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villagerapi.zip","_minecraft_size_bytes":2998469,"_minecraft_version_count":26,"_minecraft_updated_at":"2026-05-16T09:39:30.314579Z","_minecraft_date_created":"2025-12-03T04:35:43.361396Z","_minecraft_date_modified":"2026-01-27T01:02:25.450439Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villagerapi","_minecraft_icon_attachment_id":166472,"_minecraft_imported_at":"2026-06-09T18:24:06+00:00","_minecraft_import_hash":"f9077ca66b8d15fcd01fb4b9def3497b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,873,137,158,98,92],"mod_loader":[99,160,100],"minecraft_version":[37,41],"class_list":["post-166471","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-library","mod_category-mobs","mod_category-neoforge","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-21-1","minecraft_version-1-21-11"],"yoast_head":"\n