MineColonies Wiki

Getting Started

This tutorial assumes you have already installed the mod or modpack. If you’d like instructions on how to install our Official Modpack, you can find instructions for doing that on Java (Forge) here, on GDLauncher here, and on the Curseforge Launcher here.

Quick Walkthrough

Before you get started on your new colony, you should find your perfect location. You need a large enough area for a full city-at least 8x8 chunks, and decently flat.

You should also gather as many resources as you can-wood, as well as cobble, coal, iron, flowers, string, leather, wool, saplings, and food.

Step 1: Supply Camp/Supply Ship

Once you have chosen a location for your colony, you must place a Supply Ship or Supply Camp. You can only place one of these per world. The Supply Camp/Ship gives you the Town Hall block you need to officially start your colony. They also have some other supplies you may need during the building of your colony. Once you have the Town Hall block and the build tool, the remaining camp/ship is just decoration. You can leave it or tear it down.

Step 2: Town Hall

The Town Hall block is what actually creates the colony. It also functions as the center of it. This is where you start using the build tool to place buildings. Using the build tool ensures you can see exactly where the building will be, which direction it will face, and if it is at the right Y level (some buildings need to be raised to the correct Y level).

Once the Town Hall block is placed, you will start receiving your initial 4 citizens.

Step 3: Builder

Before anything can be built, you need a Builder. The Builder must build their own Builder’s Hut before building any other huts, and they cannot build or upgrade a hut to a higher level than their own hut level.

Step 4: Tavern

Your colonists will need a place to sleep and a house, so it is recommended to build a Tavern next. The Tavern also allows visitors to come to your colony, and you can recruit them to stay as citizens.

Step 5: Food

The next major thing you need for your colony is food. The fastest way to get food is to build a Fisher’s Hut. You could build a Farm or one of the animal herders, but a Fisher is faster. Building a Restaurant may also be advisable if you don’t want to feed your colonists (or cook their food) by hand.

Step 6: Forester

If your style is wood, it’s recommended to build a Forester’s Hut next. That way your new Forester can start gathering wood for your next builds and for tools and other items.

Step 7: Miner

Stone and ores are another major need for any colony, so a Mine is the next logical step.

Step 8: Warehouse and courier

At this point, you might be tired of bringing all of the resources to the Builder and taking them from the Fisher, Forester, Miner, etc. You also might want to store items in one place. Well, the Warehouse and Courier’s Hut are the solution you are looking for! Couriers transport items between the Warehouse and all of the workplaces. The Clipboard and Resource Scroll may be helpful!

Step 9: Rest of the Colony

This is where you need to decide what you need next, based on how you play and what your colony needs. But you have several things to look at. Once you get seven citizens you can get attacked by raiders and you may want to build a Guard Tower, or you may get a sick citizen and want to build a Hospital, or you may decide you want a Sawmill to make the needed items for a worker. Or you may just want to have a specific worker, or you found a great place for a certain hut. You decide how your colony will grow!

Detailed Walkthrough

If you’re here, CONGRATULATIONS! You have already installed MineColonies and are ready to embark on an adventure to explore, conquer and establish your own colony. Work hard and turn it into a thriving town. Hone your leadership skills and grow grow grow into a city! Lastly, can you be a grand leader and finally achieve a metropolis? (Check your ingame MineColonies Achievements.)


To avoid mistakes and frustation, read through this entire guide carefully before starting to play.

Placement of the Supply Ship or Supply Camp

To place the Supply Ship, you need to have a large enough body of water (at least 32 x 20). To place the Supply Camp, you need to have a large enough flat, clear piece of land (at least 16x17 blocks).

When you place the Supply Ship/Camp, it will spawn a chest that will contain the Town Hall block and the build tool. Once the Supply Ship/Camp is placed, you can’t place another in the world.

Place the Supply Ship/Camp by right-clicking the item directly on the water/ground – if you have a build tool already, don’t use it for this (you’re expected to get the tool from the camp/ship rather than already having one).

Hint: If you’re not able to place the Supply Camp/Ship, try it block by block: one to the right, left, closer or further from the area you cleared. The area cannot contain any holes or have any flowers, grass, ferns, seaweed, coral etc.

Town Hall

The protected area of your colony (once the Town Hall has been placed) will be a square 4 chunks in radius, measured from the chunk where you placed your Town Hall block the first time (with the default config). Therefore, plan carefully where you want to place your Town Hall. 64 blocks (4 chunks x 4 chunks) in every direction from that chunk will be your protected Town area including mountains, hills, lakes, oceans, caves, world generated structures, etc. from bedrock to sky limit.

Hint: The most important tool you will need for the entire mod is the build tool (check our build tool page). Obtain one from the Supply Ship/Camp or craft another so you can place all the huts (including the Town Hall) in the perfect spot.

Build Tool Video.

Due to the protected area of each colony, you have to carefully scout your surrounding to make sure you are clear of any other colonies nearby preventing you from placing your Town Hall or limiting your colony area in that direction (in multiplayer, etc.). If there is another colony too close to your current position, you won’t be able to place a Town Hall.

Location info of the next closest colony exists in the debug screen (displayed when you press F3). If there is a colony close to your current position, it will also show you the required distance away to place your Town Hall.

Next Colony

Player's Colony

No Colony

For example, in the official MineColonies server it will be the default 4 chunk radius (4 + 4 + 1 {center Chunk where Town Hall was placed} = 9 chunks or 144 total blocks required). It therefore, will tell you: “Next colony is XXX blocks away. (272 required to place a colony).”

Now, after you have explored, thought carefully, planned, and found the perfect spot to start your colony, let’s take a look at the steps to get your colony running!

Setting Up Your Colony

Step 1

Get enough materials and craft your Supply Ship/Camp, then place it by right-clicking a block with it (do not use the build tool, if you happen to already have one). There will be a chest (or rack) inside the placed Ship/Camp with a Town Hall block and a build tool.

Hint: Gather as many materials as possible to give to your Builder when they start building. They will ask you for all kinds of materials for each building or upgrade, depending on the style of building you have chosen. The materials needed for most styles will be mainly wood, cobblestone, and torches for the lower levels. Further upgrades will require more elaborate materials.

Step 2

After you have carefully decided where you want to place your Town Hall (remember, the position where you placed the Town Hall block at first will be the center of your colony’s protected area. Once placed, the area will be set and cannot be changed), use your build tool to place the Town Hall. Once you commit to the placement of the Town Hall (the green checkmark), the Town Hall block will be placed. To officially start a colony, you need to right-click on the block, then select Create New Colony. Once you’ve done this, your initial four citizens will start appearing!

You can now right-click the Town Hall block again to look at its graphical user interface, or GUI for short:

Town Hall GUI

You can use the tabs on the left side to switch between different categories.

Information: This is the overall information section of the Town Hall GUI.

TH GUI Information Tab
  • Page 1: Here you will see some statistics on your citizens, like the number of citizens you have and if they are unemployed or workers. If they are workers, you will see what job they have.

  • Page 2: Here you will see the overall happiness of the colony's citizens and any events that happened within the colony (the newest events are at the bottom). You can click the button to switch to a permission log, which will show any illegal actions that happened in the colony (like if a player tried to break a block when they aren't allowed to). Clicking the plus next to an illegal action will change it to a legal action if the player tries to do it again. For more information, see the Protection system and the Permission tab of the Town Hall GUI.

Actions: This is the most important section.

TH GUI Actions Tab

Page 1: Here you will see the name of your colony as well as the building level of the Town Hall. And the buttons:

  • Build Options-Lets you create a build, upgrade, reposition, or repair build order for the Town Hall. To learn more about the building system, please visit the Builder page.

  • Rename Colony-To change the name of your colony (from Your Username's Colony, which is the default) to anything you want.

  • Hire Mercenaries-Here you can hire mercenaries to help defend your colony. Be warned, they're mean and will steal from citizens!

Page 2: This is only enabled if PVP is turned on in the config file. Here you have:

  • Allies-Other colonies that you have added as allies and that have confirmed your colony as an ally as well.

  • Feuds-Other colonies that you have added as a feud and that have confirmed your colony as a feud as well.

Permissions: Here you can invite other players to your colony to collaborate.

Permissions Pg. 1 & 2: You can add a player and give them a rank in your colony. Each rank will have certain privileges in the changeable protection system.

TH GUI Permissions Tab
  • Page 1: Here you type the name of the player you want to add.

  • Page 2: Shows the list of players that have ben added as well as their current rank. You can click on the "-" or "+" to give them a higher rank or lower rank.

Permissions Pg. 3 & 4: Here you can manage the permissions for each rank.

TH GUI Permissions Tab Pg.2
  • Page 3: Here you can select the rank that you would like to manage.

  • Page 4: Here are the individual permissions (for the rank you have selected on the previous page) that you can toggle ON or OFF, giving each rank the permission you want.

Permissions Pg. 5 & 6: In this section, you can add a certain block's position that will bypass the protection system for interaction. Any player will be able to interact with that block as long as their rank includes the permission 'Access Free-Blocks.'

TH GUI Permissions Tab Pg.3

  • Page 5: Where you enter the position (X, Y, Z) of the block that you want to make free for interaction.

  • Page 6: Here you will see the list of block positions that you have added as free for interaction and can remove them.

Citizens: This section displays the names and skill levels of the citizens in your colony.

TH GUI Citizens Tab

  • Page 1: When you select a citizen, their stats and job will appear here. You can also recall them to the Town Hall block on this page.

  • Page 2: Here you will see a list of the citizens in your colony. Select a citizen to see their skills.

Settings: This section is where you can control how your citizens will be hired and assigned housing in your colony, among other things.

TH GUI Settings Tab

Page 1: There are four buttons here:

  • Worker hiring mode: Clicking on this button lets you switch between automatic or manual. If it's in automatic mode, you can't fire or hire any citizen from any worker hut and the best unemployed citizen will be hired for you. In manual mode you will be able to hire and fire whichever citizen you want at any time.

  • Housing assignment mode: Clicking on this button lets you switch between automatic or manual. If it's in automatic mode, citizens will be assigned a house as soon as they spawn (if housing is available). In manual mode, you can select which citizens will be housed in each House or Tavern. This is better if you have a large colony and many workers spread out in a large area so you can house your citizens as close as possible to their workplace.

  • Show help messages: Clicking on this button lets you choose whether MineColonies help messages will appear in the chat. It is recommended that this be turned on for first-time players.

  • Kids will be born: Clicking on this button lets you choose whether new kids will be born in your colony.

Page 2: There are two buttons here:

  • Pick Team Color: Whatever color you pick from here, your Guards will have a glow of this color around them when you put them in follow mode at their Guard Tower or Barracks Tower. This is for the PVP system, so you know which Guards are yours when you are fighting. Your citizens' names will also be in this color.

  • Edit Colony Flag: Clicking this button will open up a banner designer where you can design your colony banner. Your Knights will wear the finished design on their shields, and it is also used in some schematics.
  • TH GUI Banner Designer

Work Orders: Here you will see the work orders your Builders have in the order they have been assigned. Builders will not start another order until they have successfully completed the top one.

TH GUI Work Orders Tab
  • Page 1: Blank page except for the header (future use).

  • Page 2: Here are all the build orders for this colony (including decorations and your own schematics as well as huts). Your Builders will complete the builds from top to bottom, and you can change the priority of the builds by moving them up or down in the list. You can also delete work orders. When you delete a work order that is currently being built, the Builder will stop building and will continue where they left off if you create the work order again.

Happiness: This is the section for the global happiness of your colony so you can see what area needs more attention to raise the happiness level.

TH GUI Work Orders Tab

  • Page 1: The happiness indices. You can keep track of the areas that will lower or raise the happiness of your citizens here. The colors, in order from best to worst, are: green (super happy), blue (happy), yellow (not happy), and red (big problem here-your citizens are definitely not happy). There's also black, which will show up if something went wrong.

  • Page 2: Blank for now (future use).

Step 3

Before any other building can be built, you must craft the Builder’s Hut block and use your build tool to place it. Once you commit to the placement of the Builder’s Hut (the green checkmark), the block will be placed and a Builder will be automatically assigned (or you can manually assign one with the best traits for a Builder if you changed this in the setting tab in the Town Hall’s GUI). You now officially have a Builder! CONGRATULATIONS! When accessing the Builder’s Hut block by right-clicking on it, you will see a GUI with different options:

Builder's Hut GUI
  • 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](../../source/buildings/townhall) 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](../../source/workers/builder) page.
  • Pickup Priority: You can set the priority that a [Courier](../../source/workers/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](../../source/items/rack) 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.

By pressing the arrow button in the top right corner of the GUI, you will be taken to page 2 of the GUI where you will find the following:

Builder GUI 2

You will have to click Build Options on the Builder’s Hut, then click Build Building. This will give your new Builder the build assignment so they can build their own hut first. If the Builder’s Hut is not built, the Builder cannot build any other buildings.

The Builder will ask for the materials they need. Right-click on them when they have a red icon above their head to see the materials they currently need.

Hint: If you see that the Builder hasn’t finished a build order and you don’t see them asking for any materials, go to the Builder’s Hut, recall the Builder, and wait a bit to see what they need. Also, check page 2 of the Builder’s Hut GUI and see what resources are in red (those are missing resources).

Step 4

Once the Builder has finished their hut, you’re ready to start building any other building you want! Just craft the desired block and use your build tool to place the building. Once it’s placed, go into the GUI for the new block, click Build Options, and then click Build Building. It’s that simple!

Hint: Consider upgrading the Builder’s Hut to level 2 as soon as you can so the Builder can upgrade other buildings.

Final Notes

You have now completed the most important steps to start and create your colony!

Your question now is probably, “What to build next?” The Town Hall, Mine, Forester’s Hut, Farm, Fisher’s Hut, Guard Tower, Courier’s Hut, Bakery, Restaurant, and more are probably good places to start.

But you start with only 4 citizens! Now what? Well, the next step after your 4 citizens are employed and are working hard is to plan and place the House. This will give you additional citizens for each level of a House you build in your colony (after your inital four citizens are housed)! Now, what do you do with so many citizens? You cannot assign more than 1 worker per hut. Therefore, consider building additional huts for more Miners, Foresters, Builders, Farmers, Fishers, and many more! If you struggle with keeping track of what everyone needs, consider making a Clipboard and Resource Scroll. Though you only need one Clipboard, you can make a Resource Scroll for each Builder to keep track of their needs!

Hint: Upgrade your huts to the highest level possible (level 5 for all of them except the Tavern) to get achievements (and increase the speed at which the worker levels).

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