Create a Custom Villager Profession in Minecraft Bedrock

Step 1 of 8

1. Set Up Your Addon Directory Structure

Create a new folder named MyAddon inside your behavior packs directory on your device. Inside this folder, place two essential files: pack.mcmeta and manifest.json to define the addon metadata. Ensure the manifest.json file contains a valid UUID and matches the version format expected by Minecraft. This structure prevents the game from ignoring your files or failing to load them correctly. You will see a clean folder hierarchy ready for resource and behavior definitions.

2. Define the Custom Workbench Block

Write a JSON file named ring_forger_workbench.json inside the blocks folder of your behavior pack. Define the block properties including sound groups, material type, and a custom icon that resembles a forge. Link this block to a unique identifier like 'myaddon:ring_forger_workbench' to avoid conflicts with vanilla blocks. Correct block definitions ensure villagers recognize it as a valid workstation for profession assignment. The block now appears in creative mode with the correct name and texture.

3. Create the Villager Profession Type

Open the villager_professions.json file in your behavior pack and add a new entry for the Ring Forger. Set the profession name, description, and link it to the custom workbench identifier you created earlier. Assign specific trading levels and unlock items for each tier to mimic vanilla progression mechanics. This step tells the game how villagers interact with your workbench and what trades they offer. Villagers assigned to this profession will now show the correct job site icon.

4. Assign Textures and Visual Identity

Create a resource pack folder inside your addon directory to handle texture overrides for the new profession. Add a texture file named ring_forger_texture.png in the images/villagers folder with your custom design. Update the villager_professions.json to reference this texture path under the visual properties section. Proper textures prevent villagers from appearing as default models or glitching when assigned the new job. The villager now displays the unique apron and tool graphics of the Ring Forger.

5. Configure Trading Tables for Tiers

Edit the trades.json file associated with the villager profession to define item exchanges for each level. Add trade entries that include rings as output and specific materials as input for each tier. Ensure the trade probability and max uses are set to realistic values so villagers restock correctly. Balanced trades keep the economy functional and prevent villagers from becoming unresponsive during trading sessions. Players can now buy and sell rings through the Ring Forger interface.

6. Link the Block to the Profession

Verify that the job site block identifier in the profession file matches the block identifier in your JSON exactly. Use the exact string 'myaddon:ring_forger_workbench' in both the block definition and the profession reference. A mismatch here causes villagers to ignore the block and remain unemployed or lose their existing jobs. Consistent naming ensures the game engine connects the physical block to the logical profession type. Placing the workbench now triggers the villager to adopt the new profession.

7. Test Behavior and Movement Integrity

Load your addon into a new world and place the custom workbench near a vanilla villager to test behavior. Watch closely for the villager pathing to workbench and ensure they do not freeze or clip through blocks. If the villager stops moving, check your entity definition files for any conflicting AI tasks or movement scripts. Movement integrity is critical because broken pathing makes the addon unusable for gameplay purposes. The villager moves smoothly to the bench and updates their avatar correctly.

8. Package and Load the Addon

Zip the behavior and resource pack folders into a single file and rename the extension to .mcpack for easy installation. Double-click the file to import it into Minecraft Bedrock on your device or computer. Activate the addon in the world settings before launching the level to ensure all files load. Correct packaging prevents version errors and ensures your changes apply globally across all game sessions. The world now loads with the Ring Forger profession active and visible.

Open the interactive version to track your progress →