CurseForge · Minecraft mod
Miner Villager
A new entity for the Mineshafts!
Quick answer
Which Miner Villager release should I use?
Miner Villager - 1.20.4 - 6.1 targets 1.20.4 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 2 required mods have matching files.
Where it goes
Is Miner Villager required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Miner Villager - 1.20.4 - 6.1 need?
Miner Villager - 1.20.4 - 6.1. Change the file and its required mods may change too.
Install Bookling Gear, GeckoLib first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Miner Villager without breaking your instance.
Built for Miner Villager - 1.20.4 - 6.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Miner Villager - 1.20.4 - 6.1. It targets 1.20.4 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Bookling Gear, GeckoLib first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Miner Villager - 1.20.4 - 6.1. It opens that exact file at the source.
About this project
What does Miner Villager add?
Ever wanted an underground villager!? Yeah... It's not an entire village, but it's a great teammate for your mineshafts!
Miner Villager
As you might have guessed, he's the heart of the mod! He brings you a variety of useful and new trades. If you're searching for ways to enhance your new pickaxes with special abilities, trade with him until he reaches level 3 and try to obtain one of the 6 scrolls available in the game! While he mostly follows the traditional villager's trading system, his unique GUI adds a fresh twist to the experience. Plus, you'll only find him in mineshafts, making your explorations even more thrilling. And don't worry about the dark, he'll light up the way with his torches !

Pickaxes
Even though the Miner Villager might seem a bit plain, the new set of pickaxes is a game changer that'll revamp your experience and make the grind worth it. Currently, there are 6 unique pickaxes with 3 bases for each set, with more to come soon. For more details, check out the Pickaxes section below!
Search for scrolls to empower mod's pickaxes with special abilities using the Emerald Anvil!
Emerald Anvil
This new and exclusive block will help you to upgrade and repair pickaxes of the mod with its unique GUI.


There are two distinct empowered versions for each set of pickaxes, which cannot be combined.
All pickaxes, in each set, share the same name but have different lore description.
Empowered Iron Pickaxes - This set of pickaxes includes a standard pickaxe, which can be combined with scrolls in the Emerald Anvil to craft its empowered versions! The first version is the Explosive Pickaxe, which allows you to trade gunpowder for a small explosion, making mining faster and more enjoyable. The second version is the Magnetic Pickaxe. Its ability is intuitive: it gives the player the ability to attract nearby items to the holder of the pickaxe, making item collection easier and less risky!

Amethyst Pickaxes - The Amethyst set includes a unique collection of pickaxes, primarily used as empowered versions of diamond pickaxe or as a special tools to experiment with your fortune and creativity! The set starts with the base pickaxe, followed by the Lucky Pickaxe, which gives you a 20% chance of dropping random blocks when mining amethyst blocks. The final pickaxe in the set has a special right click ability that transforms all blocks into amethyst blocks. It is also called Infection Pickaxe. This transformation can be used up to 5 times, but after that, the pickaxe will break, even if it has enough durability remaining.

Emerald Pickaxes - As with the previous sets, the Emerald set includes a base version of the pickaxe designed to be the best in the game. It has the stats of a Netherite pickaxe with high enchantability but very low durability. This pickaxe aims to achieve what the gold pickaxe could not. The Emerald Pickaxe has two special abilities: Buff Pickaxe, which grants the player two buffs, Luck and Hero of the Village effects, after activation. The second ability is Scan Pickaxe, a unique and my favorite ability, that provides a balanced alternative to x-ray vision. Scan offers a more natural way to locate ores and resources without cheating, ensuring a balanced experience)
WARNING: The spot effect may not work properly with some shaders!

Important Changes!!!
1.20.1 + Changes - In the latest game version (1.20.1 and beyond), Mojang has changed the smithing table crafting recipes... Now, to create a base pickaxes, you'll need to find a Toolsmith Villager who might sell one of three new pickaxe templates. These templates are cheaper than the old recipes but rarer to find. You can find these templates from toolsmiths at levels 1 to 3, so you'll need to level up your villager and hope they offer the right template for purchase. I hate making these changes between versions, but it was necessary to keep up with the new updates and make the mod as vanilla friendly as possible.
Check "Images" section for the recipe.
Hi there! Enjoyed this mod, I've got a few more you might like. 😊
Project description from CurseForge.
Pick your setup
Miner Villager by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.4
1 loader build1.20.1
1 loader build1.19.4
1 loader build1.19.2
1 loader build1.18.2
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Miner Villager versions and loaders
Miner Villager - 1.20.4 - 6.1
minervillager-1.20.4-6.1.jar
2 Feb 2026
Miner Villager - 1.20.1 - 5.7
minervillager-1.20.1-5.7.jar
31 Jan 2026
Miner Villager - 1.19.4 - 4.6
minervillager-1.19.4-4.6.jar
29 Jan 2026
Miner Villager - 1.19.2 - 3.6
minervillager-1.19.2-3.6.jar
24 Jan 2026
Miner Villager - 1.20.4 - 6.0
minervillager-1.20.4-6.0.jar
23 Dec 2025
Miner Villager - 1.20.1 - 5.6.1
minervillager-1.20.1-5.6.1.jar
22 Dec 2025
Miner Villager - 1.19.2 - 3.5
minervillager-1.19.2-3.5.jar
22 Dec 2025
Miner Villager - 1.19.4 - 4.5
minervillager-1.19.4-4.5.jar
22 Dec 2025
Miner Villager - 1.20.1 - 5.6
minervillager-1.20.1-5.6.jar
21 Dec 2025
MinerVillager - 1.20.1 - 5.5
minervillager-1.20.1-5.5.jar
1 Aug 2024
MinerVillager - 1.19.4 - 4.4
minervillager-1.19.4-4.4.jar
31 Jul 2024
MinerVillager - 1.19.2 - 3.4
minervillager-1.19.2-3.4.jar
30 Jul 2024
Looking for an older file? The official CurseForge project page is in Resources.