MineColonies Wiki


Hello and welcome all new and old players!

If you’d like instructions on how to install our Official Mod Pack we have two options; instructions for the Twitch Launcher click here (Previously Curse launcher) or for MultiMC click here. If you just want to install our Mod in the original Minecraft Launcher click here.

Basic Walkthrough

If you have done the installation, congratulations! You are on your way to having your own thriving colony!

But one of the first questions you should ask yourself is: “Where should I put my town?”. When starting a new world, just play Minecraft how you normally would. Find a nice area where you could start your wonderful new town and start collecting some resources like wood, dirt, sand, gravel and cobblestone.

Hint: The most important tool you will need for the entire mod is the Building Tool (check out our Building Tool page). Craft the Building Tool so you can place all the buildings, worker huts and even the Supply Ship or Supply Camp in the perfect spot.

Building Tool Video.

To start your colony you need to craft either a Supply Ship or a Supply Camp first (only one of these can be placed per player per world). By default, only one colony can be started per player per world. Place the Supply Ship/Camp block using the building tool for the best placement or by right clicking the ground and a chest will spawn exactly where you clicked on the ground. Within this chest will be a Town Hall block and a Building Tool. This is the only way to obtain the Town Hall block, it can’t be crafted.

  • Tip: Supply Camp needs an area of 16 x 12 x 17 to place down.
  • Tip: Supply Ship must be placed in a large pool of water, otherwise it will not be built. This also can not be a river because it is too small; an area of 17 x 30 x 32 is required to place it.

Your first step to start your town is placing the Town Hall Chest. While it can be placed manually, it is far better to place the Town Hall using the Building Tool you obtained from your supply chest. The Building Tool will help you place your buildings, and using it will show you a 3D ghost outline of what the building will look like.

The next thing you should do is craft a “Builders Hut”. Once again, use the Building Tool to place the hut so you can position the hut exactly how you want it. The builders hut will let you hire a builder and, as you may guess, the builder will build and upgrade buildings. Once built, upgrading the builder hut will enable your builder to upgrade the other buildings. In the configuration options of the mod or in the config folder of your Minecraft game you can toggle if your builder builds for free (infinite resources) or whether you have to deliver him the resources.

Currently there are 10 more Worker Huts that can be placed and built. They are: Miners Hut, Lumberjack’s Hut, Fisherman’s Hut, Farmer’s Hut, Baker’s Hut, Cook/Restaurant Hut, Herder’s Hut, Smelter’s Hut, Composter’s Hut and the Guard’s Tower (or barracks). All of these huts lets the workers gather resources if you give them the proper tools. The Lumberjack requires an axe so he can start chopping down trees and getting logs. The miner will need the first level of his building built and he needs a shovel, pickaxe, cobblestone, torches, ladders, fences, planks and slabs (all oak wood type), the Fisherman will require his hut be built first and then a fishing rod, the farmer needs his hut be built as well as for you to create the plot and place the Field (Scarecrow block) and the Guards will need the Guard Tower built first then a bow and/or a sword. Depending on the type of tools given to the workers, they will collect what that tool will allow them. Even use enchanted tools!

View all the recipes here.

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 Settlement. Work hard and turn it into a thriving Town. Hone your Leader 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).


So, the first thing you want to do is find the perfect spot to settle down. But, before you do that, there are two things you have to consider. The following comments are the most important you should read and consider to ensure a successful Town and avoid frustration. Please read all considerations first, before placing your Supply Ship or Supply Camp. Even before starting to play:

Hint: The most important tool you will need for the entire mod is the Building Tool (check out our Building Tool page). Craft the Building Tool so you can place all the buildings, worker huts and even the Supply Ship or Supply Camp in the perfect spot.

Build Tool Video.

Placement of the Supply Ship or Supply Camp

When you place the Supply Ship it will spawn a chest that will contain the Town Hall block and the Building Tool. To place the Supply Ship, you need to have a large enough body of water. The Supply Ship is 32 x 11 blocks in length and width. So the recommended body of water must be at least (32 x 20). Use the Building Tool to see where the pShip will be placed and when you place the Supply Chest a chest will appear on the exact block you right clicked. The Chest will be directly in front of the ladder to board the supply ship (8 blocks from the boarding ladder) and the ladder is not in the middle of the Supply Ship. But please take into account the Town Hall placement as well before you place your Supply Ship. Once the Supply Ship is placed, you can’t place another Ship or Camp in this World anymore.

(Hint: if you’re not using hte Building Tool and aren’t able to place the Supply Ship, try it block by block: one to the right, left, closer or further from the water - or even directly over the water creating a walkway block by block).

When you placed the Supply Camp it will spawn a chest that will contain the Town Hall block and the Buiding Tool. To place the Supply Camp, you need to have a large enough flat, clear piece of land. The recommended flat piece of land must be at least 16 x 17 blocks in size. When you place the Supply Camp a chest will appear on the exact block you right clicked. But please take into account the Town Hall placement as well before you place your Supply Camp. Once the Supply camp is placed, you can’t place another Camp or Ship in this World anymore.

(Hint: if you’re not using hte Building Tool and aren’t able to place the Supply Camp, try it block by block: one to the right, left, closer or further from the area you cleared. It can not contain any holes or have any flowers, grass, fens, etc. It must be completely flat and clear.

Town Hall

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

  • Note: You can configure your own Town area radius in the configuration options of the mod or the the minecolonies.cfg file inside the ../minecraft/config/ folder of your own world. (see minecolonies config server section for details)

Due to the protected area of each Town, you have to scout carefully your surroundings to make sure you are clear of any other Towns nearby preventing you from placing your Town hall or limit your Town area in that direction.

If there is another Colony too close to your current position you won’t be able to place a Town Hall.

If you want to know whether there is a colony too close to your current position we included some information in the debug screen (Displayed when you press the F3 button) which contains a real time tracker showing you the distance to the next colony, the colony you’re currently in, or if there is no colony close at all plus - if there is a colony close to your current position - the required distance to place your Town Hall.

Next Colony

Player's Colony

No Colony

For example, in the official Minecolonies server it will be the default 8 chunk radius (8 + 8 + 1 {center Chunk where TownHall was placed} = 17 chunks or 272 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 own colony, let’s take a look at the required steps to get your Colony running.

Setting Up Your Colony

Step 1

Get enough materials and craft your Supply ship/Camp in a crafting table. Now place it with the Build Tool or by right clicking a block with it to place your Supply Ship/Camp (which you can use as shelter, warehouse or even as materials to give to your builder). It will also give you a chest with your Town Hall block and a Build Tool after placement.

  • Hint: Meanwhile, gather as many materials as possible to be able to give them to your builder when he starts building. He will be asking you for all kinds of materials he will need for each building or upgrade, depending on the style of building you have chosen. Mainly wood, cobblestone and torches for the starter builds. 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 will be the center of your Town’s protected area. Once placed, the area will be set and cannot be changed). Use your Build Tool to place the Town Hall block, once you “commit” to the placement of the Town Hall, the Town hall block will be set and your Citizens will automagically appear. You can right click the Town Hall block to look at its graphical user interface.

Town Hall GUI

You may 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: you will see some statistics on your Citizens: The number of Citizens you have and a listing of the unemployed and workers. It will show you how many and what type you have.

  • Page 2: you will see the overall happiness of the Town's Citizens as well as any "Events" that the Town is having (future use atm).

Actions: This is the most important section. Here you will see your Town's name and the Buttons:

TH GUI Actions Tab

Page 1: Here you will see the name of your Colony and the buttons:

  • Build Building/Switch Style.- The button will say; "Build Building" when no level has been built yet, then it will say; "Switch Style", so you can change the style (at same level you have currently) or also to "upgrade" to next level.
  • Repair Building.- So the builder can "restore" the building to it's original schematic, when alterations have changes something.
  • Recall Citizens.- So you can make ALL citizens (wokers or unemployed) to gather at the Town Hall block location, they will be teleported there. .
  • Toggle Specialization.- For future use, has no purpose at the moment.
  • Rename Colony.- To change the name of the Colony (from player's name) to anything you want, f.e. in coop play and everyone decides on a name.

Page 2: This is for the PVP part of the mod, here you have:

  • Allies.- Other Colonies that you have added as "Allies" and they have confirmed your Colony as ally as well.
  • Feuds.- Other Colonies that you have added as "Feud" and they have confirmed your Colony as feud as well.

Permissions: Here you can invite other players to your Town to collaborate. You can add a player and give him a Rank in your Town. Each Rank will have certain privileges in the protection system that you can configure. Also you can set individual players as "Hostile".

TH GUI Permissions Tab

  • Page 1: Here you can type the name of the player you want to add to your list and grant them certain permissions.

  • Page 2: It shows you the list of players that have ben added as well as their current rank. You can click on the "-" or "+" to give them more rank or less rank.

Permissions Pg. 3 & 4: Here you check and manage the individual permissions for each Rank.

TH GUI Permissions Tab Pg.2

  • Page 3: Here are the buttons for you to select each "Rank" that you would like to view and manage the individual permissions for.

  • Page 4: Here are the individual permissions (for the rank you have selected on the previous page) tha 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 regardless of having a rank or not in your Colony.

TH GUI Permissions Tab Pg.3

  • Page 5: The field where you can 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.

Citizens: This section just displays the names of the citizens in your Colony.

TH GUI Citizens Tab

  • Page 1: Blank page except for the header (future use).

  • Page 2: Here you will see the list of names of the citizens in your Colony.

Settings: This section is where you can control how your Citizens will be hired and assigned housing in your Colony.

TH GUI Settings Tab
  • Page 1: There are two buttons here:
    • Worker hiring mode: Clicking on this button you can switch between automatic or manual. If it's in automatic mode, you can't fire or hire any Citizen from any Worker's hut and the best "unemployed" citizen will be hired for you. In manual mode you will be able to Hire and Fire which ever citizen you want at any time.
    • Housing assignment mode: Clicking on this button you can switch between automatic or manual. if it's in automatic mode the citizens will be assigned as soon as they are spawned and housing is available. In manual mode, you can select which Citizen will be housed at in each Citizen Hut (this is specially better if you have a large Colony and many workers spread out in a large area, so they are housed as close as possible to the workplace).

  • Page 2: Pick team Color: What ever color you pick from here, your guards will have a "glow", of this color, around them when you place them in "follow" mode. this is for the PVP system, so you know which are your guards when you are fighting.

Work Orders: Here you will see the work orders the [Builder](../../source/workers/builder) has in the order they have been assigned. The builder will not start another order until he has 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 listed, that have been created by you (including decorations and your own schematics as well as the mod's buildings). The builder will complete the builds in that order, from top to bottom. Here you can Manage the priority of the builds and even delete work orders. When you delete a work order which is currently being built the builder will stop building and will continue where he left off when you create the build/upgrade order again.

Happiness: This is the section for the global happiness of your Town, 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 3 main areas that will lower or raise the happiness of your Town. There are 3 colors; Green (everything is fine), Orange (needs attention it's below optimal level), Red (Immediate attention is needed - it's in critically low level).

  • Page 2: Intentionally blank for now.

Step 3

Before any building can be built, you have to craft the “Builder’s hut” block in the crafting table and use your Build Tool to place his building. Once you “commit” to the placement of the builder’s hut, the block will be placed and the builder will be automatically assigned (or you can manually assign one with the best “traits” for builder if you changed this in the setting tab in the Town Hall’s GUI). You now officially have a Builder! CONGRATULATIONS! Now you can access the Builder’s block (right click on it) and you will see a similar GUI with different options:

Builder GUI

The Worker assigned and their Level. (The worker levels up in time by doing their work. The higher the level the faster and more efficient they will be). And the buttons:

  • Manage Worker: Hire and Fire workers, if you think you have a better citizen for the job with better skills or traits.
  • Recall Worker: If the worker gets stuck somewhere, or you just want to see what the worker has or give them something directly.
  • Build Options: To create the build/upgrade/relocation/repair work order for this building.
  • Delivery Priority: Automatic or Static option to set priority that the deilveryman will deliver requested items. (1/10 is the lowest priority and 10/10 is the highest priority)
  • List of Recipes: Lists the recipes that you have taught to this worker's hut.
  • Teach Recipe: Opens a 2x2 or 3x3 crafting grid or which allows you to teach this hut recipes, which the currently assigned worker will use to craft items that they require.
  • Inventory: This is the most important button. Here you can access the buildings storage from where the worker takes and deposits materials, tools and anything they find along the way (citizens will pickup anything in their path that is considered a drop; saplings, seeds, rotten flesh, bones, arrows, etc.).

You will have to issue the builder the “Build” assignment so he can build his own Hut first. Without the builder’s hut being built, the builder cannot build any other buildings. He will be asking for the materials he/she needs. Make sure to check the chat regularly to see what materials the builder is requesting for any build/upgrade.

  • Hint: If you see he/she has not finished a work order and you don’t see the builder asking for any materials, go to the builder’s hut and recall the builder and wait a bit to see what he/she needs. Also check Pg. 2 of the Builder’s Hut GUI and see what resources are in red color, those are missing resources.

Step 4

Once the builder has finished his 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 desired building and go into the GUI for that new block you just placed, right click on it and click on the “Build” button. That simple!

  • Hint: Consider Upgrading the Builder’s hut to level 2 as soon as you can so he may be able to upgrade any other building.

Final Notes

You have now completed the most important steps completed to start and create your Colony.

From this point on, you should be able to place, build, upgrade and manage all your buildings and Citizens.

Your questions from this point on are probably what to build next? The Town Hall, Mine, Sawmill, Farm, Fisherman, Guard Tower, Deliveryman, Bakery, etc.? Well, there are many answers, 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 “Citizen Hut”. This will give you additional Citizens for each level of a Citizen Hut you build in your Town! That’s crazy, right? Now what do you do with so many Citizens? You cannot assign more than 1 worker per building. Therefore, consider building additional buildings (more miners, lumberjacks, builders, farmers, fishermen… and more to come!). Check the Citizen Hut section for more detailed info.

There are other buildings that will also “spawn” more citizens for you as well:

  • The Town Hall will spawn and house 1 Citizen per level built.
  • The Barracks will spawn and house 1 Citizen per level of each of it’s Towers’ level built.

  • Hint: Upgrade your buildings to the highest level each one has to unlock achievements (and in the future enable your worker to do more stuff).

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