MineColonies Wiki


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 Twitch here, on MultiMMC here, and on Java (Forge) 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.

You should also gather as many resources as you can. Once you figure out which style you want, you should start gathering enough wood for that style, as well as cobble, coal, iron, flowers, and some saplings for other trees not in your style as they are often used as decoration items.

You should also gather enough food to feed yourself and your initial citizens until you can get workers who gather and cook food.

Step 1: Supply Camp/Supply Ship

Once you have your location determined, you must place a Supply Ship or Supply Camp. You can only place one of these. The Supply Camp and Ship have 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 building tool, the remaining camp or ship is just decoration. You can leave it if you wish or tear it down.

Step 2 Town Hall

The Town Hall block is what actually creates the colony. This is where you start using the building tool to place buildings. Using the building 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, as they cannot build or upgrade a hut to a higher level than their own hut level.

Step 4 Lumberjack

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

Step 5 Miner

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

Step 6 Food

The next major thing you need for your colony is food. The fastest way to get food is to build a Fisherman’s Hut. You could build a Farm or one of the animal herders, but a Fisherman is faster.

Step 7 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.)


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 our building tool page). Craft the building tool so you can place all the huts and the Supply Ship or Supply Camp in the perfect spot.

Building 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 is at least 32 x 20. Use the building tool to see where the ship will be placed. Once the Supply Ship is placed, you can’t place another Ship or Camp in this world anymore.

Hint: If you’re not using the 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. The area cannot have any seaweed, coral, etc.

When you place the Supply Camp, it will spawn a chest that will contain the Town Hall block and the building tool. To place the Supply Camp, you need to have a large enough flat, clear piece of land. The recommended size must be at least 16 x 17 blocks. Once the Supply Camp is placed, you can’t place another Camp or Ship in this world anymore.

Hint: If you’re not using the 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. The area cannot contain any holes or have any flowers, grass, ferns, etc.

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-common.toml file inside the ../minecraft/config/ folder of your own world.

Due to the protected area of each colony, you have to scout carefully your surroundings 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.

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’ve included some information in the debug screen (displayed when you press F3) 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, 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 8 chunk radius (8 + 8 + 1 {center Chunk where Town Hall 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 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. Now place it with the building tool or by right-clicking a block with it to place your Supply Ship/Camp. There will be a chest inside the placed Ship/Camp with a Town Hall block and a building tool.

  • Hint: Gather as many materials as possible to be able to give them to your Builder when they start building. They will ask you for all kinds of materials they will need 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 building 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 type of workers they are.

  • Page 2: Here you will see the overall happiness of the colony's citizens as well as any events that the colony is having (future use).

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](../../source/workers/builder) page.

  • Citizen Recruitment-Has no purpose (recruiting has been moved to the [tavern](../../source/buildings/tavern)).
  • Recall Citizens-So you can make ALL citizens (workers or unemployed) teleport to the Town Hall block.

  • Toggle Specialization-For future use, has no purpose at the moment.

  • 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!
  • </ul>

    Page 2: This is for the PVP part of the mod. 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.
    </div> </div>

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

    Permissions Pg. 1 & 2: 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.

    TH GUI Permissions Tab
    • Page 1: Here you can type the name of the player you want to add and decide which rank you want them to be. You can choose from Officer, Friend, Neutral, or Hostile.

    • 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 a 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 each 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 regardless of their rank 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 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 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 skill levels.

    #### 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 two 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 [Citizen's Hut](../../source/buildings/citizenhut) or [Tavern](../../source/buildings/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.
    • Page 2: 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](../../source/buildings/guardtower) or [Barracks Tower](../../source/buildings/barrackstower). 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 when looking at them.

    #### Work Orders: Here you will see the work orders your [Builders](../../source/workers/builder) 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](../../source/buildings/builder) block and use your building tool to place his building. 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](../../source/systems/worker) for a Builder if you changed this in the setting tab in the Town Hall's GUI). You now officially have a [Builder](../../source/workers/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
    • Hut Level: Tells you the type of hut and the build level of the building you have selected.
    • Worker Assigned: Tells you the worker assigned to this building and their worker level. The worker levels up in time by working. The higher their level, the faster and more efficient they will be.
    • 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, reposition, or repair build order for this hut. To learn more about the building system, please visit the Builder page.
    • Delivery Priority: You can set the priority that a Deliveryman will visit this hut and pick up items (when the worker at this hut issues a request), or you can tell Deliverymen to never visit this hut to pick up items. You can also tell a Deliveryman to do a pickup now using the Request Pickup Now button.
    • List of Recipes and Teach Recipe: When clicking the list of recipes button, you see all the recipes you have taught this hut and can remove them. When clicking teach recipe, it opens a crafting grid which allows you to teach this hut recipes (not the worker).
    • 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 or chests in the hut, so be sure to check those as well!

    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 [building tool](../../source/items/buildingtool) 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 completed to start and create your colony! Your question now is probably, "What to build next?" The [Town Hall](../../source/buildings/townhall), [Mine](../../source/buildings/mine), [Sawmill](../../source/buildings/sawmill), [Farm](../../source/buildings/farm&field), [Fisherman](../../source/buildings/fisherman), [Guard Tower](../../source/buildings/guardtower), [Deliveryman](../../source/buildings/deliveryman), [Bakery](../../source/buildings/bakery), [Restaurant](../../source/buildings/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 [Citizen's Hut](../../source/buildings/citizenhut). This will give you additional citizens for each level of a Citizen's Hut 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, Lumberjacks, Builders, Farmers, Fishermen, and many more! - **Hint:** Upgrade your buildings to the highest level possible (level 5 for almost all of them) to get achievements (and increase the speed at which the worker [levels](../../source/systems/worker)).

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