Valheim Farmer NPC

Autonomous farming NPCs for Valheim. Place a Farmer Homestead, mark your cultivated field with Boundary Posts, assign chests, and let goblin farmers plant, harvest, and store crops while you stay nearby.

How it works

• The Homestead piece stores all persistent farm data (crop slots, chests, pause state, crop settings) on its network object (ZDO).
• Farmer NPCs are temporary workers that exist while a player keeps the farm zone loaded. They are not permanent world creatures.
• AI runs on the peer that owns the farmer’s network view (IsOwner()), which keeps multiplayer safe without forcing dedicated-server ownership of every NPC.
• If you leave the area and farmers disappear, that is expected. Homestead data and the field remain. Come back, open the Homestead, and use Add Farmer / unpause again.

Talking to a farmer toggles pause/resume for that homestead’s work.

Installation

With r2modman / Thunderstore Mod Manager

1. Install BepInExPack Valheim and Jötunn.
2. Install Valheim Farmer NPC (Pjanky-ValheimFarmerNPC).
3. Use the same profile/mod list on the dedicated server and every client.

Manual

1. Install BepInEx for Valheim and Jötunn.
2. Copy ValheimFarmerNPC.dll into BepInEx/plugins/ValheimFarmerNPC/ (server and clients).
3. Launch once so the config file is created under BepInEx/config/.

Custom hammer pieces: Farmer Homestead, Farm Boundary Post.

Complete setup walkthrough

Default config only allows admins to place Homestead/Boundary pieces and open the Homestead panel. Set AdminOnlyPlacement / AdminOnlyAccess to false if you want any player to manage farms.

1. Cultivate and plant a starter field (optional but recommended)

Till soil and plant at least some crops yourself (or leave empty cultivated plots). A scan discovers existing plants and empty plantable spots inside the boundary.

2. Place the Farmer Homestead

1. Open the hammer and find Farmer Homestead.
2. Place it near your farm (facing the field is fine; exact facing is not critical).
3. Interact with the Homestead to open the Farmer Homestead panel.

Status at the top shows pause state, farmer count, crop slot count, chest count, and whether a boundary is set.

3. Place Boundary Posts

1. Place two Farm Boundary Posts at opposite corners of the rectangle that should cover your farm.
2. The posts define an axis-aligned box on the ground (XZ). Keep each half-width within MaxFarmRadius (default 64 m), or scanning will fail.

Tip: Place posts just outside the cultivated plots so every plantable tile is inside the box.

4. Assign Boundary Posts

On the Homestead panel → Field section:

1. Click Assign Boundary Posts.
2. The mod finds nearby boundary posts and binds them to this homestead.
3. Status should show Boundary: set.

If assignment fails, move closer, ensure both posts exist, and try again.

5. Scan the field

1. Click Scan Field.
2. The homestead inventories plants and empty cultivated slots inside the boundary.
3. Status Crops count should rise above zero.

Use Clear Field only when you want to wipe the homestead’s remembered slot list (for a full rescan after big layout changes). It does not destroy plants in the world by itself—re-scan after clearing if you still want farmers to work that field.

6. Assign chests (storage)

Farmers need containers for seeds/harvests.

1. Place normal Valheim chests (or compatible containers) near the homestead.
2. Click Add chest — assigns the nearest free chest within ChestAssignRange (default 20 m).
3. Repeat Add chest until you have enough storage.
4. Clear chests unassigns all chests from this homestead (items in the chests are not deleted).
5. Chest inventory opens a page listing aggregated contents of assigned chests.

7. Configure crop settings

Open Crop settings.

• The page shows the homestead’s biome (top right).
• Only crops that can grow in that biome appear.
• Unavailable crops are zeroed for planting automatically.

Weights (left column)
Relative planting ratios. Higher weight → planted more often when filling empty slots. Set a crop to 0 to skip planting it (harvest of existing plants can still happen).

Reserves (right column)
Minimum stock kept in the farmer’s bag. For Carrot/Turnip/Onion this is seeds; for Barley, Flax, Jotun Puffs, and Magecap it is the crop item itself (planted like vanilla). When stock falls below the reserve, farmers prioritize growing seed-crops (or restocking) until the reserve recovers.

Click Back when done.

Biome → plantable crops

Homestead position decides the biome. Fields that straddle biome borders may need the homestead on the side you intend to farm.

8. Add farmers and start work

1. Stay near the homestead so the zone stays loaded. Placing a Homestead already spawns one farmer.
2. Use Add Farmer for more workers, or if the worker went missing after you left the area.
3. Ensure status is Working (not Paused). Use Toggle Pause if needed.
4. Farmers will harvest mature crops, plant empty slots according to weights/reserves, fetch materials from chests, and deposit overflow.

Remove Farmer despawns one farmer at this homestead (useful if you added too many). Global cap: MaxFarmers (default 16 across the whole world).

Deposit all forces farmers to empty carried goods into assigned chests when possible.

9. Day-to-day use

• Keep a player near the farm while you want work done.
• Interact with the Homestead anytime to check status, inventories, or crop settings.
• Talk to a farmer to pause/resume.
• After long absences: open Homestead → Add Farmer if none are present → ensure not paused → optionally Scan Field if you changed the field by hand.

Homestead UI pages

Main — Farmer Homestead

Overview and all primary actions.

Crop settings

Two columns for biome-legal food crops only.

Empty biomes show a message that no crops grow there.

Farmer inventory

Live view of items in farmer bags near this homestead (aggregated).

Chest inventory

Aggregated contents of all chests assigned to this homestead.

Configuration

After first launch, edit:

BepInEx/config/com.farmerjohn.valheimfarmernpc.cfg

On dedicated servers, treat these as server-authoritative for gameplay limits. Restart (or reconnect) after changes as needed.

General

Farming

Inventory

Networking

AI

Debug / UI

Per-homestead crop weights and reserves are not in this file — they are stored on each Homestead and edited in Crop settings.

Multiplayer notes

• Install the same mod version on server and clients (EveryoneMustHaveMod).
• Homestead data persists in the world save via the piece ZDO.
• Multiple farmers on one homestead share the field; reservations avoid two NPCs claiming the same plant/slot.
• Farmers only work while someone keeps the zone loaded.

Troubleshooting

Development

Repository: github.com/nico8034/FarmerNPC

# Local Debug build → r2modman Default profile plugins
powershell -ExecutionPolicy Bypass -File ValheimFarmerNPC/scripts/deploy-local.ps1

# Thunderstore zip → ValheimFarmerNPC/dist/
# (bump Plugin.PluginVersion first; update Package/CHANGELOG.md)
powershell -ExecutionPolicy Bypass -File ValheimFarmerNPC/scripts/package-thunderstore.ps1

Also copy Environment.props.example → Environment.props and set VALHEIM_INSTALL for IDE/Jötunn post-build deploy.

Version source of truth: Plugin.PluginVersion in Plugin.cs (semantic versioning: Major.Minor.Patch).

License

Licensed under the MIT License. Valheim is © Iron Gate AB — this mod requires a legitimate copy of the game.