Valheim Navigator

Two mods in one: an interactive world map and a navigator. Search and filter every location type on the game's large map, pick one, and get a route there that the map and minimap draw and follow as you go, on foot, by ship and through your portals, planned with the wind.

Work in progress (beta). The Fast route detail with the Shortest mode is the tested setup. The Detailed mode is a work in progress and may not handle every place well. Multiplayer sharing was tested with a player host and a guest over crossplay, in both directions.

Features

• Two map modes, asked at the first large map opening and changed any time in Settings.
  • Explorer. Search, map markers and routes cover the land you have explored and places close to it or close to you, even a little into the fog. The rest stays hidden. Land read from a cartography table counts as explored, and the map views draw it while the game shows the table's map.
  • Cartographer. The whole world is known, also what lies in the fog.
• Find. Search every location type of the world (bosses, traders, dungeons, caves, ore, runestones and more) by name. The nearest one gets a pin, and places you reached are marked done.
• Layers. Turn categories and single location types on or off on the large map. Crowded views group pins into numbered circles.
• Terrain views. A sharp detail view of the terrain drawn from the game's own height data, with contours, plus optional biomes, height, simplified, steep ground, mist, shallow water for sailing and a shade for unexplored land (0 turns it off). The minimap shows the same view, sharp. A cursor readout shows ground height and water depth.
• Routes.
  • Shortest or Comfort. Comfort charges climbing, downhill counts like flat ground.
  • On foot, by your nearest ship or by a boat built at the best shore. More boats allows a second sailing leg.
  • Your portal pairs (two portals with the same name) are used by default, through hubs too. The large map tags each portal to take with its number and name. Set Portals to Don't use on the Route page when you carry ore.
  • Sailing is planned with the predicted wind, and with Moder's power as a tailwind on every heading.
  • A ship farther than ShipMeters is used when it lies on land you or a cartography table explored.
  • No swim longer than 35 m, short steep banks can be jump-run, lava and the boiling Ashlands sea are respected, and known sea rocks are avoided.
  • The route follows you and recalculates when you leave it or teleport. The destination is marked done when you arrive.
  • Routes are searched in the background, so the game keeps running smoothly while one is calculated.
• Detail.
  • Fast reads the generated world map.
  • Detailed (work in progress) also reads the real ground, rocks and trees around you, and the faster paths of the SpeedyPaths mod. Player buildings are not read by default (DetailedStructures).
• Known world (optional, off by default). Beds, tombstones, ships and carts, tamed animals, chests and their contents, ore deposits and spawn-safe areas that your game client knows.
• Console command navigator for the same search.

Multiplayer

• Full world search works in solo play and while hosting. Joining players get the host's location list when both sides use a compatible Navigator version and the host allows sharing.
• Each player chooses routes, filters and destinations independently. Completion marks stay on that player's installation. Personal pins, exploration fog and inventories are not transferred by Navigator.
• Without host support, terrain views, manual destinations and available personal pins, portals and known objects remain usable. Enable personal-pin search or optional known-object features to use those sources. Full world search shows why it is unavailable.
• The host can also share portal names and endpoints and ship positions. Local observations take priority. Changed data is requested about once a minute by default, so a portal rename or moving boat can take time to appear.
• A validated location cache is stored by world UID and generation version. Cached data is used only after the current host confirms its checksum. Changing worlds clears the previous world's live data.
• Done marks of older versions (one file per world name) are copied once into the new per-world file, only for locations of that world. The old file is kept. navigator importlegacy repeats the copy by hand.
• navigator sync requests another check from the host. A short request cooldown applies.

Dedicated servers are not tested yet.

Settings

All settings are in BepInEx/config/onononoki.ValheimNavigator.cfg, in numbered sections (01 - General to 13 - Layer kinds), and most are on the panel's Settings page. Settings from older versions move to the new sections by themselves, with their values.

Compatibility

• Client features work independently. Full location search on a guest needs compatible host support. Players without Navigator can still join normally.
• Requires BepInExPack Valheim.
• SpeedyPaths is optional. Its path speeds count in Detailed routes.
• With ShipPins installed, its pins show the ships and carts, and Navigator draws no ship markers of its own. Routes still use the ships.
• Ships from other mods sail at longship speeds unless ShipSpeeds lists them.
• Routes are estimates. Unknown rocks, trees and buildings can block a route, and travel times are approximate.

Planned

• An unexplored shade that matches the game's own fog look.
• Better routes through mountains, in Fast and Detailed.
• More work on Detailed routes and the detail view.
• Better spawn-safe areas.

Feedback and bug reports

Report problems on GitHub. Please add the route mode, the Detail setting and the BepInEx log lines.

Changelog

0.2.3

• Routes go around huge rocks (Mistlands and Ashlands cliffs, big boulders, ice), in Fast and Detailed, also where you have not been yet. Rocks near you are measured in every biome, a route over one is drawn red.
• A place cut off by lava says so at once, without a long search.
• Routes leave buildings through their gates and doors, not through the walls next to you.
• The route map is ready a few seconds after you load in. For 20 s after that it finishes its work at full speed (LoadBoostSeconds, 0 turns it off), so the game may be slower for a moment.
• The route map is built again once after the update.

0.2.2

• Routes are found much faster, through portals 3 to 4 times faster.
• A route you follow is kept as the plan. Step off it and it rejoins quickly, take its portal and it goes on, a check every minute looks for a faster way.
• After a teleport off the route, the new route uses all your portals again.
• Detailed routes walk your floors, bridges, docks and stairs, go faster on paths and floors, and find the way around walls near the start and the goal.
• Lava is closed wherever it burns. In the Ashlands the rocks near you are measured, routes can cross lava over them (drawn red), and the route updates when they appear or are destroyed.
• The route map is built again once after the update (a few minutes).

0.2.1

• Fixed game freezes when you pick a new place while a route is still being found.
• Fixed routes at sea. On a ship, or far out at sea, the route sails from where you are.
• Routes keep clear of known sea rocks, shallows and gaps too narrow for your ship. A ship's size is measured once it floats near you.
• Sailing no longer cuts across small spits of land.
• A start on a rock, on lava or inside a building moves to the nearest open spot. Steep ground near the start and the goal is avoided again.
• A route is found far more often. When no way avoids rocks, trees, walls or harder biomes, the route says so.
• A route you follow no longer flips between two equally fast ways.
• The route updates every 5 s by default (was 1 s).
• Long trips to the Ashlands are found faster.
• Detailed routes avoid remembered trees, rocks and walls along the whole way.
• Comfort walks around swamp water, and avoids harder biomes by how much of them it would cross.
• More boats allows up to three boats on one trip.
• Lava is drawn where it burns, with a soft edge (LavaEdge).
• Tombs show how long ago each player died.
• The large map opens more smoothly, and the route map builds faster while the game is paused.
• Dedicated servers share terraforming and location ground too (not tested yet).
• Old route search settings were removed from the config.
• The route map is built again once after the update (a few minutes).

0.2.0

• New detailed map view on the large map and the minimap, drawn from a 2 m map of the world in the game's own look. It shows terraforming, paths, fields and paved ground. It is built in the background, with its progress on the panel (DetailedTerrain turns it off).
• Player buildings on the map and the minimap, seen from above in the colors of their material (Buildings: none, yours or all).
• New route map of the whole world at 2 m. A route of several kilometers usually takes under a second and follows the ground closely.
• Shortest is always the fastest walkable way. Only Comfort avoids harder biomes.
• Long sea trips use the wind on every leg, and More boats allows a second boat.
• Routes to the Ashlands use a drakkar, your own or one built at the shore, and walk around the lava.
• New Tombstones tab: every player's tombstone, searchable, with a route to it.
• In multiplayer the host shares the whole map data with guests (ShareMap).
• Panel texts shrink instead of being cut off.
• MaxPins also limits the numbered circles, so a zoomed out map is not crowded.
• With LivingMap installed, the panel explains how both maps work together (LivingMapMode).
• New defaults: the detailed map view, place names next to pins, and tombstones on the map.

0.1.2

• Two map modes, asked at the first large map opening. Explorer shows places, markers and routes for the land you explored and what lies close to it or close to you, even a little into the fog. Cartographer knows the whole world.
• Land read from a cartography table counts as explored (ExplorerShared). The map views draw it while the game shows the table's map.
• Explorer routes can cross open sea.
• Routes are searched in the background, so the game no longer slows down while one is calculated. The route tables build about three times faster and are kept on disk, so a world seen before has them at once.
• The minimap shows the chosen map view, as sharp as the large map.
• Unexplored shade: 0 turns it off, and the same value is lighter than before. The game's cloud look is optional and off by default (FogClouds), it does not match the game's fog yet.
• Faster map view switches (the map picture is kept, mist included), and the Layers page opens without a hitch.
• A ship farther than ShipMeters is used when it lies on explored or cartography land.
• With ShipPins installed, Navigator draws no ship or cart markers of its own.
• Moder's power counts as a tailwind on every heading when routes plan sailing, and a weak wind no longer starts reroutes.
• Spawn-safe areas use each object's own live radius.
• Settings are grouped into numbered sections. Your values move with them by themselves.
• Fixed about 300 font warnings in the log and a slow first opening of the Layers page.

0.1.1

• Multiplayer: a guest gets the host's full location search, portals and ships when both use Navigator 0.1.1. Only map data is sent, and the host can turn sharing off.
• Guests keep pins, portals, known objects and manual routes without host support. Routes and done marks stay personal.
• The location list is cached per world, so a rejoin needs only a quick check. The request waits until you have spawned.
• Done marks from 0.1.0 carry over automatically.
• Fixed portal tags naming the wrong portal at a hub of many portals.
• Fixed a white large map and a missing large-map route after the game rebuilds its map, for example after rejoining.
• Much less garbage and fewer stutters while the large map is open.

0.1.0

• First public beta, a work in progress.
• Search, layer filters and terrain views on the large map.
• Shortest and Comfort routes on foot, by ship or by a boat built at the shore, with portal pairs, the predicted wind and a 35 m swim limit.
• Detailed route detail as a work in progress. It reads the nearby real ground, rocks and trees. Player buildings are optional and off by default.