Configuration File

The configuration file, commonly called the config file, is a way to change MineColonies settings. It is found within your Minecraft files:

Main Config File Path: (Your Minecraft folder)/saves/(your world's name)/serverconfigs/minecolonies-server.toml

Client Config File Path: (Your Minecraft folder)/config/minecolonies-client.toml

Config Options

The following will be for the 1.16.5 and 1.18.2 config files.

Client-Side Config

Setting Default Description
enablecitizenvoices true Citizens will talk. Set to false to turn off citizens talking.
neighborbuildingrendering true By default, when placing a schematic near other buildings, the already-placed buildings will show as if they were at level 5 and have a blue outline around them. You can disable that by setting this to false.
colonyteamborders true The colony border will be the same as the colony’s team color (set in the Town Hall). Setting this to false will set your town border to white, and all other town borders to red.

Server-Side Config

Name Configuration

Setting Default Description
usemiddleinitial true If this is set to false, citizen names won’t have a middle initial. For example, “John Smith” instead of “John D. Smith”.
useeasternnameorder false If this is set to true, citizen names will have the last name first. For example, “SmithJohn” instead of “John D. Smith” (it’s recommended that if you enable this, also change the actual names to Eastern ones).
malefirstnames
femalefirstnames
lastnames
(various) Lists of names to be used for colonists. Comes pre-filled with English ones, but you can change it to whatever you like. We have some templates here.

Gameplay Configuration

Setting Default Description
initialcitizenamount 4 The number of citizens you get when you first start your colony. If the number of your citizens ever goes below this, more citizens will spawn until it’s at this number again.
builderplaceconstructiontape true If this is set to false, no construction tape will be placed around buildings being built or upgraded.
allowinfinitesupplychests false By default, players can only place one (crafted) supply camp/ship. (However, supply camps/ships found in loot chests can be placed infinitely.) With this enabled, players can place an infinite number of crafted supply ships/camps.
allowinfinitecolonies false Allows players to abandon their colony to start a new one. Note: This is buggy!
allowotherdimcolonies true This allows you to create colonies in the Nether, the End, and modded dimensions.
citizenrespawninterval 60 Changes the amount of time (ticks) before a new citizen spawns. This only applies when a colony is under the initial citizen number, however.
maxcitizenpercolony 250 The maximum limit of citizens that can exist in each colony. If you’re below this limit and you can’t get more citizens, you probably need to complete the research in the University .
builderbuildblockdelay 15 The delay (ticks) for placing blocks. Applies to Builders, Miners, and other colonists that place blocks.
blockminingdelaymodifier 500 The delay (ticks) for breaking blocks. Applies to Builders, Miners, and other colonists that mine blocks.
enableindevelopmentfeatures false Enables some features geared toward developers.
alwaysrendernametag true If disabled, citizen names will only show in the citizen GUI and not above their head.
workersalwaysworkinrain false Workers won’t normally work if it’s raining. Enabling this option or completing the Rainman research causes them to continue working in rain.
sendenteringleavingmessages true Players entering or leaving a colony where they don’t have the Receive Messages permission in, players will be send a message notifying them that they have entered/left the colony. Players that do have the Receive Messages permission in that colony will also be informed of this. If you disable this config option, neither type of player will get that message. This applies to all colonies.
allowglobalnamechanges 1 Sets if players can rename citizens with name tags. To set which players can change the names, see “Special Permissions Group” below.
holidayfeatures true Citizens get some special looks around holidays. Turn off this option to disable that.
updaterate 1 Basically, how fast citizens think. Increasing it decreases how fast they “think”, but improves performance. If you increase it too much, your citizens will take hours to do anything!
dirtfromcompost 1 How many dirt blocks the Composter can get from filling one compost barrel.
luckyblockchance 1 The Miner has a chance to get an ore when mining cobblestone or stone (by default, can be expanded with datapacks to other materials). Change this to change their chance. This is a percentage. (To change which ores the Miner can find, see “List of Lucky Ores”.)
restrictbuilderunderground true By default, the Builder works slower when building underground. Disable this to make them work at the same rate both above and belowground. This can be useful for underground colonies.
minthleveltoteleport 3 By default, you can teleport to allied colonies from your Town Hall. However, it requires a certain Town Hall level or higher (default 3). Here, you can change level.
suggestbuildtoolplacement true By default, when trying to place a hut without the build tool, a window will pop up suggesting you use it. Disabling this option will disable that window.
foodmodifier 1.0 The multiplier for when citizens eat food. Increasing this makes the citizens require more food.
diseasemodifier 5 How common diseases are. Increasing this makes citizens get sick less often.
forceloadcolony false If an owner/officer is inside the colony and this is enabled, some of the rest of the colony chunks will be kept loaded. Useful for large colonies. Set how many chunks are loaded with the below option.
colonyloadstrictness 3 Only takes effect if the above option is enabled. Set this higher to decrease the number of loaded chunks (the innermost chunks will be loaded first). Set to 1 to load all chunks.
badvisitorchance 2 Sometimes, a Tavern visitor will run off with the resources you give them instead of joining your colony. This option sets the percentage chance for them to do that.
generatesupplyloot true By default, supply ships and camps will generate in loot chests. You can disable that by setting this to false.
maxtreesize 400 The maximum logs in one tree for the Forester to detect it as a tree.
nosupplyplacementrestrictions false Disables supply camp placing restrictions. This is intended for skyworlds and similar worldgen.
skyraiders false Raiders will spawn in the sky if this is enabled. This is intended for skyworlds and similar worldgen.

Research System Configuration

Setting Default Description
researchcreativecompletion true Allows automatic and (near) instant completion of research for players in creative mode. If false, creative players will still be able to begin researches, but will have normal progress rates.
researchdebuglog false If true, this significantly increases the amount of information related to research datapacks that is logged during the world load.
researchresetcost Ancient Tome A list of items to charge players when undoing an already-completed research

Command Configuration

Setting Default Description
canplayerusertpcommand false Sets whether players can use the /mc rtp command.
canplayerusecolonytpcommand false Sets whether players can use the /mc colony teleport command.
canplayeruseallytownhallteleport true By default, players can teleport from their Town Hall to an allied colony. Turn off this option to disable that.
canplayerusehometpcommand false Sets whether players can use the /mc home command. However, even with this enabled, only owners of the colony can use this command, as you can be an officer in multiple colonies.
canplayeruseshowcolonyinfocommand true Sets whether players can use the /mc colony info command.
canplayerusekillcitizenscommand false Sets whether players can use the /mc citizens kill command.
canplayeruseaddofficercommand true Sets whether players can use the /mc colony addOfficer command.
canplayerusedeletecolonycommand true Sets whether players can use the /mc colony delete command.
numberofattemptsforsafetp 4 when using /mc rtp, MineColonies will try several locations to see if they’re safe and not within a colony before teleporting you. This sets the number of locations it will try.

Claims Configuration

Setting Default Description
maxColonySize 20 The max number of chunks that can be within a colony’s border.
minColonyDistance 8 The minimum distance between two Town Halls, measured in chunks.
initialColonySize 4 The number of chunks (in radius) claimed when starting a new colony.
restrictcolonyplacement false Should the min/max distance from spawn also affect colony placement? Enabling this sets whether the below two options have any effect.
maxdistancefromworldspawn 8000 Sets the maximum distance {in blocks) from spawn a colony can be started at. Only takes effect if the previous option is set to true.
mindistancefromworldspawn 512 Sets the minimum distance (in blocks) from spawn a colony can be started at. Only takes effect if “Should the min/max distance from spawn also affect colony placement?” is set to true.
officersreceiveadvancements true Sets if officers of a colony will receive advancements for things done in that colony. Disabling this means that only the colony owner will receive advancements.

Combat Configuration

Setting Default Description
dobarbariansspawn true Disable this setting to turn off raids.
barbarianhordedifficulty 5 The difficulty setting for raiders. The higher the number, the higher the difficulty.
spawnbarbariansize 5 The minimum size (percentage) of a raider horde. By default, this is 5 (or 50%). If the game decides to spawn 10 raiders, by default only 5 will spawn.
maxBarbarianSize 80 The maximum total size of a raider horde.
dobarbariansbreakthroughwalls true Whether or not raiders can break, scale, and bridge obstacles.
averagenumberofnightsbetweenraids 14 The average number of nights between raids.
minimumnumberofnightsbetweenraids 10 The minimum number of nights between raids.
mobattackcitizens true By default mobs will attack citizens.
shouldraiderbreakdoors true Whether or not raiders can break through doors.
citizencallforhelp true By default, citizens will call for nearby guards if attacked
rangerdamagemult 1.0 Attack damage multiplier for Archer.
knightdamagemult 1.0 Attack damage multiplier for Knight.
guardhealthmult 1.0 Health multiplier for all Guards.
pvp_mode false Enabling this option turns on MineColonies PvP mode. Colonies can be destroyed and griefed under certain conditions, which can be set in the Enemies permission settings in the Town Hall. Note: PvP mode has not been fleshed out yet.
daysuntilpirateshipsdespawn 3 Days until the pirate ships despawn
maxyforbarbarians 200 Max Y level (height) for raiders to spawn.

Permission Configuration

Setting Default Description
enablecolonyprotection true By default, colony protection is on. This enables the Permission system in the Town Hall.
maxkeptbackups 50 Sets the maximum amount of backups kept.
turnoffexplosionsincolonies “DAMAGE_ENTITIES” By default, explosions within colony borders only affect players & citizens, not blocks. This can be changed to nothing, players, or everything.
specialpermgroup [“Raycoms”] Players who have special permissions to change citizen names (see “Name Changes” above).
freetointeractblocks [“dirt”, “0 0 0”] Blocks players should be able to interact with in any colony. You can list a type of block or specific locations.
secondsBetweenPermissionMessages 30 Seconds between each permission message.

Mod Compatibility Configuration

Setting Default Description
enabledmodtags (various) List of recognized and enabled tags.
configliststudyitems Paper, book Items consumed by citizens in the Library. The first value is item name, the second value is skillchance (between 100 and 1000), and the third value is breakchance (between 100 and 0).
configlistrecruitmentitems (various) Items requested by Tavern visitors. The first value is the item, the second value is the quantity.
luckyores (various) List of ore blocks rarely found magically by Miners (see “Ore Chance”). The first value is the block and the second value its chance.
enchanterexperiencemultiplier 2.0 Experience multiplier of the enchanter (how much more experience do they get from a citizen than they drain).
dynamictreeharvestsize 5 Forester harvest trunk size for dynamic trees
fishingroddurabilityadjustt2 6 Offset for the maximum durability unenchanted rod a T2 Fishing Hut can use, compared to iron tools (250). Thermal Foundation Iron requires +6. T3 huts can use unenchanted rods of any durability level, so long as they can take damage at all. Anything below -250 will only allow vanilla rods, except as allowed by T1.
fishingroddurabilityadjustt1 22 Offset for the maximum durability unenchanted rod a T1 Fishing Hut can use, compared to other wooden tools (59). Vanilla rods always work, but equivalents would need +6. Default value allows up to Thermal Foundation Silver Anything below -59 will only allow vanilla rods.
diseases (various) All diseases citizens can get. The name, how common it is, and all ingredients to cure it.
debuginventories false Enable inventory debugging.
auditcraftingtags false Generate crafting_audit.csv on loading recipes to verify tags.

Pathfinding Configuration

Setting Default Description
pathfindingdebugverbosity 0 Increasing this value makes longer pathfinding debug messages.
minimumrailstopath 8 The minimum number of consecutive rails to be detected as a path for a citizen to use.
pathfindingmaxthreadcount 2 Amount of additional threads to be used for pathfinding. Affects performance.

Request System Configuration

Setting Default Description
enabledebuglogging false Enabling this setting puts request system debug information in the debug.log
maximalretries 3 The maximum amount of tries that the request system will perform for retryable requests. Increasing this number increases server load.
delaybetweenretries 1200 The amount of ticks between retries of the request system for retryable requests. Decreasing this number increases server load.
creativeresolve false Enable only when debugging. The request system will creatively resolve (if possible) when the player is required to resolve a request.
canplayeruseresetcommand false Sets whether players can use the /mc colony requestsystem-reset command.

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