Woodcutter NPC

Hire woodcutters to chop trees for you. Build a Woodcutter's Post, hire a woodcutter there, hand it an axe and start it - it fells trees in the post's work zone, chops the logs, picks up the wood and brings it back to the post's storage. When the zone is cleared it waits by the post and goes back to work on its own as soon as something regrows.

English · Українська · Русский

Features

• Woodcutter's Post (hammer, Crafting tab, 10 wood, no workbench needed)

  • E - the post's storage: the top row is for axes, the rest for wood and other items
  • Shift + E - the post window: hiring, the woodcutter list, the work zone, upgrades

• Woodcutters

  • Swing the axe you put in their first slot, with its real stats: chop damage, upgrade level, tool tier (a stone axe won't touch an oak) and durability
  • Work only inside the post's work zone (radius 10-300 m, set in the post window; the zone is drawn on the ground while the window is open)
  • Carry the wood to the post when their inventory is 90% full; wait by the post if its storage is full
  • Choose which tree species to cut (per woodcutter)
  • Follow rolling logs downhill and chop them from any side
  • Regenerate health; don't get stuck forever on unreachable trees
  • E - its inventory, Shift + E - its settings (start/stop, species, dismiss)

• Post upgrades (once per world - survive tearing the post down and rebuilding it)

  Level	Woodcutters	Upgrade cost	Hire cost
  1	1	-	50 coins
  2	2	10 surtling cores	100 coins
  3	3	20 surtling cores	200 coins (re-hire: 100)

• Woodcutter list in the post window: state, axe durability, inventory fill, distance; start/stop each one, stop all and call them to the post, start all

• Live map pins for every woodcutter, and a death pin on the loot chest if one dies (the chest breaks once emptied)

• Notifications when an axe drops to 5%, when it breaks, and when a post's storage is full

• Dismissing a woodcutter puts its axe and belongings into the post's storage

• Languages: English, Ukrainian, Russian - follows the game's language, or set it in the config

Getting started

1. Build a Woodcutter's Post with the hammer.
2. Shift + E on the post → Hire a woodcutter. It appears next to the post, stopped.
3. E on the woodcutter → put an axe in its first slot (the one with the faded axe).
4. Shift + E on the woodcutter → Start.

If you use a mod that remaps the alternative interaction (e.g. Zen ModLib's single key, Q by default), use that key instead of Shift + E.

Configuration

BepInEx/config/com.roman.woodcutternpc.cfg (or any in-game configuration manager):

Multiplayer

Install the mod on every client and on the server - the woodcutter and the post are new game objects. Post levels are stored in the world and shared by all players.

Known limitations

• Woodcutters walk in straight lines (no pathfinding); they give up on targets they are physically stuck against and try something else.
• Unloaded (far-away) woodcutters don't work - the game only simulates what is near a player.

Bugs and suggestions

Found a bug or have an idea? Open an issue on GitHub - pick Bug report or Suggestion. For bugs, please attach BepInEx/LogOutput.log from your profile folder.

Українська

Наймайте лісорубів. Побудуйте Колоду лісоруба, найміть там лісоруба, дайте йому сокиру й запустіть: він рубає дерева в зоні колоди, розрубує колоди, збирає дерево й відносить його у сховище колоди. Коли зона вирубана, він чекає біля колоди й сам іде працювати, щойно щось виросте.

• E на колоді - сховище (верхній ряд - під сокири), Shift + E - вікно колоди: найм, список лісорубів, робоча зона, поліпшення.
• E на лісорубі - його інвентар (сокира - у перший слот), Shift + E - налаштування.
• Поліпшення колоди (один раз на світ): рівень 2 - 10 ядер суртлінга, рівень 3 - 20; кожен рівень дає ще одного лісоруба (50 / 100 / 200 монет, повторний найм третього - 100).
• Мова: як у грі, або [General] Language = Ukrainian у конфігу.
• У мультиплеєрі мод потрібен у всіх гравців і на сервері.
• Баги та пропозиції: GitHub Issues.

Русский

Нанимайте лесорубов. Постройте Колоду лесоруба, наймите там лесоруба, дайте ему топор и запустите: он рубит деревья в зоне колоды, разрубает бревна, собирает дерево и относит его в хранилище колоды. Когда зона вырублена, он ждёт у колоды и сам идёт работать, как только что-то вырастет.

• E на колоде - хранилище (верхний ряд - для топоров), Shift + E - окно колоды: наём, список лесорубов, рабочая зона, улучшения.
• E на лесорубе - его инвентарь (топор - в первый слот), Shift + E - настройки.
• Улучшение колоды (один раз на мир): уровень 2 - 10 ядер суртлинга, уровень 3 - 20; каждый уровень даёт ещё одного лесоруба (50 / 100 / 200 монет, повторный наём третьего - 100).
• Язык: как в игре, или [General] Language = Russian в конфиге.
• В мультиплеере мод нужен у всех игроков и на сервере.
• Баги и предложения: GitHub Issues.

Changelog

1.1.0

• Woodcutters walk around obstacles (rocks, trees, buildings, cliffs) using the game's own pathfinding instead of walking in straight lines. Config: [Movement] Pathfinding (on by default)
• Automatic axe repair: tick it in a post's window and a woodcutter whose axe breaks repairs it there, paying from the post's storage with 30% of the axe's main material only - the one its recipe takes the most of, not the handle wood or leather (config [Repair] CostPercent). Missing materials are announced once
• Woodcutting skill: woodcutters used to hit like a player with skill 100. Now a new one hits like a beginner (about 40% of the axe's damage, as for a player) and improves with every swing, the same way a player's skill does. Shown in the post's list, the woodcutter's hover text and its window. Woodcutters hired before this version start at [Skill] StartLevel (0 by default). Config: [Skill] GainRate, StartLevel
• Fixed: buttons next to each other (All / None, dismiss confirmation) no longer touch
• The hover text over a woodcutter no longer shows the axe's upgrade level

1.0.2

• Link for bug reports and suggestions: https://github.com/Roman10220/WoodcutterNPC/issues

1.0.1

• New icon
• Published to the Valheim community

1.0.0

First public release.

• Woodcutter's Post: build with the hammer, hire woodcutters, storage with an axe row
• Woodcutters fell trees in the post's work zone and carry the wood back to the post
• Post upgrades (once per world), hiring limits and prices
• Woodcutter list, recall/start all, per-woodcutter settings and tree species
• Live map pins, death pin with loot chest, notifications
• English, Ukrainian and Russian