VikingColonies

A MineColonies-style colony for Valheim. Found a Town Hall, welcome settlers, house them in Longhouses and give them jobs. They build your village piece by piece, fell and replant trees, farm, forage, eat, sleep, shelter from raids and mend what monsters break — on their own, while you go adventuring.

What you get

• Town Hall — founds the colony; four settlers arrive. Its window (Shift+E) has four tabs: Citizens (everyone, their job and what they're doing, with Recall), the Saga (who came, who died, what got built), Work orders (every building and repair, what it waits for, Do first / Set aside, and what the colony still needs) and Keep in stock.
• Keep in stock — on every hut too: the items its chest keeps. Other settlers leave them, settlers with free time carry over what's missing, and a worker whose chest is full takes the load to another chest.
• Builder's Hut — a builder clears and flattens each new hut's site and puts up its building from real hammer pieces, fetching materials and tools from the colony's chests. With nothing to build, the builder mends damaged buildings and puts back pieces a troll or a fire broke. Hand over gives the builder what an order needs from your bag; Take down has them take a hut down.
• Lumberjack's Hut — a lumberjack fells the tree kinds you tick (leaving trees by your buildings standing), gathers the wood, replants the kinds you tick and rests when the colony has enough wood. Every worker learns a skill and works faster with it.
• Farm — a farmer works the fields you mark with field markers, each with its own crop and size (one per Farm level, as in MineColonies), and grows the crops you tick from the seeds in its chest, then harvests them: the colony's steady food. With PlantEverything the farmer plants berry bushes and mushrooms too, for their price.
• Forager's Hut — a forager brings home wild berries, mushrooms and herbs that grow back (never your crops).
• Longhouse — beds: each one a settler's home. With a free bed and food in the Town Hall a newcomer arrives each day.
• Free time — settlers with nothing to do sit on your benches and chairs, gather round a fire, chat in pairs and stroll; they greet you by name and make small talk about the colony (a death, the weather, a newcomer, their job).
• Mood — a home, a cosy bed, varied meals and an evening fire make settlers content and quicker; hunger, no home or a death make them unhappy and slower. Each says why (hover, or the Town Hall), and nobody joins an unhappy colony.
• Who they are — newcomers walk in from the edge of the colony, where nobody is looking; each settler is good at a trade, has a trait and a past, and dresses for the work. The Town Hall shows when an out-of-sight settler was last seen.
• The day — breakfast at the table, an evening round the colony's fire, sleeping in their own beds, and fires kept fed from the colony's wood.
• Daily life — a meal a day from the colony's chests (a hungry settler works slower); indoors at night and in raids with the door shut; a cairn with their things where a settler dies; the colony survives losing its Town Hall for a few days.
• Hut levels 1–5, following Valheim's eras: bigger work areas, better tools and bigger chests. With the game's devcommands on, vc_blueprint save makes your own building a hut's design.
• Help as you play — with the game's tutorials on, Hugin the raven explains each step the first time; and a settler who needs you says so above their head ("Needs 12 Wood", "Hungry").

Getting started

1. Build a workbench, then a Town Hall (20 Wood, 10 Stone) from the hammer's Misc tab. Four settlers arrive. Its chest is the colony's store: keep food in it.
2. Build a Builder's Hut inside the colony's rings. Give the builder Wood, some Stone, a flint axe, an antler pickaxe and a hoe in a colony chest (the builder works with copies; your tools stay).
3. Place a Lumberjack's Hut, a Forager's Hut or a Farm: the builder puts it up, then a settler starts work there. A Longhouse's beds become your settlers' homes.
4. Shift+E on any colony building shows what it does and what it needs.

Multiplayer

Everyone on a server needs the mod and Jötunn; the server must not use crossplay. Works on dedicated servers. A colony is managed by the player who built its Town Hall and the friends they put on a ward (Guard stone) covering the huts. Settlers only work while someone is near them, as everything in Valheim.

Settings

Every number (costs, work areas, carry sizes, hunger, newcomers…) is in the config file BepInEx/config/daalmyte.vikingcolonies.cfg, or in-game with a configuration manager. Server settings are synced to players, building costs included (a changed cost counts at once).

Works with other mods

Tested together with PlantEverything, PlantEasily, Seasonality, PlanBuild, EpicLoot and Monstrum (with Warfare): the whole self-test passes with them installed, with no errors and no clashing patches. Trees and bushes that PlantEverything makes plantable are cleared from a building site like any wild plant. Crops a mod adds to the Cultivator show up on a Farm's What to grow list, and PlantEverything's berry bushes, mushrooms, thistle and dandelions are on it too (unticked until you tick them).

Bugs, feedback and the player guide

github.com/DaAlmyte/VikingColonies-issues: report a bug, share feedback or an idea, and read the full player guide (every building, job and setting).

To report a bug, stand near the settler or building with the trouble, open the console (F5; it needs the -console launch option) and type vc_bugreport (no cheats needed). It writes BepInEx/VikingColonies-bugreport.txt in your mod manager profile: attach it to your report with BepInEx/LogOutput.log.

Before you remove the mod

Without VikingColonies, the Town Hall's and huts' chests (and what's in them), the settlers and their cairns disappear from your world; they come back if you install it again. To keep those items for good, take them out of the colony's chests first. The buildings the builder put up are ordinary Valheim pieces and stay.

Requirements

• BepInExPack Valheim
• Jötunn

Changes

See the changelog tab.

Licence

MIT: free to use, change and share, with credit.