ValheimLumberNPC

Valheim Lumber NPC

Put your logging on autopilot. Place a homestead, set a work radius, assign a few chests — then let a friendly Lumber Troll chop trees, smash logs and stumps, pick up wood, and store it while you get on with raiding, building, and exploring.

Highlights

• Hands-off logging — chops trees, smashes fallen logs and stumps, collects drops, and deposits wood.
• You decide the mix — set chop priorities and replant priorities per tree type, filtered to the homestead biome.
• Optional replanting — after clearing a stump, can plant a sapling from seeds carried in the bag.
• Storage handled — assigns normal Valheim chests; deposits surplus and pauses when chests are full.
• Multiplayer-safe — works on local worlds, player-hosted games, and dedicated servers.
• Simple in-game menu — everything is driven from one panel on the Homestead piece.

| | | |---|---| | Version | 1.0.1 | | Author | Pjanky | | License | MIT | | Requires | BepInExPack Valheim + Jötunn | | Install on | Dedicated server and all clients (same version) |

---

Install

With r2modman / Thunderstore Mod Manager (recommended)

1. Install BepInExPack Valheim and Jötunn.
2. Install Valheim Lumber NPC (Pjanky-ValheimLumberNPC).
3. Use the same mods on the dedicated server and every client.

Manual

1. Install BepInEx for Valheim and Jötunn.
2. Copy ValheimLumberNPC.dll into BepInEx/plugins/ValheimLumberNPC/ on the server and every client.
3. Launch once so the config file is created under BepInEx/config/.

The mod adds one hammer build piece: Lumber Homestead.

> By default only server admins can place the homestead and open the panel. To let any player manage lumber yards, set AdminOnlyPlacement and AdminOnlyAccess to false (see Configuration).

---

Quick start

Everything runs from the Lumber Homestead panel — interact with the placed homestead to open it.

1. Place the Homestead where you want logging done. It spawns your first Lumber Troll automatically.
2. Set the work radius on the main page (default 40 m, adjustable 10–100 m).
3. Add storage. Place chests nearby and click Add chest for each.
4. Tune tree priorities under Lumber settings if you want (biome-filtered).

That's it — as long as a player keeps the area loaded, the troll will chop, smash logs/stumps, collect wood, and deposit into your chests. When chests fill up, work pauses until you free space or add another chest, then unpause.

> Trolls vanishing when you leave is normal. They are temporary workers, not permanent creatures. Your homestead settings, radius, and chest assignments are saved. When you return, open the panel and click Add Troll if none are present.

---

How it works

• The Homestead piece stores persistent data (chests, pause state, work radius, tree priorities) in the world save.
• Lumber Trolls only work while a player keeps the area loaded — they are summoned workers, not wandering monsters.
• Work loop: find tree → chop → smash logs → smash stump → (optional replant) → collect wood → deposit.
• On multiplayer, AI runs on the peer that owns the NPC’s network view, which keeps dedicated servers safe without forcing the headless server to simulate every troll.
• Talking to a troll toggles pause/resume for that homestead.

---

Full setup walkthrough

1. Place the Lumber Homestead

Open the hammer, pick Lumber Homestead, and place it near the trees you want cleared (exact facing doesn’t matter). Interact with it to open the panel. The status line shows pause state, troll count, work radius, and chest count.

2. Set the work radius

On the main page under Work area, drag the Work radius slider (10–100 m). Trees outside this circle are ignored.

> Tip: MaxWorkRadius in the BepInEx config is a server ceiling, not the homestead’s current radius. Change the radius in the UI. If the config ceiling is stuck at 40, the slider cannot go higher until that config is raised (newer builds auto-correct a ceiling of 40 up to 100).

3. Assign chests (storage)

1. Place normal Valheim chests (or compatible containers) near the homestead.
2. Click Add chest to assign the nearest free chest within ChestAssignRange (default 20 m). Repeat for more storage.
3. Clear chests unassigns all chests (their contents are never deleted).
4. Chest inventory shows the combined contents of all assigned chests.

4. Configure lumber settings

Open Lumber settings. Only tree types for the homestead’s biome (shown top-right) appear.

• Tree priorities (left) — relative chance to pick that tree type when chopping. Higher = preferred. Set to 0 to skip chopping that type.
• Replant priorities (right) — after a stump is cleared, which seed family to prefer when planting a sapling from the bag. Set to 0 to never replant that type. Replanting only uses seeds already in the troll’s bag (it does not fetch seeds from chests).

Click Back when done.

Which trees appear where

| Biome | Tree types shown | |-------|------------------| | Meadows, Ocean | Beech, Birch | | Black Forest | Beech, Birch, Fir, Pine, Oak |