Joeys Wayfinder

Joey's Wayfinder

Author: JoeyBadManners

Version: 1.1.1

Joey's Wayfinder is a client-side map, discovery, and navigation overhaul for Valheim. It keeps the vanilla world intact while giving you a persistent, searchable Wayfinder layer for things you actually discover: resources, structures, spawners, traders, portals, vehicles, runestones, enemy sightings, graves, and your own custom pins.

The goal is to make Valheim's map dramatically more useful without turning it into a global reveal or requiring a server-side mod.

What's new in 1.1.1

Version 1.1.1 fixes a recurring 0.5-1.0 second frametime hitch reported on Valheim 1.0.12 and prevents Pin Manager text entry from leaking controls into gameplay.

• High-frequency input patches no longer request an allocated argument array on every Valheim input poll.
• Closed-map UI discovery no longer performs global Unity UI searches every 0.75 seconds.
• Boat, cart, and portal updates now consume lifecycle-fed registries instead of repeatedly searching the entire loaded scene.
• Structure/runestone registry snapshots no longer resynchronize every loaded location during each scan.
• The global Enabled=false setting now suspends all recurring Wayfinder runtime and UI work.
• The open Pin Manager now acts as a modal interface: search, rename, icon/type search, and boss-name fields receive typing without also moving the character, triggering actions, changing hotbar slots, or closing the map.

These changes do not alter Wayfinder's.wfd schema, saved marker identities, client-only networking model, or Valheim world saves.

The frametime correction was confirmed with a controlled A/B retest using the same server, world, and mod stack that reproduced the hitch in 1.1.0. The Pin Manager input correction was also confirmed in-game on Valheim 1.0.12.

Previous 1.1.0 fix

Version 1.1.0 updates Wayfinder for Valheim 1.0.7 and fixes the persistent random/duplicate portal-marker bug.

• A portal must now be a loaded, enabled TeleportWorld with a valid vanilla ZNetView and ZDO before Wayfinder will record it.
• The ZDO position is authoritative and must agree with the loaded scene object, preventing half-initialized or recycled objects from writing bogus coordinates.
• A stable ZDO identity is paired with a precise position alias, so repeated scans, relogs, portal renames, and link-state changes update one record.
• Destroyed portals are removed by their network identity, with a conservative position fallback.
• Old position-only portal records are preserved but hidden until a real portal confirms them. This prevents corrupt markers from returning while allowing legitimate legacy records to recover in place with their user metadata intact.
• Portal diagnostics are available through DebugLogging; they are disabled by default.
• Valheim 1.0's renamed map right-click path is handled without making the Harmony patch set fail at startup.

The previous 1.0.1 trader-position correction remains included.

Previous 1.0.1 fix

Version 1.0.1 fixes confirmed trader marker positioning. In 1.0.0, a confirmed Haldor, Hildir, or Bog Witch marker could end up at the generated trader-camp origin instead of the position used by Valheim's native trader pin.

• Confirmed trader markers now use Valheim's native trader pin position as the authoritative location when available.
• If the native pin is not available yet, the loaded trader's actual world position is used as the fallback.
• Generated trader-camp centers are used only for possible/candidate trader camp markers before a trader is confirmed.
• Existing 1.0.0 confirmed trader records automatically self-correct in place when the proper native trader pin is observed.
• The correction preserves the existing Wayfinder record, including favorites, tracking state, custom names, icon overrides, notes, and other user-owned metadata. No database reset or manual pin recreation is required.

Highlights

• Client-side only. No dedicated-server installation is required.
• Per-wor