Kukolony

A villager colony system for Valheim. Place a hearth, hire villagers, register your chests and hand out jobs - they haul your goods and gather wood, stone and ore while you get on with the game, and gather round the fire when the work is done.

This is the free edition. What Patreon supporters are testing now is in Work in progress - early access on Patreon - https://patreon.com/KuchukboromDebbarma286

---

What's new

0.7.2

• Villagers get where they are going. No more standing still beside railings, posts, stair edges and short walls, or hopping nothing near a bench or a fire; they open any door in their way (and shut it behind).
• Limits on the job card - each Gather line shows have / [limit] with −/+ right there, the same limit as Items → Limits.
• Filters when choosing items - Gather by how and biome, and the others where they have them.
• Haul: Move what is over the limit to the overflow; filing out of the overflow stops at each limit.
• No chest stores it - Items → Categories names a category no chest is marked for.
• Better gear and materials from the overflow at a hearth on a raised floor.
• Watching a villager is smooth from any distance.
• Settings: Keep working when the server is empty (KeepAliveWhenEmpty).
• Also in work in progress on Patreon: Cooking is part of Make, Herd's list.
• Update the server and every player together.

Earlier releases are in CHANGELOG.md.

Contents

1. What's new
2. Requirements and install
3. Quick start
4. Keys
5. The Kolony
6. Villagers
7. Structures and their settings
8. History
9. Waiting on
10. Stock
11. Item categories
12. Jobs
13. Work lists and turns
14. Work in progress - early access on Patreon
15. The map
16. Off-screen simulation
17. Multiplayer
18. Settings
19. Console commands
20. Good to know
21. Credits

---

Requirements and install

• BepInEx (denikson-BepInExPack_Valheim) and Jötunn — both are listed as dependencies, so a mod manager fetches them for you.
• Every player needs the mod, and so does a dedicated server. On a server, the server runs every villager; alone or hosting, your game does.
• Optional: PlanBuild. If it is installed, villagers can build your blueprints (see Plan Totems). Nothing is needed if it is not.

Manual install: drop the Kukolony folder into BepInEx/plugins/. The config is written to BepInEx/config/com.kuku.kukolony.cfg on first launch, and every setting in it can also be changed in game (see Settings).

---

Quick start

1. Build a Kolony Hearth (in the hammer's build menu — 10 wood, 10 stone). It is the colony's record: its name, its people, its structures, its jobs. It starts with a random name; rename it on the panel's Home page.
2. Press [ (the Kolony key) to open the Kolony panel on the nearest hearth (with more than one base, the name at the top opens a list to switch, and the key opens that one from then on).
3. Hire a villager — Villagers → Hire. It costs coins (50 by default), arrives with a name and nothing else, and feeds and dresses itself from your chests.
4. Register a chest. Look at a chest inside the hearth's reach and press Ctrl + \, or use Structures → + Register for everything nearby. Set what it holds: Anything, Only these (Food, Wood…) or All except.
5. Put food in a registered chest. Villagers eat from registered storage and starve without it. Put a bed in reach, register it, and give it a sleeper.
6. The jobs are already there. Every Kolony starts with one job of each kind — Gather (wood and stone), Haul, Farm, Tend, Make, Herd, Repair — with sensible defaults. Open Jobs to adjust one, or add a second of a kind pointed somewhere else.
7. Give the villager its work — its card's Work tab, + Add job, and tick the jobs in the order they matter (▲ ▼ reorder them). Or pick several villagers on the list (tick their rows, or Space; Ctrl + A for all shown) and add work to all of them at once, or open a job and + Add villagers.
8. Watch it work. Hover a villager to see what it is doing; press Watch (or W) on its card to follow it with the camera.
9. Grow from there: register a kiln and a smelter and list what they make on Tend; a bench or a cooking station and list what to make or cook on Make; an axe or a pickaxe in a chest and list ores on Gather; a Kolony Field and list crops on Farm.
10. Take someone along. Walk up to a villager and press Use: it follows you.

---

Keys

Every key below is configurable. The four mod keys are ignored while you are typing in chat, the console or a text box.

Key	What it does
[	Open the Kolony panel on the Kolony you last chose (else the nearest), where you left it. Press again to close.
]	Open Parties, on the party that is out with you. Press again to close.
\	Open what you are looking at: a structure's card, a villager's card, a hearth's Home - or, for a piece not yet registered, the list of what could be.
Shift + \	Toggle floating marks over every registered structure.
Ctrl + \	Register what you are looking at to your Kolony that reaches it, and open its card.
Ctrl + Shift + \	Start picking several structures of one kind; press it again to finish and change them together. While picking, \ picks or unpicks what you look at, and a card on screen lists the picks.
Use on a villager	Follow me / stop following.
Crouch + Use on a villager (Ctrl + E by default)	Trade: give and take items.
Alt place + Use on a villager (Shift + E by default)	Open its card.
Use on a hearth	Says which key manages it.
Use on a Kolony Flag	Opens the flag's card: name, reach, which Kolony it works for.
Use on a Kolony Field	Opens its card in the panel.
In watch mode: Tab / Shift+Tab	Next / previous villager.
In watch mode: E	Open the watched villager's card.
In watch mode: Esc	Stop watching.

Hovering a villager shows only the keys that will actually work on it — a villager of another Kolony says "Answers to X, not to you" instead. The same goes for chests, stations, benches and beds: the key is offered only when it would open something.

In the panel:

Key	What it does
1–9, Ctrl + Tab / Ctrl + Shift + Tab, Ctrl + PageUp / PageDown	Switch section (next / previous)
↑ ↓	Move the selection (the right side follows; turns the page at the end)
Enter or →	Into the chosen thing
←	Back to the list
PageUp / PageDown, Home / End	Turn the page; first / last item
Tab / Shift + Tab	Next / previous control
Space	Pick the highlighted row (Villagers, Structures) - several picked are changed together
Ctrl + A	Pick every row shown (again to unpick them)
← → on a choice, slider or number	Change it (Shift for ten at a time)
/ or Ctrl + F	Search
F1	Says the focused control's tooltip
Ctrl + N	The section's + (hire, new job, register…)
F2	Rename (a structure)
W	Watch the villager
Ctrl + Z	Undo the last change (for 10 seconds)
Esc	Back: closes a dialog, leaves a text box, closes a sub-page, returns to the list, goes to Home, then closes

---

The Kolony

A Kolony is your settlement as a whole; each Kolony Hearth you place is one base of it.

The Kolony keeps, the same from every base:

• a name (random at first, editable on the panel's Home page — it colours every pin the Kolony owns on the map);
• its villagers, its jobs, its parties, its fallen and its history;
• its members: the players it belongs to, all equal. Whoever places the first hearth founds the Kolony; a hearth placed by a member becomes another base of it. A player belongs to at most one Kolony.

Members. Open Home and choose Members to see who belongs. + Invite asks a player who is in the world; they get a line on their screen, press the Kolony key and accept or decline on the card it opens. Any member can remove a member or leave. To everyone who is not a member a Kolony is closed: its villagers are seen in the world and nothing more - no panel, no map pins, no trading, recruiting or registering its pieces. An admin (or the host) can join any Kolony without an invitation: stand at its hearth and type kukolony_claim in the console. Use it for a Kolony left with no members, or to rejoin your own after changing character - a member is a character, not an account.

Bases. Home's Bases list shows each hearth of the Kolony: who lives there, how far it is, a name of its own, and a button that switches the panel to it. The panel's header switches too.

Each base keeps for itself:

• a reach: a circle (96 m by default, settable up to a ceiling) in which structures can be registered and work happens, widened by the work flags assigned to it;
• its registered structures and its stock list (Copy from on the Items page copies another base's).

A villager lives at one base — its home base — and sleeps, stores and draws from there; it never walks to another base's chests. Change it on the villager's card. A job pointed at a flag or a field is worked by the villagers who live at that flag's base.

Losing a base closes it: its structures are let go and its villagers move to the nearest base left. Only losing the last hearth ends the Kolony.

How many Kolonies a world may hold is MaxKolonies (0 for no limit), set in the config file. The free edition keeps one Kolony per world; a world with more keeps the oldest working and the others resting. Both limit Kolonies, not bases. A hearth cannot be placed on ground another Kolony already reaches.

Losing a Kolony's last hearth starts a cooldown (one real minute by default) before a new Kolony can be founded. By default any loss counts, including an enemy levelling it; CooldownOnAnyLoss off counts only your own removal.

The Kolony panel

The front door to everything. Sections along the top, each a list on the left and the chosen thing on the right; each remembers where you were.

• Home — three tabs. Attention: what needs it, worst first: Starving, Down, Waiting on (one line per thing they wait on), Stuck, No work, No bed, structures not found, jobs nobody runs, and last anything held in the overflow. Choose one to see who it is about and Show them to open that list already filtered. Bases and Members list those. On the right, the Kolony's card: its name, its numbers (each a link), parties out on their own, this base's structures, stock limits and reach, what you are looking at (Register or Open), what is nearby and unregistered, and its History. What the Kolony did the day before comes as a few lines each morning (MorningReport).
• [ with no Kolony yet opens a start card that explains how to found one and shows any invitations waiting for you.
• Villagers, Jobs, Structures, Items (stock, what is in the chests, categories, overflow), Parties, History, World, Settings — below.
• With more than one base, the name at the top (Name ▾) opens a list to switch between them. A base far away is shown as from afar: the server's copy, and changes are sent to it.
• Choosing items - for a chest, a station, a stock line, a gear slot, a route - opens a picker with a search and up to three more lists along the top: what the page itself offers (Stored, Known), Kolony (everything in every base's registered chests and the overflow, with how much is where) and Carrying (your bag). Each shows only what that picker takes, and only when there is some; the list you used last is the one it opens on next time.
• The line at the bottom says what the last action did; … opens the last 20. Changes that go to the server show sending… until they land.

Hover the hearth for its name, headcount, structure count and the manage key.

---

Villagers

Hiring, naming, dismissing

• Hire on the Villagers list hires one. It costs NewVillagerCost coins (50; 0 makes them free).
• Every villager has a name and its own appearance. Rename it in the Name box on its card's Overview tab.
• Dismiss (on its card, asks first) drops whatever it carries and wears where it stands and lets it go; the hire is not refunded.
• The list filters with Show (All, Working, Stuck, No work, Starving, No bed, In a party, Fallen). Pick several (tick boxes, Space, Ctrl + A) and one page adds jobs to all their work lists (Add to N work lists), replaces them (Replace N, asks first), or sets one Stance for all.
• A villager's card has tabs: Overview (name, Sleeps in, Home base, comfort and more), Work, Gear, Bag, Skills and History.
• Send home returns a party member to its Kolony.

Food

Villagers eat from your registered chests. Food is worth its own burn time from the game's data, so a cooked meal keeps a villager going longer than a raw one. They eat when they run low (HungryBelowSeconds), and sit down on a nearby seat to do it when there is one (never a boat's - a moored boat is not a dining room).

• A working villager burns food at FoodDrainRate × real time (0.5 = a meal lasts twice its own duration). Idle villagers barely eat.
• Hunger only advances while the villager is loaded and ticking — a settlement you walk away from does not starve behind your back, and the step is capped after a long gap.
• Starving shows red on the hover and at the top of the panel's Home. Whether it actually kills is StarvingKills (off by default).

Energy and rest

Every action costs energy (EnergyPerAction). Below TiredBelow a villager stops work and goes to rest; it resumes at RestedAbove. Rest is triggered by energy, never by nightfall — a settlement works in shifts.

Recovery is in in-game hours, so it scales with the day length:

Where it rests	Exhausted → rested
Its own bed (register a bed, set Sleeps here)	4 hours
At the hearth, no bed	10 hours
Where it stands	20 hours

Comfort makes those hours shorter. Those figures are what a rest costs at comfort 1 — bare ground. A villager sleeping somewhere comfortable recovers faster, in Valheim's own proportion: comfort 7 rests it at 2.2x the rate, so a 4-hour bed becomes a bit under 2 hours. It is the same arithmetic as your own rested buff, which means the furniture you already build for yourself works for your villagers without you learning a second system.

One rule catches people out, and it is vanilla's: furniture counts for nothing without a roof. An unroofed bed surrounded by chairs, banners and a fire is worth exactly as much as the floor. The villager's Comfort row says so in yellow when that is what is wrong.

The Comfort row on a villager's card names the level, what is around its bed, and how much faster it rests there. It is missing when the bed's part of the world is not loaded — that is "nobody is near enough to look", not "the bed is bare". Turn the whole thing off with ComfortMatters and the hours above are the hours, wherever a villager lies down.

Skills

Villagers get better at what they do. Nine skills, each levelling from their own work: Woodcutting (each blow), Mining, Foraging, Farming (sowing and harvesting), Hauling (putting things away), Cooking, Crafting, Hunting (bow hits) and Fighting. Each level costs more than the last (SkillXpBase × (level+1)^SkillXpExponent, up to SkillLevelCap, 100), learned five times over by default (SkillXpRate), so the early levels come quickly and mastery still takes a long life. A death costs nothing.

• Skilled villagers work better, up to four times as well at the cap (SkillWorkBonusAtCap, 3):
  • Woodcutting and Mining: a novice is slow (ChopSwingSeconds, MineSwingSeconds, 4 s a blow); a master swings four times as often.
  • Foraging and Farming: quicker hands, and a chance of an extra pick.
  • Hauling: a skilled hauler scoops up more of the same thing lying close by with each pickup, up to HaulScoopAtCap (10) more at the cap.
  • Cooking and Crafting: quicker loading of stations and faster crafting; a chance of an extra helping off the cooking station.
  • Hunting: shoots from further (HuntRangeBonusAtCap, 80% further at the cap), draws faster and aims truer - the game's own archery reads the villager's skill as it does a player's - and hits harder.
  • Fighting: hits harder and swings more often, blocks better and tires less. It grows from every blow landed and every blow taken in a fight.
• Teach with trophies. On a villager's Skills tab, Teach next to a skill lets you hand over a trophy from your pack. It is used up and the villager learns from it: a little from a Meadows trophy, much more from each biome further on, and a great deal from a boss's (TrophyXpTier1–7, TrophyXpBoss).

Health, death and revival

A villager's health grows as it gets stronger. It starts at VillagerMaxHealth (50) and is multiplied by the armour it wears, the last meal it ate (while it is fed) and its overall skill (every skill's level added up) — so a veteran in good armour on a good meal takes an enemy ages to bring down. Healing grows the same way. The Skills tab spells both out, for example 620 = 50 × armour 2.4 × food 1.6 × skill 3.2. Every factor is a setting (HealthPerArmour, HealthPerFood, HealthPerSkillLevel, and the RegenPer… three), and HealthCap (100,000) and RegenCap (50×) are the ceilings.

• Villagers have a real health pool (VillagerMaxHealth, 50) and heal while fed (HealFullSeconds; 0 uses the creature's own rate).
• Death costs nothing. Its bag and gear locker go into the Kolony's ledger with it — nothing is dropped where it fell, however far from home. The death is announced, to the player it was following too.
• A fallen villager comes back at its bed after ReviveSeconds (one minute of world time, which only runs while the game does), carrying everything it had, and still in its party. A villager without a bed wakes at the hearth.

Gear

Every villager has a gear locker separate from its bag: armour slots (head, chest, legs, cape, utility) and racks for weapons, shields, torches and tools. The bag is for cargo only.

• They dress themselves. New villagers arrive naked and shop your registered chests for the best piece per slot - when idle, and after every job, at most once a minute, at home. With combat on that includes one melee weapon and one ranged weapon (bow, crossbow or staff) - the best of each - and the gear row says bow when one is missing. Neither is ever put back as spare, so an axe kept as the melee weapon beside a bow stays. Outclassed pieces go back to storage for the next villager.
• The right hands at the right time. The job's tool while working, weapon and shield in a fight, a torch at night — one owner of the hands at a time.
• A villager never takes the settlement's last tool. A spare axe or pickaxe in a chest is shopped; the only one is left for you.
• Gear presets. Every job, every party and every party member can have one: per slot (melee, ranged, shield, helmet, chest, legs, cape, utility, tool), Automatic — the best they can find — or one particular item. A named item is fetched from your chests and used before anything "better". At home the preset of the job being worked applies; in a party, the member's own or the party's. A villager whose locker is full says so.
• Gear on the villager's card shows it all, grouped, with Give and Take. Give gear hands over a piece from your inventory.

Getting around

• Doors: a villager opens a closed door or gate in its way as it comes to it - any door but one that needs a key - and closes it behind itself a few seconds later (DoorCloseBehindSeconds) — only doors it opened, only when nobody stands in the doorway; one left open stays open.
• Jumps: a hop over a knee-high lip (never into a beam overhead), and a deliberate step down when stranded above where it is going.
• Headroom: a stroll, a work spot or the place a villager stands to reach something is picked only where a villager fits standing - never the low space under a raised floor or a stilt deck.
• Stuck detection: a villager making no progress toward its destination for StuckGiveUpSeconds gives up and tries something else, and refuses that target for a while rather than walking the same impossible route again.
• Small talk: villagers exchange a few words when they pass and greet a player who comes near. Rare on purpose.
• Villagers with nothing to do go home and pass the time: two to five gather in a ring by a lit fire (or the hearth), chatting and laughing; at night they warm by the fire; some sit on a bench or the grass, some stroll. They look at their work again every 20 seconds, and real work pulls them away at once. Their words are seen by every player, not only on the machine running them.
• Emotes: now and then a villager shrugs or stretches while idle, waves or bows to you, laughs in small talk, and cheers a kill or something it made. Everyone sees them. Rare on purpose (VillagerEmotes, EmoteMinSeconds).

Where things are stored

Among chests your filters treat alike, one chest fills before the next. Each chest belongs to the place it stands nearest - the hearth or a work-area flag - and villagers use the chests of the place nearest them, always in the same order: nearest the hearth or flag first. The first chest in that order with room takes the item, whatever it already holds, and whoever is filing from wherever. Taking things out empties the last-filled chest first, so the front ones stay full. When goods end up behind anyway - several haulers at once, a chest that was open or out of reach, room made by something taken out - a haul job set to Tidy chests (or Both) moves them into the earliest chest of that place with room, so chests pack from the front. Contents are read even from chests nobody is near, so an item with nowhere to go is left where it is rather than carried to a full chest.

A bag holds only what it is for: what a hauler, tender or cook is delivering, its gear waiting for the locker, what it is mending with, and a little food. Anything else — a hunter's loot, a crafted item, the end of an interrupted haul, spare food — is filed by the villager itself, nearest chest first: at a break between jobs, once three-quarters of its bag is used, or after five minutes. When no chest has room for something - every chest is full, or none takes that item - the villager hands it to the Kolony's overflow. It is listed under Items, Overflow, a line per item with how many; plain goods have no limit, and gear is kept piece by piece up to OverflowGearCap (beyond it, a piece is left on the ground beside the chest it belongs in). What is held is not used by any villager. Move on a line (or Move all to storage at the top) files it into the chests of any base that have room, and the Kolony tries by itself every OverflowAutoMoveMinutes. Select a line to Take out as many as you choose (a slider, or All) - into your bag, at your feet what does not fit - Move to storage, or Delete them for good (press twice). A villager never takes a chest back from a player who has it open.

Watching a villager

Watch on a villager's card follows it with the camera and shows a live card: what it is doing, its job, which step of the job it is on (or which reflex has it — resting, eating, fighting), what comes next on its list and how long the current turn has left, energy, food, health, stance, what it carries, where it is going, and its home. Tab cycles villagers, E opens the watched one's card, Esc returns.

Watching works at any range, including from a dedicated server: the ground the camera is pointed at is loaded while you look at it and let go when you stop, so a villager fighting a greydwarf two hundred metres out is a fight you can see rather than a person on an empty hillside. Your own character stays where you left it and nothing about what the world simulates changes. If the one you are watching dies, the camera comes back on its own.

The hover

Look at any villager: name and Kolony, what it is doing (with a diagnosis when it is getting nowhere — "no axe in any chest"), energy and food (red when starving), how kitted it is, and the keys that will work on it.

Structures and their settings

Only placed, networked build pieces inside a Kolony's reach (the hearth's circle or any of its flags) can be registered. Loose items and creatures cannot. A registered record stays visible if its object is destroyed or moves out of reach; it is marked and cannot be worked until you remove or repair it.

Registering:

• Look at a piece and press Ctrl + \ - or open the panel: the Home card offers Register for what you are looking at.
• Or Structures → + Register (the Nearby, not registered filter): everything in reach that could be registered, searchable, each with a Register button and what it would become.
• Press \ while looking at a registered piece to jump straight to its card.

The Structures list's Show filters by role (Storage, Tending, Crafting, Beds, Fields, Flags), by Problems (not found, out of reach), by Paused, or Nearby, not registered; Ctrl + N opens + Register.

Changing several at once. Pick structures of one kind - chests with chests, stations with stations - and one page sets them all: in use or paused; for storage what they hold (Only these / All except lists), whether villagers may take from them and whether they take unclaimed things; for stations who works them, keeping each in its own fuel and when, what to feed them (each gets only what it takes), what to carry and how full to keep them; for benches mending. Storage shares are set for all of them too (count Limits stay per chest). Beds, fields and flags share only in use / paused. Up to 64 at once.

• On the list: tick the box on each row, or Space on the highlighted row; Ctrl + A picks every row shown (filter to Storage first to pick every chest).
• Out in the world: Ctrl + Shift + \ starts picking - a card on the left lists what is picked - then \ on each structure picks or unpicks it. Ctrl + Shift + \ again finishes and opens the page for all of them.

Every structure's card has a tab for each role it plays, and About: its name, what it is used as, and Unregister (asks in a dialog; the piece stays standing; works from anywhere). A Paused switch at the top of every tab stops villagers using it without forgetting how it was set up.

Storage (chests and anything with an inventory)

• Holds: Anything, Only these categories, or All except these categories — chests take categories only, never single items. Villagers file matching things here and carry mismatches elsewhere. Both lists are kept when you switch; the one not in use is shown dimmed.
• What no chest takes, or no chest has room for, goes to the Kolony's overflow - hauling never leaves it lying. The overflow says what to do about each item (see Items, Overflow).

Bed

• Sleeps here: which villager (or nobody). A bed cuts rest from 10 hours to 4.

Plan Totems

With PlanBuild installed, a Plan Totem registers as a station this mod knows how to work: a tending villager asks it what the plan is still short of and carries exactly that, trip after trip, until the building is up. Drop a blueprint, register the totem, walk away.

Marks

Shift + \ floats a mark over every registered structure, so you can tell the Kolony's chests from everyone else's at a glance.

---

History

History shows what the Kolony did, one in-game day at a time, for the last seven days - the days on the left, the chosen day on the right:

• A line of the day's big numbers — collected, put away, used, made, eaten, jobs done.
• Collected (picked up), Harvested, Put away, Taken from storage, Used up (craft materials, fuel, ore, cooking ingredients, seeds), Made (crafted and cooked) and Eaten — each with its biggest entries and All › for the rest.
• By item (the By activity / By item switch at the top of a day) — one line per item: everything done with it that day, and what your chests gained or lost. Nine ore taken out of a chest and smelted show as one line ("taken from storage 9, used up 9", chests −9), not as nine under each of two headings.
• Work done — each villager and the jobs it finished, how many times; › shows that villager's own day. A villager's card has its own history too.
• What happened — deaths, revivals, hires, members joining or leaving, expeditions setting out, skill level-ups and new bases.

It is counted where the villagers run and kept with the Kolony, so every player sees the same history, from anywhere. Each section shows its six biggest entries before All ›; a day keeps up to 60 per section and a villager's page eight, and anything past that is counted under Other things, so the totals stay true.

The morning report. When you join a world, and each morning after, a few lines in the corner say what your Kolony did the day before — the totals, the biggest things put away, the hardest worker, and who fell or came back. A day the Kolony did nothing says nothing. Switch it off with MorningReport.

---

Waiting on

When villagers run out of things to do, the panel's Home lists what they are waiting on: every reason once, the most serious and then the commonest at the top: Repair: no hammer, Make: none of the 8 foods it takes in any chest, Gather: it is outside where this job works (3659). Select one for how many are waiting on it and who.

It is the settlement's shopping list. The line disappears on its own as they find work again.

Stock

Each base has its own list (Items → Stock; + Limit adds a line, Copy from › replaces this base's list with another base's). Per item:

• Stop at - every job stops at this many: choppers, miners, foragers and hunters leave what would bring more, stations stop taking what makes it, benches stop making it, and haulers leave it lying once the chests hold that many. Stop at 5000 Wood is set once, not on every job. Counted as what is stored, what is being made and what lies about the Kolony.
• Keep back - villagers never take the store below this many, so keep back 2 Bronze Axe leaves them the third and never the last two. It holds everywhere a villager spends the stock: tools, weapons, gear, food, crafting materials, and fuel - keep some Wood back so a cold night does not empty the woodshed.
• Repeat (once Stop at is set) - Keep this many, or Make them once and stop.

A crafting bench still says what it makes and in which order; how many comes from here, and an item with no limit is not made. Older per-job and per-station limits were moved onto the list the first time the server started with this version.

Each row shows what the base holds against its Stop at as a bar ("keep N" when only keep back is set), so the rule can be checked at a glance. An item's page also lists Made at: the benches and stations that make it. Clear limit removes the line (asks twice, undoable).

Items → Limits is the one place limits are set, per base: every item the base has - its chests, its villagers' bags (not the gear they wear), out with a party or not, and the Kolony's overflow - and every item with a limit, each as have / limit or no limit, with the limit typed right on the line. Show All, At limit, Below limit or No limit; hover a line for where the count comes from. Craft orders, stations, jobs and fields only show the limit and open it here.

Items has three more views: In chests (what each base holds, all hearths together or one in focus), Categories (below) and Overflow - what no chest takes or has room for. Each overflow line says what to do: in no category (Add to a category ›), no chest takes it (Give a chest › adds its category to a chest you pick), its chests are full, or Move to file it now. Villagers also fetch from the overflow when no chest has what they need, walking to the nearest hearth to take it.

Item categories

Categories are yours alone: none come built in, and any can be deleted. **Items → Categories →

• New** makes one; Change › on its card sets what it holds (an item may be in several). Each category's page says which chests and jobs name it (Named by); deleting one takes it off every chest and job that named it. An item in no category goes only into chests that take Anything - otherwise to the overflow. Wherever such an item is listed - the overflow, Limits, the Kolony's chests, an item's card, a chest's card (In this chest, in no category) and the Categories list (Held, but in no category) - Add to a category › (or + Category) puts it in one, or makes the category on the spot. Saved in their own file beside the config (com.kuku.kukolony.categories.cfg); on a server the host's is used.

• Chests take categories; jobs' Which items and Never handles take categories and single items.
• A category with items that no registered chest is marked to store (named on its Only these list) reads no chest stores it in the Categories list; its card says so, with Give a chest ›. Its items still go to a chest that takes Anything, or the overflow - the label is only a reminder.

---

Jobs

A job is named work a Kolony owns; a villager runs a queue of them. Every job has:

• Name.
• Repeats (1-50): how many rounds before the queue advances.
• Places (Change ›, Where it works): the Kolony (its hearth's radius), and/or any of its flags, in the order you choose — the job works the first place with anything to do and moves on when that place is done. Reach (shown once a place is named) overrides each place's own; Use each place's own puts it back.
• Walking past: when villagers report work outside its places, a note says so, and Work everywhere points the job at every place at once.
• Gear (Change ›): a gear preset for whoever works it.
• Each line's limit, on the line: Gather, Make, Tend and Farm show what the Kolony has against its limit
  • 21 / [20] - and −/+ change that limit right there: the same limit as Items → Limits, for every job. 0 is no limit (made or gathered without end). Herd's lines show how many to keep instead.
• Choosing items: Change items › lists what the job can take on; a long list has filters over it - Make by station and kind (Forge, then Weapons), Gather by how (Mine, Chop, Pick, Hunt) and biome, Tend by station, Farm by biome - each with how many it holds.
• Stops at (Stock ›) on Farm and Tend; Set up on (Stations ›) on Farm. Every job judges a limit by what its work gives - a deer by its meat and hide, a seed by its crop, an ore by its bar - and stops once all of that is met.
• Who runs this: the villagers who have it, as names; ✕ takes it off one (undoable) and + Add villagers puts it on the end of theirs.
• Delete job (asks twice, undoable).

The Jobs list's Show filters by kind, or Nobody runs.

Two kinds, chosen from + New job: Haul and Gather. The rest are work in progress on Patreon (see Work in progress).

Haul

Loose items on the ground go to the chests that take them, and chests are kept sorted. Which items and Never handles filter by item or category. What to do picks the work: Pick up (the ground and crafters' bags), Tidy chests (moves mismatched contents between registered chests - wood from the overflow chest into the one that names Wood) or Both, one chest trip after every delivery from the ground, so chests are sorted even while the floor never clears; Fill the bag before delivering makes a round trip worth the walk. With tidying on, Move what is over the limit to the overflow carries what the chests hold of an item above its Limit (Items → Limits) to the overflow at the hearth - 200 Deer Soup with a limit of 20 leaves 20 in the chests - and the overflow - its automatic filing and Move alike - files it back only as the chests run below the limit (the item reads at its limit). A villager never re-takes what it just put down. Haulers take what matters first: anything about to vanish (dropped items the game would delete within the hour), then what a smelter, bench or kitchen is waiting on, then the pile worth the walk - and two haulers never race for the last room in the same chest.

Hauling takes everything its filter allows - a stock limit stops gathering and making, never hauling, so nothing is left lying; what no chest takes or has room for goes to the overflow.

Hauling no longer picks: berries, mushrooms and the like are a Gather job's items. A Haul job that foraged in an older save hands its picking to a Gather job of its own, named after it (Haul - picking), placed next to it in every villager's list - nothing that used to be picked stops.

Gather

Say what you want; it works out how. A Gather job is a list of items — Wood, Copper Ore, Raspberries, Raw Meat — chosen from everything the world gives. Each line says how it is got: Mine - Iron Pickaxe or better, Chop - Bronze Axe or better, Forage - by hand, Hunt. Nothing listed: nothing to do. Mine, Chop, Forage and Hunt are no longer jobs of their own; an older save's Mine, Chop and Hunt jobs are Gather jobs now, with the items they gathered (every ore, every wood its trees give, every animal's item).

Mining, in every land. A vein, a deposit or a crypt's scrap pile is mined from scratch - the villager fetches the pickaxe it needs (iron for silver), breaks it, then works the pieces. A vein under the ground is dug to first, a few digs at most and never beside anything you built. Rock of the Mistlands (giant bones: soft tissue, black marble), the Ashlands and the Deep North is mined when a line asks for what it gives; ruins, walls and furniture never are. In a crypt or cave, villagers following you work what is in there with you - on your floor only - and never wander into one on their own.

• Limits steer it. Each line shows the Kolony's limit for its item (40 / [200], set right there) — an item at its limit reads enough and gets nobody until stock drops. No limit: gathered until storage and the overflow are full.
• The crew spreads out. Villagers on the job go evenly over the items that have work; when hands are short, the item furthest below its limit comes first. A villager keeps its item until it runs out nearby, reaches its limit, or it lacks the tool - so nobody swaps axe for pickaxe all day. The card shows who is on what (Copper Ore ×2 · Wood ×1).
• Where: the job's places, in your order, as for every job; an item none of them has reads none in this job's areas and is asked again after a few minutes (things grow back) or when you change the places.
• Tools per item. A copper line takes a pickaxe good enough for copper, a fine-wood line a bronze axe; each is fetched from the chests when the line is chosen, and a villager keeps every tool its job's items take, so moving from copper to wood is a swap in hand. An item nobody can work says so: needs an Iron Pickaxe - none in the Kolony. The better-tool swap at the start of a turn works as before.
• Leave nothing on the ground (ticked by default): everything that falls from what they break, fell, pick or kill is picked up - not just the items listed (copper also gives stone, a pine wood and resin)
  • and goes in a chest that takes it, or the overflow. Unticked, they pick up only the listed items and the rest waits for a Haul job.
• Also hunt (shown with combat on): items only animals give are got by hunting them, with the job's gear and each villager's stance. A hunter fetches a bow, shoots game from HuntShotDistance (25 m), roams the job's places for game and gives up on prey it cannot catch after twenty seconds; game comes alive and slowly breeds round a working hunter (HuntLoadsWildlife, HuntSpawnEnabled, HuntSpawnCap, HuntSpawnSeconds). Unticked, those lines say so and are skipped.
• Also clear stumps, bushes and loose rock (off by default): those are broken too whenever they give a listed item. Off, wood comes from trees and logs, stone and ore from veins and deposits. Logs are cut up before new trees are felled.
• Leave standing (with a chopped item): never fells the last that many trees of a place.
• What they are on shows everywhere: the villager list (Gather · Copper Ore), the card's Gathering row and the hover (Copper Ore - mining).

Work lists and turns

A villager's Work tab is its list of jobs, in order — Haul, Make, Gather — and the order is the priority. + Add job opens a picker over the Kolony's jobs: what is chosen shows as numbered chips in order, to move or remove; each row on the tab has ▲ ▼, Edit › and ✕. The list holds job identities, so editing a job on the Jobs page changes it for everyone running it.

Pick several villagers on the list (tick boxes, Space, Ctrl + A) to give them work together: Choose… the jobs, then Add to N work lists keeps what each already has, Replace N swaps the whole list (asks twice, or in a dialog when some are too far away to undo). Every Kolony starts with one job of each kind, so there is always something to pick from.

The list loops and runs by these rules:

• Every result that ends a tick spends one attempt: a finished trip, a failed one, and nothing to do alike. When the job's repeats are spent, the next job starts. With the base jobs at repeat 1, a job that cannot start hands over at once.
• A job that keeps reporting progress but finishes nothing for two turns while standing still is handed over (one walking to far-off work is not), and a job that breaks counts as a failed attempt. Nothing holds a villager for ever.
• Turns: one entry keeps a villager about PresetTurnSeconds (two minutes; 0 = off) - it hands over at the next finished piece once the turn is up, never mid-trip - so a list actually rotates even when the first job never runs out of work.
• A full lap where nothing was possible pauses four seconds rather than spinning.

The watch card shows the current step, what comes next, and how long the turn has left.

---

---

---

Work in progress - early access on Patreon

Patreon supporters are testing these now; in the free panel each is shown, marked WIP, and asking about it says what it is. https://patreon.com/KuchukboromDebbarma286

• Farm - villagers sow, tend and reap your Kolony Fields.
• Repair - villagers mend worn walls, roofs and stations with a hammer.
• Tend - smelters, kilns, windmills, spinning wheels and fires kept fuelled and emptied; honey and sap.
• Make - crafting at the benches and the cauldron, cooking at grills and ovens, mending worn gear and upgrading it.
• Herd - tamed animals fed, eggs collected, herds kept at the size you choose.
• Parties - take villagers adventuring, give them roles, send them out on routes.
• Boats - villagers sail with you, crew and steer, follow lanes and moorings.
• Combat - villagers fight beside you, defend the settlement and hunt.
• Work flags - claim ground far from the hearth and send jobs there.
• Many Kolonies - more than one Kolony in a world.

---

The map

• Every settlement has a pin with its name and population; every villager has one labelled with what it is doing, updated as it moves, even when unloaded. Clicking either opens it.
• Work flags a job points at are pinned, named after the job.
• Icon says what a thing is; colour says whose it is: every pin a settlement owns shares one colour hashed from its name.
• These pins are never written to your save, and only a Kolony's members see them.
• A party out on its own has a pin where it is, its zone drawn as a circle and its route as a line. Click the pin for its card.
• What a party finds is pinned as a pin of your own, saved like one you placed.

---

Off-screen simulation

The colony keeps working when nobody is there. The server keeps a halo of zones loaded around every villager away from players (VillagerHaloRings — 2 rings = 25 zones) and every registered structure, so distant villagers keep genuinely moving, hauling and trading. A party member beside its player holds none: your game already has that ground.

• KeepAliveMaxZones caps the total (0 = no cap; reaching the cap is logged).
• KeepAliveFilterObjects loads only what the Kolony needs in held zones — villagers, buildings and registered structures, loose items, creatures within reach of a player or of a party out on its own, and the berry bushes and crops a foraging or farming Kolony needs growing. Trees, logs, stumps, ore and boulders are built one at a time, only while a villager is working that one, so a distant outpost costs a handful of objects instead of its whole forest. Off-screen, villagers walk through unbuilt trees rather than around them; anywhere a player is standing, everything loads as normal. Switch this off to load everything, exactly as before.
• KeepAliveEmptyGraceSeconds: after the last player disconnects, the world keeps running this long, then pauses until someone returns. While it is paused the villagers are put away with it, and come back where they were.
• KeepAliveWhenEmpty: on a dedicated server, the Kolonies keep working with nobody online - the grace above never ends. Off by default; on costs the server its CPU while it runs.
• A travelling villager more than TravelObservedRange from any player covers ground unseen rather than walking a navmesh nobody has loaded.

---

Multiplayer

• Every player and the server need the mod, at the same version. On a dedicated server the server runs every villager, party members included, wherever they are; your game shows them.
• World settings are the server's. Food, rest, claims, keep-alive, combat and the rest are sent to every client on join and locked there; only an admin may change them while connected, and only through a config manager - the Kolony panel shows them read-only. Keys, panel size, the morning report, the log interval and the network limits stay yours.
• Two players near one kitchen no longer fight over it: a machine that loses a station it was loading waits a few seconds before taking it back, so the two take turns.
• A Kolony is one settlement for everybody. On a server every edit goes through the server, so any member can manage their Kolony from anywhere and everyone sees the same thing. An edit made from a copy someone else changed a moment before is refused with a note, and the panel shows the fresh copy so the next try works. A change waiting on the server shows sending….
• Trades, hires and hand-overs go through the server and are checked there; nothing can be lost or doubled between a player, a villager and a chest. A villager never writes a chest a player has open.
• From anywhere: the Kolony panel, the structure key and hover at an outpost, a flag's card, a party member's record and far map pins all work without the hearth being near you.
• Dedicated servers are supported and were the deployment used during development. Crossplay joins work; if a crossplay player is dropped shortly after joining, raise JotunnSendQueueBytes / JotunnSendTimeoutSeconds on the server.

---

Settings

Settings in the panel opens with About Kukolony - the version, the edition, the Patreon link with Copy link, and in the free edition what is being tested there. Below it, every entry (except the developer ones and the Kolony limits, which stay in the config file) grouped by section, with a search over all of them: a check box for switches, a slider with the number typed beside it for ranges, a choice for options, text boxes, and press a key for the hotkeys. Reset puts a value back to its default (undoable), and a setting's description is on its name when you hover it. Changes save to the config file at once. Entries marked (world) are the server's when you are on one, shown but not changed here - that is every entry below except the hotkeys, PanelScale, MorningReport, ActivityLogSeconds and the Network ones, which are always yours.

Section	Setting	Default	What it does
Kolony	ColonyScreenHotkey	[	Opens the Kolony panel.
Kolony	PanelScale	1	How big the Kolony panel's text is drawn (0.75-1.75). The panel fills most of the screen at that size. Yours, not the world's.
Kolony	MorningReport	Yes	When you join and each morning, a few lines on what your Kolony did. Yours, not the world's.
Kolony	PartyScreenHotkey	]	Opens Parties, on the party out with you. With Ctrl, calls your party aboard the boat you stand on; Ctrl+Shift sends it ashore; Shift halts your party's voyage.
Kolony	StructureScreenHotkey	\	Opens what you are looking at; with Ctrl, registers it first; with Ctrl+Shift, starts or ends picking several.
Kolony	MarkersHotkey	\	With Shift, toggles the registered marks.
Kolony	KolonyRadius	96	A hearth's reach in metres. Wider keeps more of the map loaded.
Kolony	KolonyRadiusCeiling	1024	The most a hearth's reach may be set to; an admin lowers it to cap Kolonies.
Kolony	FlagRadius	48	A new flag's reach.
Kolony	NewVillagerCost	50	Coins to hire. 0 is free.
Kolony	VillagersOpenDoors / DoorCloseBehindSeconds	on / 4	Doors in the way, and closing them after.
Kolony	VillagersJump	on	Hops and step-downs when stuck.
Kolony	VillagerSmallTalk	on	Passing words and greetings.
Kolony	VillagerEmotes / EmoteMinSeconds	on / 45	Villagers now and then shrug, wave, laugh or cheer; the shortest gap between one villager's emotes.
Kolony	OverflowGearCap	500	Pieces of gear the overflow holds; plain goods have no limit.
Kolony	OverflowAutoMoveMinutes	10	How often held goods are offered to the chests again; 0 for never.
Villagers	GoHomeRadius	8	How far a villager drifts from home before walking back.
Jobs	ResourceScanRadius	96	How far from a hearth or flag to look for trees and pickables.
Jobs	StuckGiveUpSeconds	60	No progress for this long → give up the trip.
Jobs	ClaimsEnabled / ClaimTtlSeconds	on / 30	Villagers reserve what they work on, for this long.
Jobs	PresetTurnSeconds	120	Longest one work-list entry keeps a villager. 0 = off.
Jobs	IdleWarnSeconds	300	Finishing nothing for this long is reported.
Off-screen	KeepAliveEnabled	on	Colonies work with nobody near.
Off-screen	VillagerHaloRings / SeaHaloRings	2 / 5	Zones held around each villager, ashore and at sea.
Off-screen	KeepAliveMaxZones	0	Cap on held zones (0 = none).
Off-screen	KeepAliveScanSeconds	4	How often unloaded villagers are swept for.
Off-screen	KeepAliveEmptyGraceSeconds	600	Run-on after the last player leaves.
Off-screen	KeepAliveWhenEmpty	off	Keep the Kolonies working on a dedicated server with nobody online.
Off-screen	KeepAliveFilterObjects	on	Load only what the Kolony needs in held zones.
Off-screen	VillagersAlwaysLoaded	on	Villagers are sent to every player and never unloaded, so far-off villagers stay visible.
Off-screen	TravelObservedRange	96	Nearer than this, a traveller walks; farther, it covers ground unseen.
Work	EnergyPerAction	2	Energy per action.
Work	TiredBelow / RestedAbove	20 / 70	Rest thresholds.
Work	BedHoursToRest / HearthHoursToRest / GroundHoursToRest	4 / 10 / 20	In-game hours to recover, by where.
Work	FoodDrainRate	0.5	Food burn while working, × real time.
Work	FedCapSeconds	1800	Seconds of food a villager can hold.
Work	HungryBelowSeconds	600	Goes to eat below this.
Work	StarvingGraceSeconds / StarvingKills	1800 / off	How long with nothing before it dies, and whether it does.
Work	ChopSwingSeconds	4	Seconds between axe blows for a novice; Woodcutting shortens it.
Work	MineSwingSeconds	4	Seconds between pickaxe blows for a novice; Mining shortens it.
Work	OnlyKnownRecipes	on	Crafting orders limited to what you have discovered.
Work	ComfortMatters	on	A comfortable roofed room rests villagers faster, in vanilla comfort proportion.
Work	PartyLeashDistance / PartyComfortDistance	12 / 4	Following distances.
Work	PartyWorkRadius / GleanerStandOff	28 / 6	Party work reach, and what is left at your feet.
Work	PartyWalkMeters / PartyTravelMaxSeconds	150 / 90	Walk to you within this; beyond it, travel for at most this long.
Work	PartyLeaderGoneSeconds	120	How long a party waits for a player who logged off.
Work	PutAwaySetAsideSeconds	300	How long something no chest will take stays in a villager's bag before it is tried again.
Work	CampFirePiece / CampStandOff	fire_pit / 4	An expedition camp's fire.
Work	SupplyRunThreshold / SupplyRetrySeconds	0.8 / 120	When a ferry run leaves, and the retry after an empty one.
Combat	CombatStyle	Vanilla	Vanilla AI or Direct, mod-driven fights.
Combat	SettlementDefence	on	Villagers fight at home.
Combat	DefensiveReactDistance / AggressiveSeekDistance	15 / 24	Stance ranges.
Combat	HuntShotDistance	25	How far a hunter with a bow shoots game from.
Combat	HuntLoadsWildlife / HuntGroundRings	on / 1	Creatures come alive around a working hunter, this many 64 m rings out.
Combat	HuntSpawnEnabled / HuntSpawnCap / HuntSpawnSeconds	on / 4 / 90	A hunting place breeds game from its biome's list, up to the cap, at most once per interval.
Combat	VillagerArrowsHitDirectly	on	A villager's arrow lands on its target when the line is clear.
Combat	VillagerMaxHealth / HealFullSeconds	50 / 0	Base health - armour, food and skill multiply it (see Skills) - and heal time (0 = creature's own).
Combat	ReviveSeconds	60	World-time seconds before a fallen villager wakes.
Skills	SkillsEnabled	on	Villagers learn by working and grow tougher with armour, food and skill. Off: no experience, plain base health.
Skills	SkillXpRate	5	How fast villagers learn (0-100).
Skills	SkillLevelCap / SkillXpBase / SkillXpExponent	100 / 10 / 1.5	Highest level; what the first level costs; how steeply each next one rises (base × (level+1)^exponent).
Skills	SkillWorkBonusAtCap	3	How much better a master works than a novice (3 = four times as fast at the cap).
Skills	HealthPerArmour / HealthPerFood / HealthPerSkillLevel	0.02 / 0.01 / 0.05	Health multiplier per armour point, per point of the last meal's health, per total skill level.
Skills	HealthCap	100000	The most health a villager can have.
Skills	RegenPerArmour / RegenPerFood / RegenPerSkillLevel / RegenCap	0.01 / 0.02 / 0.02 / 50	How much faster a villager heals, the same way; at most RegenCap times.
Skills	TrophyXpTier1…TrophyXpTier7 / TrophyXpBoss	0, 20, 50, 120, 300, 700, 1500 / 15000	Experience a trophy teaches a villager who studies it, by biome tier (Meadows to Ashlands), and a boss trophy.
Skills	HaulScoopAtCap	10	Extra items of the same kind lying close by that a master hauler takes in one go (0-100).
Skills	HuntRangeBonusAtCap	0.8	How much farther than HuntShotDistance a master hunter shoots (0.8 = 80% farther).
Expeditions	ExpeditionsEnabled	on	Parties can be sent out on their own, and on routes.
Expeditions	ExpeditionsAtOnce	2	How many parties one Kolony may have out at once, routes included. Each keeps its ground loaded on the server.
Expeditions	ExpeditionRadius	48	A zone's radius when none is chosen (24–96).
Expeditions	ExpeditionMaxDistance	3000	The longest route, in metres of walking one way.
Expeditions	ExpeditionSpeed	3	How fast a zone travels, metres a second, while everyone is with it.
Expeditions	ExpeditionFullAt	0.8	How full a gathering party's bags are when it turns for home.
Expeditions	ExpeditionMaxDays	3	In-game days out before a party comes home by itself.
Expeditions	ExpeditionFindMeters	1500	How far from its base a gathering party sent without a route looks for where to go (explored ground).
Expeditions	ExpeditionSearchMeters	300	How far round the end of its route a gathering party looks once what it came for runs out.
Expeditions	ExpeditionRestedEnough	0.6	How rested everyone must be to go on without re-pitching a destroyed fire.
Release	MaxKolonies	0	The most Kolonies a world may hold; 0 for no limit.
Release	ColonyReplaceCooldownMinutes / CooldownOnAnyLoss	1 / on	The hearth-loss cooldown.
Logging	ActivityLogSeconds	30	How often a villager's activity is logged. 0 = every change. Yours.
Network	JotunnSendQueueBytes / JotunnSendTimeoutSeconds	250000 / 300	How much a busy player's connection may queue, and how long it is waited on before a disconnect - raised for crossplay. Yours.
Development	DebugSpawnEnabled, VerboseTendLog, VerboseHaulLog, DebugProbeEnabled, DevGalleryEnabled, Benchmark…	-	Developer tools, hidden in the panel. Leave them as they are.

---

Console commands

For single-player and whoever hosts the world - they run on the host and act around the host's own character, so a player connected to a dedicated server cannot use them - except kukolony_claim, which any admin can type from anywhere. (cheat) commands need devcommands.

Command	What it does
kukolony_claim	An admin, standing at a hearth, joins its Kolony without an invitation.
kukolony_expedition [metres] [scout|gather|patrol|guard]	Sends your Kolony's first party that far straight ahead of you (300, scout) - a way to try one without the map. (cheat)
kukolony_route <item> [amount] [keep there]	Has your Kolony's first party carry that item (its prefab name, e.g. Wood; 50 a trip unless given) from the base you stand at to the nearest other base, again and again. (cheat)
kukolony_recall	Calls home every party your Kolony has out. (cheat)
kukolony_panel	Opens the Kolony panel, the same as [.
kukolony_where	Lists what each loaded villager is doing and how far away it is.
kukolony_unstick	Lets go of any input the mod is holding, if your keys ever stop answering.

---

Good to know

• Villagers eat only from registered chests. No registered food is the most common reason a new colony stops.
• Tools live in chests. Chop needs an axe, Mine a pickaxe, Repair a hammer — in a registered chest villagers may use. The last one is never taken.
• A job says what work is; the villager's list says the order. Give villagers several jobs unless you really want one forever.
• Reach is everything. A chest just outside the circle is not the Kolony's. Flags extend it.
• Cooked food burns if nobody takes it off — list the dish on a Make job (Also cook), not just a Tend.
• "Not found" on a structure means the server cannot find it either — it was destroyed. Remove it, or rebuild it and register the new one.
• The log (BepInEx/LogOutput.log) carries every [report] line the mod told you and a sampled activity trace. If you report a problem, attach it.

---

Credits

Built with Jötunn on BepInEx. Villagers wear the game's own player rig and gear. Blueprint building via PlanBuild when installed.