MineColonies Wiki


The Mine is where you can hire a Miner to work the mine, or a Quarrier to work the Quarry. If you hire a Quarrier, there will be no Miner at this Mine.

At the Mine, the Miner will mine for ores and materials. Once they are hired, the Miner will first create a shaft downward to a specific depth depending on the level of the Mine. Once the main shaft is completed, the Miner will then branch out.

While mining, sometimes the Miner will get lucky and get an ore block instead of a basic stone block. The chance of getting “Lucky Ores” is set in the config.

Note: Placing the Mine hut below the maximum Y level it can mine will cause the Miner not work and complain the hut needs to be upgraded. To avoid this error, place the hut at least 4 blocks above the maximum depth for the hut level (above Y=54 for 1.16 or Y=44 for 1.18 level 1). If you want your mine to be lower, you will need to upgrade it before the miner will work.

Mine Level Shaft Y Level Shaft Y Level
  1.16 1.18+
1 50 40
2 30 20
3 Bedrock 0
4   Bedrock





Mine GUI


When accessing the Mine hut block by right-clicking on it, you will see a GUI with different options. You start on the main tab:

  • Pencil: Allows you to rename the building. The level of the building will always be listed after the name.

  • Hut Level: Tells you the type of hut and the build level of the building you have selected.

  • Assigned Workers: Tells you the worker assigned to this building.

  • Manage Workers: Lets you change which worker is assigned to work at this hut. There can only be one worker at each hut. Note: this only works if you have turned the worker hiring mode in the Town Hall block to manual, otherwise your citizens will be hired automatically.

  • Recall Worker: Recalls the worker at this building to their hut block. You might use it if they are stuck somewhere, you want to see what they have, or want to give them something directly.

  • Build Options: Lets you create a build, upgrade, or repair build order for this hut. To learn more about the building system, please visit the Builder page.

  • Pickup Priority: You can set the priority that a Courier will visit this hut and pick up items (when the worker at this hut issues a request), or you can tell Couriers to never visit this hut to pick up items. You can also tell a Courier to do a pickup now using the Request Pickup Now button. (For the pickup priority, 10 is the highest.)

  • Inventory: Here you can access the hut block’s storage, where the worker at this hut takes and deposits materials. They will also use any racks that were placed in the hut when it was built or upgraded, so be sure to check those as well!

  • ?: Some huts have an in-game guide. Press the ? button to access it.

  • A chest icon: Click this button to see all the items in the hut’s storage (including the hut block’s inventory and any racks that came with the hut). Clicking the ? button next to an item’s count will highlight the storage container it’s in.


The second tab of the GUI is Crafting Recipes.

Here you can see all the crafting recipes this hut knows. The arrows allow you to move them up or down in priority. You are also able to remove or disable specific recipes.<p> Teach Recipe: When clicking teach recipe, it opens a crafting grid which allows you to teach this hut recipes (not the worker).</p>

Minimum stock GUI

The third tab of the GUI is Minimum Stock. It has one button:

Use this button to tell the Mine to keep a minimum stock on hand. Set items will be displayed above the button.


The fourth tab of the GUI is Required Resources.

These are the resources that the Miner will need for the area of the Mine they are currently working on.

  • Current project The top line tells you which mine schematic is being worked on.
  • Step What step of the project the Miner is on.
  • Supplied %/ Used % How much of the needed resources are in the Miner's & Mine hut's inventory, and how many of the resources have been placed.
  • Item Each needed item is displayed, along with how many of that item is in inventory, and how many are needed. These amounts will change as they place blocks and will show only what blocks the Miner still needs to place. The block in black are in their inventory. The blocks in red are the ones neither you nor the Miner has in their inventory. The blocks in green are ones you have in inventory but the Miner needs. Clicking the up arrow next to the item will automatically remove that item from your inventory and place it into the Mine hut's.


The fifth tab of the GUI is Levels.

The level refers to the platforms the Miner will place every 3 blocks down. Here you can assign what level of the Mine the Miner will create their mineshafts (nodes). If a level has a red number next to it, that means the Miner is currently mining that level. The Miner will ignore orders to mine at a specific level until the entire mineshaft is completed to the maximum depth their hut’s level allows. You can also click Repair, to tell the Miner to restore that level to its original state. This can be useful if a fire breaks out in the mineshaft.


The sixth tab of the GUI is Settings.

  • Fill Block: Here you can select what block the Miner uses to fill in holes/gaps in the Mine. The default is the cobblestone block.

  • Max Depth: Here you can overide the default maximum depth of the Mine, if you don’t want the Miner to dig as deep as the Mine level allows. The default is -100 (minus sign is not visible in the window).


The seventh tab of the GUI is Guards.

Here is where you can assign Guards to patrol this Mine. If assigned, they will patrol the level the Miner is currently mining at, to help protect them from hostile mobs. Only Guards set to the Patrol Mine task will show up here; tasks can be set in the Guard Tower GUI (Barracks Towers do not have the Patrol Mine task). One Guard can be assigned at Mine levels 1 and 2, two Guards can be assigned at Mine levels 3 and 4, and three Guards can be assigned at Mine level 5.

If changes are needed or you think there is content missing, feel free to edit this page (the button at the top right) or submit an issue for us to make edits. - MineColonies Wiki Team