VALHEIM WAYFINDER v1.8

ROGUEFREQ PUBLIC MAP AND PRIVATE BROWSER WORKSPACES
Public address: https://wayfinder.roguefreq.com (requires DNS activation).
The platform address remains available. No sign-in is required. Each browser
profile has its own anonymous workspace; pins, visited markers and settings
are saved locally by world. Tabs keep separate live map state. Ordinary browsing stores no map data or game telemetry in a hosted session.
Optional sharing sends the selected map snapshot to the hosted service.
This is not an account or automatic cross-device sync. People sharing a browser profile share its
saved workspace. Storage blocking uses a temporary in-memory workspace.
Export/import pins to move to a new browser, device or website address.

New visitors start with an empty map and choose a seed, demo or local game.
The bundled owner-seed snapshot is removed; predictions generate on demand.
The bridge accepts only exact RogueFreq, platform, configured and local map
origins. It still listens only on loopback, with session tokens for writes.
The public website never connects another visitor directly to your gaming PC.
A shared view can show your position on a phone while the host tab stays open;
it does not give that phone access to bridge commands.

Install: copy Wayfinder into BepInEx/plugins in your own Valheim profile.
Optional updater: run Update-Wayfinder.ps1 -ProfilePath <your-profile-folder>
with Valheim closed. The updater requires your path and backs up the DLL.


SHARE A SESSION
Map tools > Share session (More on phones) creates a read-only invitation.
Choose 1, 6 or 24 hours and whether to include your Viking position/name.
The host publishes about every 3 seconds while its tab is open. Guests can
follow the host camera or browse independently. Pause updates retains the
last view; Stop sharing revokes the invitation. Reloading pauses publishing.
Owner credentials remain in this tab session storage, never the invite link.
Guests see the seed, up to 500 saved pins and 5,000 visited-marker IDs, camera
and optional position. They cannot edit the host map or issue game commands.
Guests do not overwrite their saved workspace. Exporting the visible pins
is possible; anyone with an invitation can retain data they already received.
Threats, animals, boats, alerts, routes and live terrain edits are not relayed
in this version. Seed terrain is generated independently in each browser.
Links are unlisted capabilities, not user accounts. Read/write capabilities
are distinct and hashed at rest. Invites expire at the chosen time, including
while paused; expired rows are removed in bounded cleanup on new sessions.
Anonymous creation is rate limited; request size and marker counts are bounded.
The mod local map uses the hosted API for sharing; offline sharing is unavailable.

FISHING AREAS
Open Map tools > Fishing areas (More on phones). Choose any of the twelve
vanilla fish species to see its bait and estimated places to look. Shaded
water uses fresh-seed biome, shoreline and broad depth heuristics. It does
not show exact spawns, guarantee stocked water, or account for terrain edits.

The updated bridge also observes loaded fish within 400 m in three dimensions.
Solid fish symbols mean recently observed; gray means last seen. Records
include species, observed quality and whether the fish was out of water.
Unknown/modded fish keep their actual identity with unknown bait. No new
fish are spawned or caught. Up to 256 nearby fish are scanned per tick, with
800 persisted fish records per world; truncation and scan errors are shown.

Sightings are grouped into local areas and can be filtered to Live only or
Last seen. Old or removed fish records never count as live. Save waypoint
keeps a favorite spot, with bait and source noted in its description.
Tetra uses Frost Cave entrance candidates with lakes explicitly unconfirmed;
surface terrain cannot reveal interior lakes. Interior fish observations
use projected coordinates, not an entrance.

The demo includes live Perch/Trollfish and remembered Tuna observations.
Its fish and terrain are simulated. Phone controls use a separate panel,
large touch targets and selected-spot cards to keep the map readable.

Reference: https://valheim.fandom.com/wiki/Fish
Bait: https://valheim.fandom.com/wiki/Bait
Installed-game DLL compilation, bridge/protocol checks, habitat/worker tests
and browser checks passed. Live fish scanning still needs verification on
your next game launch. Restart the modded profile to load bridge v1.7.0.


MOB IDENTITY AND ESTIMATED DANGER
Threat triangles now carry short type identifiers: GD Greydwarf, TR Troll,
DR Draugr, GB Greydwarf brute, GS Greydwarf shaman, DA Draugr archer and DE
Draugr elite. Tap any marker or name tag for its full type, stars, health,
distance and targeting state. The radar list also shows the exact prefab.

Display weights give a regular Greydwarf a small muted Minor marker, a Draugr
an amber Moderate marker, and a Troll a larger orange High marker. Extreme
markers are larger and pink. Stars raise a known type's display tier, capped
at Extreme. Targeting adds a red outer ring and does not change danger tier.
Unknown/modded prefabs remain Unrated, using ? and purple, and are given
visible priority. They are never assumed minor or matched by name substring.

These are visual heuristics based on known prefab families and stars, not a
combat damage model. Your gear, armor, skills, health, mods and difficulty are
not used to calculate a survival estimate. Hostility/target state still comes
from the game's AI; the type table never invents enemies or changes game AI.

The radar sorts by danger first, then targeting and other ties. Smart map
labels favor higher danger instead of filling the phone with minor mob names.
Minor mobs keep a coded marker and remain selectable. High-priority symbols
paint above lower-priority symbols. The phone's compact threat button names
the highest estimated danger in the selected radar radius; the footer retains
the total hostile count. Selection hides if that threat leaves the visible
radar feed. The legend explains colors, letters and the separate red ring.

The demo now includes a regular Greydwarf, Draugr and Troll together, alongside
the starred wolf, for comparison. Checks cover type codes, tier ordering,
stars, independent targeting, variants, unknown/prototype-like IDs, range and
AI filtering, scarce-label priority and SVG identity. Browser checks cover
desktop radar ordering, 360/390 px phone markers, full mob detail cards and
switching between 100 and 200 m radar ranges. No browser errors observed.

MAP SYMBOLS, LABELS AND PHONE LAYOUT
The map now uses shared vector symbols across markers, the legend and waypoint
rows. Gold arrow: your Viking and heading. Paw: animal (green means tamed).
Coded triangles identify hostile mobs. Their size/color estimate danger; a
red outer ring separately means targeting you. A hostile animal has one threat marker, rather than
both a paw and a triangle. Sailboat: boat; person: crew; mint outline: player
construction. Boat colors show hull condition; gray means last observed.

All map layers share collision-aware name tags with leader lines. Smart labels
prioritize your selection, higher estimated danger, rare animals and tracked boats,
and keep labels away from other symbols, names and visible controls. Phones
show at most four smart tags and desktops at most twelve. Tap a symbol or name
tag for a compact detail card. Map tools > Symbols & labels contains the full
legend and Smart / Selected only / More names choices. More names still avoids
collisions. Recommended base/camp labels use the same placement rules.

The page adapts to viewport size, touch capability and short landscape screens;
no user-agent string or permission is needed. Phones use a full-screen map,
compact hull/threat buttons, 44 px controls, safe-area spacing and a bottom bar:
Map, Places, Radar, Boats and More. Places and tools open scrollable panels.
Large wind/status panels and demo controls no longer cover the phone map;
find wind, the full hull tracker, alerts, animals and demo controls in More.
Desktop secondary tools also live in Map tools.

Touch controls: one finger pans, two fingers pinch/translate, double tap zooms
in and holding the map for 600 ms opens a new waypoint. Multitouch cancels pin
creation; cancel events clear gesture state. Zoom buttons remain available.
Desktop drag, wheel zoom, keyboard panning and double-click pin creation remain.

Phone demo and seed exploration work independently. The current game bridge
still listens on the game PC's loopback address; this layout update does not
add phone-to-PC live pairing or expose the bridge on a network. The connection
help states this when the compact layout is active.

Validation: label tests cover prioritization, bounds, collision avoidance,
selected-only mode and deterministic placement. Pinch math checks cover anchor
preservation, translation and zoom limits. Browser checks cover 360 px and
390 px portrait, short landscape and desktop layouts, marker/tag selection,
places, navigation, radar, boats, legend, label controls, dragging and zoom
buttons. No horizontal overflow or browser errors observed. Physical handset
multitouch has not been verified.

INTERACTIVE DEMO SIMULATION
Choose Explore demo to try the visibility tools without Valheim. Demo animals,
threats, two boats, crew, wind, construction and mineral observations move or
change in a fictional world. An ambient 90-second scenario spots a two-star
boar, starts a raid, damages a boat through low/critical hull, repairs it and
mines copper. This is a UI simulation, not Valheim AI or a seed prediction.

Use the demo controls to pause/resume, reset, start a raid, spot a rare boar,
hit or repair the boat aboard/tracked, board/leave the Karve, unload/reload the
Longship or mine copper. Use Visibility > Boats to select/follow a boat; gray
means last seen after unloading. Animals, threat radar, world changes, base
status, crew, resources, sailing and custom watches share the demo feed.
Alerts and watches can be configured inside the demo; changes affect only that
in-memory session. Reset restores defaults. Exit clears simulated feeds and
restores the original seed. Demo writes never reach the game bridge, native
notifications or live world archives; it runs only while the map page is open.
Native in-game HUD/message options require live mode. Sound and browser banners
can be tested in the demo. ?demo=1 opens the simulation directly.

Validation: pure scenario checks cover feed normalization, movement, pause,
raids, damage/repair, last-seen boats, boarding, watches/cooldowns, alert filters
and independent reset. Desktop/mobile browser checks cover manual controls,
tracking, session-only settings, history, watches and clean demo exit.

BOAT TRACKER AND HULL INDICATOR (v1.6)
Open Visibility > Boats to see observed rafts, karves, longships and drakkars.
Each boat retains its stable network ID, last observed position and hull.
Track boat saves a selection by world across clean restarts. Show boat on map
centers its marker. Follow tracked boat follows fresh position observations;
manual pan/zoom, keyboard map movement or Follow player ends boat follow.
Unloaded boat follow pauses until the boat is observed again.

The boat aboard takes priority over your tracked boat in the compact map badge
and optional in-game hull bar below the minimap. Green is healthy, amber is
30% hull or below and red is 15% or below. A measured fresh hit flashes the map
indicator and can send an in-game alert. Damage, low-hull and critical alerts
apply only to the boat aboard or your tracked boat and honor the Alerts master
switch. A short cooldown prevents repeated notifications on each scan.

Hull is read from the loaded boat's WearNTear condition about once a second,
within 400 m, at most 128 boats per scan. Unknown health is never shown as 100%.
Gray hull/last seen is a saved observation, not live condition. Unloaded boats
cannot report new movement, damage or repairs. A confirmed network deletion
marks a boat removed; disappearing from view alone does not mean it was sunk.
Tracking does not stream distant boats or modify boats, health or world saves.
Save boat settings controls the in-game indicator and damage notifications.
The optional in-game bar displays information and does not capture mouse input.

VALIDATION FOR v1.6
Built against the installed Valheim/Unity/BepInEx DLLs. Damage detector tests
cover hit deltas, cooldowns, threshold escalation, repairs, observation gaps and
alert eligibility. Protocol tests cover boat IDs, tracking commands, settings,
native HUD rendering, damage alerts and persisted selection. Browser checks
cover live/stale/unknown hull, filters and normalization; simulated UI checks
cover tracking, settings persistence and last-seen behavior. These checks use
test doubles. Actual sailing, hull hits and native HUD placement still need
verification after the next game launch.

WORLD VISIBILITY
Open Visibility above the map for eight connected tools. Built construction,
live hostile creatures, public crew positions and accepted game pings are also
drawn on the map; each layer can be toggled. Click a built footprint to open
its base summary. Show on map centers and marks the selected observation.

THREATS
North-up radar uses the game's BaseAI.IsEnemy, current target and alert state,
not a guessed monster list. Choose 100, 200 or 400 m. Coded markers estimate
danger; red outer rings indicate targeting you. Health and structure targets are
shown when readable. Unknown AI readings, failed scans and truncation are
identified. Only loaded creatures can be detected; the nearest 768 are retained.

CHANGES AND RESOURCE TRACKING
The mod remembers observed construction, deposits, boats and graves by world.
First observed is explicitly different from newly created. Health drops greater
than eight percentage points between scans, low-fuel crossings, portal-link
changes, resource section changes and player reports enter a 150-event log.
ZDOMan's existing network-deletion delegate confirms actual removal, preserving
other subscribers. A missing scan object is never proof of destruction.

Mineral deposits can be present, partly mined, depleted by their loaded hit
state, removed by a confirmed network deletion, or player-reported depleted.
Deletion can leave fractured/replacement rocks, so whole-deposit exhaustion is
not inferred from a single deleted rock. Old observations remain last seen.
Later loaded observations can supersede reports. Dungeon clearance is a
separate manual report; visiting or passing a dungeon does not clear it.

BUILT AREAS AND BASE STATUS
Only Piece.IsPlacedByPlayer (creator > 0) contributes construction. Adjacent
occupied 20 m cells form approximate footprints; natural/generated ruins are
excluded. These are construction areas, not territorial ownership claims.
Loaded pieces expose condition, fireplace fuel and portal connections. Summaries
show damaged pieces (<75%), critical pieces (<30%), fires at/below 25% fuel,
unlinked portals, AI targeting known pieces and nearby tamed/hungry animals.
Unloaded areas do not report a healthy/zero-warning condition. Dashed borders
include remembered or server-stored pieces. Watch this area pre-fills a fixed
base-point watch. Ping area in game is an explicit ordinary shared map ping.

When hosting a world locally, a time-sliced server ZDO index also locates stored
player construction outside the client's loaded radius. Stored health is not a
live simulation. The index samples at most 100,000 server records per pass,
roughly once a minute. The observation book retains at most 6,000 objects,
prioritizing loaded client observations over extra stored server records.
When joining a remote/dedicated server, the client cannot index that server's
unloaded world: constructed areas it has not observed remain unknown. This
release does not install a remote dedicated-server plugin or open a network port.

CREW
Remote positions use ZNet's public-position list, excluding players who do not
share their location. Original server-position update age is unavailable and
is labeled accordingly. Health/death state is added only for loaded characters.
Accepted ordinary game pings are retained for two minutes. Ping my position
in game and Ping area in game send normal Valheim pings only when clicked;
there is no automatic ping broadcast. Observed graves and boats retain their
last position and confirmed removals. No private-position discovery is added.

SAILING
The wind arrow points toward the wind's flow; the sailing view also states the
opposite "from" direction, normalized strength and current environment. Aboard
your boat, it shows signed forward speed, heading, sail setting and native wind
assistance. Negative speed means astern. Existing sailing/landing route guidance
continues to work. Current wind is visibility information, not a weather forecast
or a promise that an existing route/ETA is optimal for wind.

CUSTOM WATCHES
Save up to 20 watches per world for creatures, structural damage, low fireplace
fuel, disconnected portals or present minerals. Choose your position, your
current boat or a fixed map point as anchor, with 25–400 m range and 60–3600 sec
repeat cooldown. Creature watches match prefab patterns and minimum stars;
mineral watches match names such as Silver deposit. * is a wildcard. Other
conditions use the percentage threshold or portal state. Boat watches wait
until aboard. Fixed-point watches still require relevant objects to be loaded
near your character. Remembered/stored condition cannot trigger live watches.
Matches use Alerts, including native messages when enabled. The Alerts master
switch pauses custom matches too. Unstuck remains a separate unchanged plugin.

SOURCES, STORAGE AND LIMITS
Readings are labeled live/loaded, remembered, server record, player report or
confirmed network removal. Live visibility snapshots expire after six seconds;
threats and crew clear when stale, while remembered construction remains dashed.
Loaded construction scans are capped at 2,500 pieces within 400 m, roughly
every three seconds. Crew, wind, threats and watches update about once a second.
Partial/error states remain visible instead of implying a clear or healthy area.

Observations, reports and watches are saved in the plugin's observations folder
under a hashed world filename, normally every 30 seconds and on clean exit.
Each archive validates its world and seed; loaded observations restore as
remembered until sampled again. The updater preserves that observations folder.
Nothing uploads this history. /api/visibility is a scoped read snapshot;
/api/visibility/command uses the authorized Origin/session token, bounded JSON,
request IDs, world/seed/character checks and main-thread execution. Retries do
not duplicate native pings. Reports/preferences do not modify world objects.

VALIDATION FOR v1.5
Built against the installed Valheim/Unity/BepInEx DLLs. Model and protocol tests
cover source/freshness, observed vs removed state, condition/fuel, ownership,
public positions, AI targets, wind/boat state, watch anchors/cooldowns, persistence,
server-record indexing, authorized commands, ping retries and logout cleanup.
Browser checks cover the seven tabs, saving/reloading a fixed-base watch,
separate dungeon clearance, map centering, construction overlays and a 390 px
mobile layout. Prior navigation, pins, alerts, visits and planning checks pass.
The HD terrain worker now initializes WASM once and serializes messages/seed
switches, fixing the race exposed by construction zoom; a delayed-init regression
and real browser zoom check pass. Live game verification still needs a launch.

RARE EVENT ALERTS
The mod now shows native center-screen messages for two-star-or-higher wild
animals, raids in your current event area, sea serpents, leviathans and loaded
Hildir miniboss encounters (Brenna, Geirrhafa, Thungr and Zil). This works with
the browser closed. Open Alerts above the map to configure the categories,
animal species, one-star/two-star threshold, wild/tamed filter, and 25–400 m
encounter radius. Two visible stars means internal game level 3.

Save alerts to game persists these preferences in BepInEx/config/
local.nick.valheimwayfinder.cfg, under [Alerts]. The master switch pauses all
new encounter alerts; Show messages in Valheim controls native HUD messages.
Map banners and opt-in map sound apply only to this browser session. Sound
requires clicking Enable map sound and may be suspended by the browser.

Only alive, loaded creatures can be detected, with a maximum 400 m horizontal
scan. A leviathan must be loaded and not have left. Raid alerts use the game's
actual random-event boundary, independent of the creature radius; remote raids
and forced boss-combat events are excluded. This does not predict future raids.
Detection uses game data rather than seed-generator POIs.

Each matching creature alerts once while present. Its identity is remembered
through brief range exits/unloads; it can notify again after ten minutes absent.
Native HUD messages combine bursts and have an eight-second cooldown, with
raids taking priority. The map keeps up to 40 sightings for the current world
and character session. Show last sighting centers the map at the recorded
position, which may no longer contain the animal. History clears on logout or
world/character change and is not written to browser storage or uploaded.

The /api/alerts endpoint publishes a fresh scoped snapshot. POST to
/api/alerts/settings requires the authorized map Origin, a per-launch session
token, JSON, a request ID and matching world/seed/character. Requests are size-
bounded, queued, validated and applied on the Unity thread. The endpoint only
changes Wayfinder alert preferences. There are no game entity mutations.

VALIDATION FOR v1.4
Built against the installed game and BepInEx assemblies. Detector/protocol tests
cover star levels, range, tamed/species/category filters, repeated sightings,
native HUD messages, raid area entry, remote raids, preference authorization,
main-thread application, invalid/wrong-world writes and logout clearing. Browser
data tests cover freshness, scope, malformed rows and replay suppression. The
browser UI was tested against a simulated game feed, including save/reload,
pause/resume, last-sighting centering and a 390 px mobile layout. Actual live
encounters still need verification after launching Valheim with this update.

SEND WAYFINDER PINS INTO VALHEIM
Open Send pins above the map. Choose recommended bases/camps, mineral deposits,
dungeons, miniboss sites, bosses, traders and/or your saved waypoints. Expand
Review selected pins to inspect the names, coordinates and source. Send adds
the selected pins to the active character's in-game map. Open Valheim's map
with M to see them. This requires the v1.3 DLL and a fresh game launch.

Recommended areas, bosses, miniboss sites and traders are selected across the
whole world. The dungeon range defaults to 2 km from your live Viking; choose
500 m, 1 km, 5 km or Whole world instead. Hildir's special crypt/cave/fortress
locations are classified as miniboss sites; their pins mark the dungeon site,
not an exact boss position inside the dungeon. Trader predictions include
candidate spawns, not a guarantee every listed trader will exist.

Large selections run automatically in batches of up to 500 pins, with a maximum
of 5,000 pins per selection. The preview remains fixed while an import runs.
Repeated imports skip saved pins with the same [WF] name, icon and position
within 1 meter. They do not overwrite, delete, rename or change the checks on
existing pins. New pins use normal game icons and m_save=true. Native map data
is saved through Valheim's normal map-save method. You can check or remove these
pins in game independently of Wayfinder; this is an explicit one-way import,
not ongoing bidirectional synchronization. No import runs automatically.

MINERAL DEPOSITS
The mod scans loaded MineRock, MineRock5 and supported Destructible mineral
families every three seconds, within 400 horizontal meters of the player.
Recognized families include copper, silver, tin, obsidian, iron scrap and
flametal. Destroyed hit areas are excluded. Silver can be detected underground
when its vein is loaded. Unloaded deposits are unavailable, regardless of the
world seed. This does not generate ore veins that the game has not loaded.
Deposits also appear in Wayfinder's Resources filter while observed nearby.

Live mineral observations expire after eight seconds or when the world changes.
Once imported into Valheim, their saved pins remain until you check/remove them;
they are last-known deposits and do not disappear automatically after mining.

IMPORT VALIDATION
The pin-write endpoint accepts only the existing local/hosted Wayfinder origins,
requires a per-session token and unique request ID, and queues work onto Unity's
main thread. It validates the whole batch, world, seed and character before adding
anything. A world or character switch rejects the pending import. Other HTTP
endpoints remain read-only. The HTTP worker never calls game APIs directly.
All scans, existing-state preservation, persistence flags, duplicate handling,
world/character rejection, and browser batching were tested with simulated game
objects; an actual in-game pin import needs a v1.3 game launch to verify.

UPDATE
Close Valheim, then run the bundled Update-Wayfinder.ps1, or replace the existing
Wayfinder folder in your profile's BepInEx/plugins folder with this one. The
updater requires your own mod profile path and backs up the previous DLL.
It refuses to replace a DLL while Valheim is running. Relaunch the modded profile,
enter the correct world/character and refresh the map before using Send pins.

NEARBY ANIMALS AND CREATURES
Open Animals above the map to view loaded animals around your live player.
Choose a range from 100 to 400 meters, a species, or wild/tamed status. The default
view shows animals; All creatures also includes other loaded non-player creatures.
Rows show horizontal distance, direction, stars and taming status. Click a row or
moving paw marker to inspect its current coordinates and center the map on it.

This needs the v1.2-or-newer DLL (v1.3 is included), not just a browser refresh. Close Valheim and run
Update-Wayfinder.ps1 beside the extracted Wayfinder folder. Pass your own mod profile path, backs up the old DLL with a .bak extension, and copies the
new plugin and web files. You can instead copy Wayfinder into the active profile's
BepInEx/plugins folder while the game is closed. Then relaunch your modded profile,
enter your world and refresh the local map. The updater refuses to change files
while Valheim is running; it never closes the game or edits a world save.

The mod reads Character.GetAllCharacters() on the Unity main thread once a second,
excluding players, dead characters and creatures more than 400 horizontal meters
from the player. At most the closest 768 loaded creatures are sent. Each snapshot
includes world identity, capture time, stable lifetime ID, prefab/name, position,
level and tamed status. A creature scan error does not interrupt player tracking.

Only creatures loaded/synchronized to your client can appear. A 400 m range is a
filter, not a promise that the game loads that entire radius. Unloaded areas and
future animal spawns cannot be predicted by this feature or the seed generator.
Missing/dead/unloaded creatures disappear from the next snapshot; snapshots older
than four seconds and snapshots from another world are discarded. Creature data
is transient, kept separate from saved pins, visited checks and generator POIs.
Other players are never included in the creature endpoint.

Animal recognition uses the game's AnimalAI component, AnimalsVeg faction and
known animal families (including wolves, lox, asksvin, bears and seals). Mods with
different AI or prefab names may need All creatures to appear. This detects loaded
Character entities; fish and ambient birds without Character components are not
covered. Detection does not imply an animal is safe, visible or reachable.

LIVE ROUTE GUIDANCE
Select any biome, boss, or camp route and choose Guide from my location.
The Guide route button above the map also starts guidance for the highlighted
route. The live mod connection supplies your position twice a second. Guidance
connects your actual position to the selected route using the same sampled
walking/sailing terrain model, then follows its remaining path to the destination.
This is not a straight-line arrow to the destination or back to the main base.

The guidance card shows remaining route distance, walking/wading and sailing
totals, a direction arrow relative to your in-game heading, and the next launch
or landing point with along-route distance and X/Z coordinates. Click that shore
stop to zoom to it; Follow player resumes the moving map. Fit route includes the
connection from your position. Launch here / Land here appears within about 25 m
along the route. The next shore stop advances as you pass it.

Leaving the followed path by more than 85 m triggers a new terrain connection
to the remaining selected route (at most once every three seconds). Rejoin route
requests one immediately. Walking backward increases the remaining distance;
arrival needs both route progress and proximity within 30 m of the destination.
Guidance pauses when live position is unavailable or older than 2.5 seconds,
resumes on reconnection, and stops when you change world, seed, or analysis.
Stop route guidance ends tracking; the selected route remains highlighted.
Seed exploration and fictional demo positions cannot start live guidance.

Routes and shore coordinates remain approximations on a roughly 41 m grid.
They do not account for wind, actual ship clearance, hazards, world edits or
portals. Verify the suggested launch/landing ground in game. This update only
changes the local web files: refresh the map; no game restart is needed.

CAMP CONNECTIONS AND BASE ROUTES
The two camp links appear automatically after building analysis. Solid gold
sections are walking/wading; dashed blue sections are sailing. Click the yellow
main-base house, its label, or its highlighted area to open Routes & distances.
The Biomes tab lists each qualifying region with total, walking, and sailing
distance. Click a destination to highlight and fit its route. Bosses and Camps
tabs provide the same detail for the six main bosses and both staging camps.
You can also open this panel with Routes & distances in the building planner.

Numbered circles identify launch/landing transitions for a highlighted route.
The matching list gives approximate X/Z coordinates; click a shore stop to zoom
in. Close the panel to inspect the map while keeping the route highlighted.
Clear highlight removes the selection. Camp links can be hidden independently
from building zones with the Camp links checkbox. All goal routes displays all
destinations for the selected building zone.

Displayed travel routes minimize sampled distance plus a 350-meter equivalent
cost per walking/sailing transition, avoiding unnecessary island hopping. Listed
distances are physical path length and do not include this preference cost.
Biome destinations still need to pass both substantial-area and width thresholds.
Base placement continues to use the original summed shortest-distance score;
the practical travel route can be slightly longer. Shore crossings interpolate
the 1.5-meter water-depth threshold between samples. Sailing labels are guidance,
not a surveyed shipping channel or a simulation of swimming/ship navigation.
Wind, hazards, portals, bridge construction and world edits are not simulated.

On R7mQ2vL9xK with default recommendations: the northern connection is about
12.22 km (1.99 km walking/wading, 10.23 km sailing); the Ashlands connection is
8.60 km (1.82 km walking/wading, 6.78 km sailing). Each has two sailing legs.
Refresh the local map to load this update; no game restart is needed.

DETAILED TERRAIN AND BUILDING ZONES
HD terrain redraws the current viewport at 1024 x 1024 pixels as you pan or zoom,
showing relief and contour lines rather than stretching the 512-pixel overview.
The small terrain badge reports the current meters-per-pixel. Cursor readouts
show the predicted biome and elevation. HD terrain is a fresh-world seed prediction;
switch it off to see the original game/overview terrain underneath.

Build zones opens a separate planner with three colored search areas:
Yellow main base: Meadows through Mistlands plus Eikthyr, The Elder, Bonemass,
Moder, Yagluth, and The Queen. Ashlands and Deep North do not bias this base.
Blue northern staging camp: access to substantial Deep North and Fimbulbringer.
Red Ashlands staging camp: access to substantial Ashlands and Fader.

Default qualifying biome size is 0.25 square kilometers, with an interior at least
150 meters wide. Both connected area and interior width must pass. Distant thin
fingers attached to a larger region do not count as substantial access: route goals
are inside the broad core. Shallow marsh water (up to 2 meters deep) counts as swamp;
deep offshore seabed does not. Raising thresholds can make a goal unavailable;
the planner reports that rather than ignoring the missing biome.

The planner minimizes summed shortest route distances to the nearest qualifying
core of each biome and nearest location of each boss type. Boss distance has an
adjustable weight, default 1. Main-base candidates default to Meadows in a substantial
region. You can choose Black Forest, Plains, or any eligible dry biome instead.
Camps use flat coastal dry land outside their target biomes, within about 250 m
of water. Suggested center samples are at least 3 m above sea level, have low
sampled slope, and stay at least 150 m from known boss markers.

Routes are approximate walking + sailing paths on a 512 x 512 grid (~41 m/cell),
with steep sampled cliff steps excluded. They do not simulate weather, ships,
portals, enemy threats, construction, or terrain changes. The colored border
contains nearby ground with access scores within 5% of the best sampled candidate;
it is a search area, not a guarantee every square meter is flat or unobstructed.
Select a destination row to inspect its route, Zoom to area to view a zone, or
Save waypoint to keep its suggested center as a personal base pin.

On seed R7mQ2vL9xK with the default settings, the sampled suggestions are:
Main base: X 1251, Z -1456 (Meadows).
Northern camp: X -8470, Z 4204 (Black Forest).
Ashlands camp: X -3056, Z -7403 (Black Forest).
These results include all six main biomes and six main bosses, plus both
separate late-game biome/boss pairs. No game restart is needed for this update.

AUTOMATIC VISITS
Automatic check-off is enabled by default while the map is connected to live
game tracking. A marker is marked visited when your horizontal position passes
within 12 meters of it, or stays within 35 meters continuously for 6 seconds.
Expand Auto check-off to turn this off or change the distances and duration.
This detects a visit, not whether you cleared a dungeon or collected its loot.
The browser map must remain open and connected for automatic visits to run.

The check runs on every successful live position update, even for markers hidden
by a filter or the POI-layer toggle. Seed exploration and demo mode never mark
automatic visits. Large position jumps do not trace a path across the map, and
long signal gaps reset the stay timer. Visited state persists in the same per-world
browser storage as manual checkboxes and works with Hide visited.

Undo last automatic check-off restores the most recent batch. Manually unchecking
or undoing holds those markers unchecked until you leave their surrounding area.
The last-batch Undo button lasts for the current page session; older changes can
always be reversed with individual marker checkboxes.

Validated pass-by distance, paths between successive samples, timed stays, leaving
the area, signal gaps, world changes, teleport jumps, settings, and manual overrides.

AUTOMATIC SEEDS AND VISITED MARKERS (2026-11-14 update)
Enter a seed in Explore any seed and press Enter or Load seed. Wayfinder
generates its terrain overview and POIs automatically in a background worker.
Bosses/traders arrive first, followed by the remaining location types.
Generation predicts a fresh Valheim 1.0 world; upgraded or modded worlds may
differ. Game registry locations are preferred when available.
Predictions are cached in IndexedDB. The original seed-export fixture remains
included, and existing imports are supported as an optional override.

The pinned Vegvisr runtime loads from jsDelivr on first use; an internet
connection is needed to load it. Seeds and positions remain in the browser.
See GENERATOR-NOTICE.txt for the source and revision.

Check the box beside any marker, or Visited in its destination card.
Checked markers display a checkmark and fade; Hide visited removes them from
both the map and list. Progress is stored per actual world ID while tracking,
and per seed while exploring. Export/import pins includes visited progress.
When exploring another seed, player tracking is suspended in the map view.
Use Return to live world to resume the running game's map and guidance.
Seed exploration URLs preserve the chosen seed when reloaded.

Validated automatic generation for two seeds, cached loading, visited state
after reload, hide-visited behavior, and separate progress between seeds.
All 12,357 predictions for R7mQ2vL9xK matched the map-generator export within
10 centimetres. This is a browser-only update: no game restart is required.

A personal Valheim expedition map with automatic player tracking, an in-game
terrain overview, per-world waypoints, and straight-line distance/bearing.

QUICK START
1. Install BepInEx 5 for Valheim, if your mod profile does not already use it.
   https://thunderstore.io/c/valheim/p/denikson/BepInExPack_Valheim/
2. Copy the Wayfinder folder from Wayfinder-Mod.zip into BepInEx/plugins in
   your active Valheim mod profile. Keep ValheimWayfinder.dll and web together.
3. Launch Valheim through that profile and enter a world.
4. Open http://127.0.0.1:8765 in a browser on the same PC.
   The live map does not require this chat or the hosted website to be open.

Your installed Modded Valheim profile already has BepInEx. If the companion
has been staged there during setup, just restart Valheim through that profile.
There is no server-side mod to install.

MAP CONTROLS
Drag to pan. Scroll or use +/- to zoom. Double click to add a waypoint.
Use Pin here for a waypoint at your Viking's current position.
Click a pin or the arrow beside a waypoint to select a destination.
Follow player centers the map on your Viking. Moving the map turns follow off.
Use the pencil to edit or delete a pin; use the circle to mark it visited.
Export pins to back them up. Imports merge into the same world only.
Pins are browser-local and separate for each in-game world ID. Hosted and
local maps have separate browser storage; export/import transfers pins.

LIVE TRACKING
The bridge listens only on 127.0.0.1:8765. Its data endpoints are read-only;
the explicit pin-import endpoint adds only validated, user-selected map pins.
Position updates
twice per second while a local player exists. Leaving the world clears the
live location and terrain. Pins persist in browser storage.
The hosted website can connect to the local bridge if the browser supports
and permits local network access; use the local map for reliable connectivity.
No game state is uploaded to the hosting service.

TERRAIN AND LIMITS
Terrain comes from the running game's WorldGenerator, rather than predicting
a seed externally. A full terrain overview is generated once per world session
at 512 x 512 pixels across +/-10,500 world meters (~41 meters per sample).
Sampling is spread across frames with an approximately 2ms per-frame budget;
image encoding at completion may cause a brief pause. It reveals full terrain.
Small channels and narrow land bridges may be below the map resolution.
This is a biome/sea-level overview, not the game's rendered minimap. It does
not include player-made terrain changes or buildings,
automatic safe routes, automatic in-game pin synchronization, or other players.
Guidance is a straight line, so check the coastline before following it.
Demo mode is fictional and never represents the entered seed.

VALIDATION
Compiled successfully against the installed Valheim Unity 6 and BepInEx 5
assemblies. Required game API names/signatures were checked in the installed
assembly_valheim.dll. 11 navigation/import checks, 14 bridge protocol checks,
and POI parsing/import checks
passed. Desktop/mobile layouts and waypoint persistence were checked in-browser.
Bridge tests use Unity/game test doubles; full in-game movement and terrain
generation for the original bridge have been verified in the running game.
The v1.1 location-registry endpoint still needs its first in-game verification.

POINTS OF INTEREST
Seed R7mQ2vL9xK includes 12,357 real location predictions exported from
valheim-map.world on 2026-11-14 (generator 11.2, world version 1.0.7).
These load automatically, including with the original v1.0 tracking bridge.
The local map frontend was updated while the game continued running.
Use the Bosses, Traders, Dungeons, Resources, and Landmarks filters, search by
name/prefab, click Navigate, or use + to save a location as your personal pin.
The overview reduces overlapping POI icons; zoom in or search to see more.
Trader markers are candidate spawn locations, not a guarantee all will exist.
Generator predictions can differ for upgraded worlds and generation mods.

For another seed, use Import generator POIs, open that seed, choose Download
Map > All Data > Download Data, and select the ZIP or extracted locations.json.
ZIPs are streamed so terrain tiles are skipped. Import is browser-local.
The seed in map.json is checked; for locations.json alone, confirm the seed in
the import dialog because that file has no world metadata.

The v1.1 DLL in this package additionally reads ZoneSystem.GetLocationList()
every ten seconds without generating or placing locations. Game locations
take precedence over matching imported predictions. Remote-server clients
may not receive the full location registry; use a generator export in that case.
If the game is running, its loaded DLL stays at its current version until a
restart. Close the game before replacing the DLL from this package.

TROUBLESHOOTING
Check BepInEx/LogOutput.log for "Wayfinder ready" or a Wayfinder error.
If the port is busy, close another Wayfinder instance. The bridge port can be
changed in BepInEx/config/local.nick.valheimwayfinder.cfg; open that port in
your browser. The hosted frontend's Connect button uses the default 8765 port.
The local map is designed for the default port; leave it at 8765 for full support.
No administrator access, firewall rule, or URL ACL change was used during checks.
If a Valheim update changes an internal game API, tracking may stop and report
an API mismatch. Reflection is used to avoid distributing proprietary game DLLs.

REMOVAL
Close Valheim and remove only BepInEx/plugins/Wayfinder. No game saves are edited.

BUILD FROM SOURCE
With a .NET SDK installed: dotnet build mod/Wayfinder.csproj -c Release
After editing client helpers: node build-client.mjs
This restores BepInEx.Core 5.4.21 and UnityEngine.Modules compile references
from NuGet/BepInEx's NuGet feed. No proprietary game assemblies are bundled.
For an exact installed-game build, set ValheimManaged and BepInExCore MSBuild
properties to the game's Managed folder and the profile's BepInEx/core folder.

REFERENCE
Inspired by https://valheim-map.world/; not affiliated with that project or
Iron Gate. The full seed generator remains available at that website.
