Custom Villager Professions
Create your own villager professions
About this Mod
About
Custom Villager Professions is designed to give you the ability to add your own villager professions. This mod is also useful for modpack authors.
This mod works by reading JSON config files from the config/custom professions directory. By default, no professions are added.
Upon loading, this mod will read all the files you've created and register the new profession, along with the required POI block.
Features
- Register your own profession.
- Register the POI block required for the villager to work at.
- Custom textures for the villager through resource packs.
Wiki
You can access the wiki here. It contains a full guide for Custom Professions.
Warning: If you are not using the latest version of this mod, some features may not be available to you.
Help!
Before asking for help, please consult the wiki.
If you still need further help, you can open an issue here or ask on the discord.
Modpacks
You can use this mod in your modpack.
My Mods
If you like this mod, check out my other mods!
Available Versions
How to Install Custom Villager Professions on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Custom Villager Professions". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1, 1.19.2
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Custom Villager Professions server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Custom Villager Professions compatible with fabric and forge?
Custom Villager Professions officially supports fabric, forge for Minecraft 1.20.1, 1.19.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Custom Villager Professions – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Custom Villager Professions consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Custom Villager Professions with just one click on your server.