ValheimOne 0.13.2

A reliability fix. One vanilla field that ValheimOne could no longer read would stop the entire plugin from loading — this release contains that failure to the single optional feature that depends on it.

What was wrong

ValheimOne reads two private fields on Valheim's Minimap for the optional shared-exploration feature. Both were resolved eagerly, the moment the class was first touched, and the class is constructed during plugin startup before any per-feature error handling is in place.

So if a Valheim update changed the shape of either field, the resulting exception escaped plugin startup entirely and nothing loaded — live map, web console, server query, Discord notifications and the activity log all went down together, with only a type-initializer error in the log to explain it.

Minimap only exists on a game client. It is never present on a dedicated server. An optional client-side feature was able to take down an entire server mod.

What changed

Both fields are now resolved lazily, and a failure to resolve them is handled rather than fatal. If either field cannot be read on the running game build, shared exploration disables itself and writes a single warning naming the reason. Every other feature loads and runs normally.

Do I need this?

If your server runs fine today, this changes nothing you can see — on a game build where the fields resolve normally, behaviour is identical to 0.13.1, shared exploration included.

Its value is what happens on the next Valheim update: a field-shape change that would previously have taken the whole plugin offline now costs you one optional feature.

Recommended for all servers.

Upgrade notes

Drop-in. No configuration changes, no new or renamed config keys, and no world or save-data changes. Clients do not need updating — this is a patch release, so the client compatibility handshake is unchanged and any client that worked with 0.13.1 still works.

ValheimOne 0.13.1

ValheimOne 0.13.1 is a dashboard overhaul: a readability pass across the live map, console, and codex, a cleaner sidebar, and big performance fixes for long-lived worlds — plus verifiable, reproducible release builds.

Added

• The Codex list has a sticky column header (Item, Category, Weight, Stack, Portal) with properly aligned columns, and the category filter is a themed dropdown with per-category icons instead of a native select.
• The sidebar's World, Server, and Join Code rows each carry a small copy icon, replacing the old Copy button. When the world and server names are identical the two rows collapse into one.
• Embedding hosts that render their own navigation can pass externalNav: true in the embed config and drive the view through ValheimOneEmbed.setView("map"|"console"|"codex"); the built-in view switcher stays hidden in that mode.
• Every release is now byte-for-byte reproducible: tools/release/provenance.tsv records the authoritative artifact hashes with the exact pinned toolchain (.NET SDK, BepInEx pack, Valheim build), CI refuses to release anything it cannot rebuild to those hashes, and tools/verify-reproducible.sh --release v0.13.1 lets anyone rebuild from source and verify the published DLL is exactly what the source produces.

Changed

• A readability pass across the dashboard: Codex rows, item details, recipes, chips, popups, console side panels, dungeon dialogs, and search results moved from 7–10 px type up to 10–14 px, and secondary text is brighter against the dark background.
• The sidebar below the server details is a single scrolling column: Players, Chat, Leaderboard, and Server Events keep their natural height, expanding a section pushes the content below it, and nothing overlaps. Cinema Mode moved from a full-width pill to a compact icon beside the brand mark.
• The default map view centres the world circle in the visible map area, compensating for the floating Layers panel.
• Overview clustering for cartography pins and point-of-interest layers now engages below the 1:1 overview zoom, so dense long-lived worlds no longer render thousands of individual markers on first open. Sparse worlds look exactly as before.

Fixed

• PublicShowPlayerNames now defaults to false: a public map link never shows player names unless the server owner explicitly opts in. Values you have explicitly saved are respected either way.
• Scrolling the Codex no longer rebuilds the whole visible window every few pixels; rows are recycled and renders are coalesced per animation frame, removing main-thread stalls on large catalogs.
• Cartography pins no longer tear down and rebuild every marker on each poll when nothing changed.
• The shipped DLL no longer embeds any build-environment detail (debug-info paths, repository URL, commit SHA), which is what made byte-for-byte verification impossible before.

Upgrading

Drop-in update: replace ValheimOne.dll and restart. No new config keys. If your public map deliberately showed player names, set PublicShowPlayerNames = true — the default is now off.

Install

• ValheimOne-0.13.1.zip — plugin only, for servers already running BepInEx 5.4.x.
• ValheimOne-full-0.13.1.zip — plugin plus the BepInEx pack, for a from-scratch install.

Checksums

250dc811e4ab8e37fd276100b1feea2d8639fef3cc856699919816a0cd6e7355  ValheimOne-0.13.1.zip
894317f0e691e4b7bb570879091685ed76d63b8d9e0a6826961a7decc9f12d4a  ValheimOne-full-0.13.1.zip

ValheimOne 0.13.0

ValheimOne 0.13.0 adds World Timelapse: scrub back through your world's history on the live map and watch exploration, bases, and boss progress unfold.

Added

• World Timelapse on the admin and shared map views. A timeline scrubber sits at the bottom of the map with play/pause, 1x/4x/12x speeds, day and date readouts, arrow-key frame stepping, and Home/End/Space/Escape controls.
• The server records periodic aggregate snapshots of the explored map, clustered base footprints, world day and boss progression, aggregate movement, and portal/bed/ward positions (when the entity layer is enabled). Snapshots store state, not images, and contain no individual player positions or names.
• New [LiveMap] config keys: Timelapse (default true), TimelapseIntervalMinutes (default 60, clamped 5-1440), and PublicTimelapse (default false - public visitors get nothing unless you explicitly turn it on).

Changed

• Live layers (fog, heatmap, bases, portals, beds, wards, portal network, ward radius) hide while the timelapse is open and come back exactly as they were when it closes, so history never overlaps the live picture.

Retention

Frames are kept in full for 14 days, then thinned to one per day for up to a year, with hard caps of 1,024 frames and 24 MB. The newest frame is always kept.

Upgrading

Drop-in update: replace ValheimOne.dll and restart. New config keys appear with safe defaults; no schema change.

Install

• ValheimOne-0.13.0.zip — plugin only, for servers already running BepInEx 5.4.x.
• ValheimOne-full-0.13.0.zip — plugin plus the BepInEx pack, for a from-scratch install.

Checksums

7c24cf86303aa15f1cd3208c7866d2e4d20dfe40d35c874a05674513e8220ec3  ValheimOne-0.13.0.zip
1223ee9e2f2e0de0d0d71257719d55a4c4200f8185fbcd0e7631080705d34a0e  ValheimOne-full-0.13.0.zip

ValheimOne 0.12.2

ValheimOne 0.12.2 is a single layout fix for short browser windows.

Fixed

• The live map sidebar's brand block no longer shrinks below its own content when vertical space is tight. In a short browser window, or inside an embedding host page, the Cinema Mode button could overlap the view tabs.

Upgrading

Drop-in update: replace ValheimOne.dll and restart. No config changes, no schema change.

Checksums

b1a4046229a4bcede9081c8b8b2f7427d967abf07b548a7de7c560780a0555ae  ValheimOne-0.12.2.zip
28193c3616cea66d1003853b83d6d2b5e8714405caa71a35ed94dc03b2bd0e3d  ValheimOne-full-0.12.2.zip

ValheimOne 0.12.1

ValheimOne 0.12.1 makes the live map embeddable in another page and cuts repeat asset transfer to a revalidation round trip. A patch release — the network handshake is untouched, so 0.12.0 clients stay compatible.

Added

• Embeddable live map. GET /api/embed returns a body fragment, and assets/app.embed.js / assets/app.embed.css provide a root-scoped bundle, so a host page can render the map natively instead of putting it in an iframe.
• Cached static assets. LiveMap now serves strong ETags, honours If-None-Match with a 304, and ships pre-computed gzip payloads. A returning viewer downloads a revalidation round trip instead of the whole bundle.

Changed

• The embedded map isolates itself properly: it mounts into a caller-supplied root, routes every request through a configurable API base, keeps keyboard shortcuts and scroll handling inside that root, and leaves the host page's body, document title and URL hash alone.

Upgrading

Drop-in update: replace ValheimOne.dll and restart. No config changes, no schema change. Standalone map behaviour is unchanged.

Checksums

805f4a0164e477d98165fa2a54dfea52b5a49edc60f74dd73c592bd09953bf6e  ValheimOne-0.12.1.zip
f40ebd54f4836ff47c653e2301fde1df645b67dc9075f995c5dc2a332b3ea9ae  ValheimOne-full-0.12.1.zip

ValheimOne 0.12.0

ValheimOne 0.12.0 is the biggest content drop yet: step inside your world's dungeons from the web map, and browse a full item and recipe codex for your server — plus live creatures, base detection, ship towing, activity heatmaps, leaderboards, and two-way chat.

Dungeon Interior Viewer

Every burial chamber, sunken crypt, troll cave, frost cave, infested mine, and Ashlands ruin in your world is now discoverable on the map — and the generated ones can be opened. Click View Interior on a dungeon entrance to get a top-down schematic of its actual room layout, drawn from the world's own saved dungeon data: rooms, footprints, elevation, and the entrance, with a scale bar and north-up orientation.

While vikings are exploring underground, you'll see them live inside the dungeon — their markers move through the rooms in real time, and the map roster tags them with In: Burial Chamber so you always know where your players went when they vanished off the surface. Dungeon data is admin- and shared-view only; public maps see none of it.

Codex of Items

The map gains a Codex of Items tab: a searchable, categorized encyclopedia of every item on your server — stats, crafting recipes, upgrade costs, smelting/conversion sources, and which creatures drop what, with jump-links so you can chase a recipe chain from boss drop to finished weapon. The codex is generated from the game itself, so it always matches the version your server is running, and it's available on every view tier including public maps.

There's a console side too: vo item <name> gives a quick item summary with recipe uses, with lazy item-name autocomplete in the web console.

Live world layers

• Creatures — a default-off layer showing active bosses, serpents, and raid mobs in the event area, with live counts, creature map art, star levels, and smooth movement. Admin and shared views only.
• Bases — a default-off layer that surveys player-built structures and groups them into base areas with approximate structure counts, so you can see where your players have settled. Never exposed to public views.
• Activity Heatmap — a default-off overlay showing where players actually spend their time, as private aggregate 24-hour and 7-day windows. No per-player data is stored, and public views have no heatmap access at all.

Leaderboard and chat

• Leaderboard — a wipe-scoped sidebar panel ranking characters by playtime, deaths, and distance traveled. Display names only, admin and shared views only, and it resets automatically with a new world.
• Chat — admin and shared viewers get a live chat panel showing in-game shouts; admins can send messages back into the game from the browser, no web console required. Sends are rate-limited, length-capped, and recorded in the operator audit log.

Ship towing

Admins can now tow unattended ships from the ship's map popup — handy for rescuing a karve beached halfway across the world. Moves are refused when any player is within 12 meters or the destination is more than 5 kilometers away, so it can't be used to yank a boat out from under someone.

Fixes

• Server-originated shouts (shutdown countdowns, web pings, web chat) no longer spam a harmless player-lookup error in the dedicated-server log, and no longer emit a platform-ID parse error in each connected player's log.

Upgrading

Drop-in update: replace ValheimOne.dll and restart. No config changes — 0.12.0 adds no new config keys, and every new layer/panel follows the existing view-tier rules (nothing new is exposed to public views except the item codex, which contains no world or player data). Leaderboard, heatmap, and chat history live in small sidecar files next to your world data and are created automatically.

Checksums

23ff1eb64bfe0a7a25f3fc70ee82ab9050e97b6a00dfca69ac8febfd6adccb1a  ValheimOne-0.12.0.zip
600a5b642dcc1d919e8ddd4a8c77047d94598e81e8fdc5819f860620400e85cd  ValheimOne-full-0.12.0.zip

ValheimOne 0.11.0

ValheimOne 0.11.0 brings scheduled graceful shutdowns and a noticeably smoother live map.

Timed graceful shutdown. Operators can schedule a clean stop with vo shutdown <seconds> [message] (or the admin shutdown API) and cancel it any time with vo shutdown cancel. Connected players receive shout countdowns as the deadline approaches, the pending shutdown is visible on the dashboard, and when the timer expires the world is saved synchronously before the server exits through Valheim's clean shutdown path.

Smoother, calmer live map.

• Player, ship, and cart markers now glide between live updates instead of jumping; portal hops and respawns snap cleanly without streaking a trail across the world, and follow and Cinema Mode stay attached to the moving marker.
• A slim parchment metrics strip above the map shows server status, day, and uptime in every view; console-authorized admins also see frame time and ZDO counts on the map's normal 30-second cadence.
• Dense POI layers (Dungeons, Spawners, Ores & Deposits, Forage, Structures) stay off the map until useful zoom levels — layer counts remain visible with a clear zoom-in hint, and checked and collapsed states are preserved.
• Map search now accepts Valheim x, z world-coordinate pairs and flies straight to the point, with a themed notice for coordinates beyond the world edge.

Console quality of life. The web console completes vo commands from bare subcommand prefixes, adds terse recovery guidance to kick, ban, and shutdown confirmations, and replays the latest 30 command-journal entries behind a live-feed divider on first open.

Sturdier polling. Hidden tabs pause recurring map requests and refresh immediately on return; after three consecutive failures the map stops retrying and shows reload guidance instead of hammering an unreachable server, and the initial map shade times out instead of spinning forever.

Upgrade from any 0.10.x by replacing the DLL. No configuration changes are required — this release adds no new config keys.

ValheimOne 0.10.3

ValheimOne 0.10.3 fixes the resource-node survey regression introduced in 0.10.2. Surveys no longer abort and return empty resource layers when progress reporting cannot access a game internal; progress safely falls back to an indeterminate state.

All servers running 0.10.2 should update to 0.10.3. No configuration changes are required.

ValheimOne 0.10.2

ValheimOne 0.10.2 closes a LiveMap privacy gap around cartography-table pins.

Upgrade note

This release adds [LiveMap] PublicPins, which defaults to false. Shared and public map links no longer expose player platform IDs: shared viewers see pin authors as “a viking,” while public viewers receive no cartography pins unless PublicPins is explicitly enabled—and author identity is still removed when it is enabled.

Servers that intentionally want cartography pins on public map links can opt in with PublicPins = true. No action is needed to keep the safer default.

Heavy-world honesty and map UX

• Ships, carts, portals, tombstones, wards, and beds now have separate scan budgets, so a world packed with one entity type no longer crowds every other type out. Capped results are clearly marked.
• Resource groups that hit the 5,000-entry safety cap now say 5,000+ and explain that the world contains more instead of presenting a partial count as complete.
• First-time ore and forage surveys show progress, an estimated wait, and a short explanation while the server scans the world.
• Cartography pins cluster into compact count markers at overview zoom and expand into individual pins as you zoom in.

Use ValheimOne-0.10.2.zip for an existing BepInEx server, or ValheimOne-full-0.10.2.zip for a from-scratch dedicated-server install. SHA256SUMS-0.10.2.txt contains checksums for both packages.

ValheimOne 0.10.1

Bigger, readable layer panel text.

The live map's right-side Layers panel and Legend were too small to read comfortably — this release fixes that, plus a round of polish across the map UI:

• Readable panel text — layer rows, counts, section headers, legend, and controls raised to a comfortable size with better contrast, on a slightly wider panel. Long POI sections (Dungeons, Spawners, Ores & Deposits, Forage, Structures) are now collapsible and start collapsed, and your open/closed choices are remembered.
• Bosses menu, grouped — the Bosses jump menu now shows each Forsaken once, in progression order, with its icon and altar count. Click to fly to the nearest altar; click again to cycle through the rest.
• Cinema Mode — Watch mode is now called Cinema Mode. It settles into view in about three seconds, and on an empty server it tours spawn, traders, and boss altars until someone joins (existing cinema permalinks keep working; a stall when opening a cinema permalink on an idle server is fixed).
• Tidier sidebar — consistent section headers and spacing, no more stretched icons, wind and explored on one clean row, and the Saga panel is now titled Server Events.
• New boss icons — dedicated silhouette art for all seven Forsaken across map markers, progression chips, popups, and menus.

No config changes; drop-in update from 0.10.0.