Troubleshooting

Updated 8 hours ago

Nobody is doing anything

Work through these in order - the first three account for nearly every case.

  1. No bed. Residents refuse to work until they have claimed a free, roofed bed within 45m of the Frithstone.
  2. No work area. Without a drawn area a resident only works within 30m of the stone.
  3. No tool. A Lumberjack with no axe, a Fisherman with no rod. Put a spare in a chest; they fetch their own.
  4. No chest. With nowhere to put what they gather, they fill up and stop.

The status text over a resident's head always says which of these it is. It is written to be read as a reason, not a label.

The build menu is empty - with any hammer

This is Jotunn, not Innangard. Jotunn 2.29.2 was built before Valheim 1.0 and its piece-table patch throws on it, which empties every build menu in the game - vanilla's hammer as well as this mod's.

Innangard 0.0.8 removes that one patch so the hammers work again. The cost is that other mods' custom build-menu tabs are missing until Jotunn ships a build for 1.0. Innangard's own pieces are unaffected; they sit in vanilla's Misc category.

The workaround tests for the exact change it repairs, so it switches itself off the day Jotunn is updated. You do not have to do anything.

The game will not start at all

Look in BepInEx/LogOutput.log for InvalidProgramException or MissingMethodException. After a game update, any mod compiled against the older Valheim throws these, and one of them can take the whole game down with it.

Innangard needs only BepInEx and Jotunn, so a profile with those three is a fast way to tell whether the fault is here or somewhere else in your list.

Reading the log

Two settings under [Debug] in BepInEx/config/com.yololo.innangard.cfg:

  • VerboseLog = true - every work decision goes to the BepInEx log. Verbose, and the fastest way to answer "why is it doing that".
  • ShowOverlay = true - draws each nearby resident's role, activity, target and movement mode over its head. Amber means the path is blocked, red means it has a hostile target.

Lines are tagged, so you can filter for the one you care about:

Tag What it covers
Innangard[job] which trade a resident is running, and its state each tick
Innangard[build] the Builder: sites, materials, mending
Innangard[forage] [hunt] [lumber] [fisher] why a gatherer found nothing
Innangard[planner] [ai] [door] routes, doors, and why one failed
Innangard[storage] [caretaker] chests, sorting, withdrawals
Innangard[rescue] [stall] [rooted] residents that cannot get anywhere
Innangard[helm] a settler sailing a boat
Innangard[net] ownership, which matters far from the player

Most say why rather than what. A Forager reports the whole count:

nothing to pick - 190 pickable(s) in the world, 28 passed the first look,
162 already picked and regrowing, 27 outside the work area (6 anchor(s)),
1 in a farm field or cultivated, 0 not in this resident's allowed materials

That is the answer to "is it lying to me": 27 of the 28 ready pickables were outside the circles, so there really was nothing inside them.

A resident is stuck

It should sort itself out. A resident that cannot get anywhere for 60 seconds (StuckRescueSeconds) is picked up and set down on the nearest ground it can stand on, and only carried all the way home if that fails too.

If one is stuck for longer, Innangard[rooted] names what is holding it and Innangard[rescue] says whether it was carried.

Getting a world back

Innangard copies your world aside every time it loads and again when you leave. The copies live in a folder called innangard-backups beside your saves, one folder per copy, and the five most recent are kept (WorldBackups).

inn.world.backups lists them and prints the folder.

Restoring is deliberately manual: close the game, then copy a backup's contents back over the save. A mod should not overwrite a live world on its own judgement.

Known to be wrong

  • A guard or Builder can walk onto a roof. Innangard's own pathfinder refuses roofs, but when it finds no route it falls back to Valheim's navmesh, which does not.
  • Multiplayer has not been tested with more than one player.
  • The Farmer and the Miner are not handed out yet.