ValheimWebMap

Valheim WebMap

Mod for your Valheim server. Makes a live map of your world you open in a browser. Share http://your_ip:3000. Players install nothing. Server only.

What it does

• Big map, every metre. One pixel is one metre. Seven zoom levels, and

three more past that where buildings, trees and rocks are drawn as shapes so they stay sharp. Shows ground the way players shaped it: flat bases, moats, roads, farms. Trees, bushes and rocks can be drawn on top as their own layer (off by default, tick "Trees & rocks" in Layers). Cut a forest down, map shows the clearing next time it draws.

• Buildings. Every piece anyone placed, drawn as a footprint in its

material colour. Hover to see what it is.

• 3D view. One click. Real ground, water, and every object drawn with the

game's own model: walls, roofs, portals, ruins, trees, rocks, boats. Same spot, same rotation, same size as in the game. Ground has fine grain up close, no seams, no grid. Base looks like your base.

• Sky, sun, shadows. The 3D view has a real sky: sun, stars, dawn and

dusk colours, fog to the horizon. Lit by the server's clock, so night on the server is night on the map (or pick noon, evening... in Layers). Buildings and trees cast shadows. Water ripples and mirrors the sky. Shadows are off on phones unless you turn them on.

• Fog of war. Ground nobody walked on is black. No switch to turn it off.

Close-up tiles only draw where players walked.

• Old trips count. Install the mod on a world you played for months and

the map still opens up everywhere anyone has been. The world save remembers which zones the game built, and it only builds them where someone stood. The mod lifts the fog there at start. Your in-game map itself lives in your character file, which the server never sees, so this is the closest thing to it. See reveal_visited.

• Live players. Arrow points where they look. Health bar. Biome. PvP,

sleeping, dead. Follow one. Pings and chat pins land on the map.

• Player card. Click a player, on the map, in 3D, or in the list. Card

shows health, stamina, eitr, what they wear and hold, how long they played, deaths, distance walked, visits. Updates live. Buttons: follow, go to, switch view.

• World structures. Abandoned houses, fuling villages, shipwrecks,

mountain and castle ruins drawn on the 2D map where someone has been. Boss altars, traders, crypt and cave entrances are not in it.

• Markers. Portals with their tags and links, tombstones, player bases,

boats, carts, your own markers.json. Boss altars, dungeons, traders and the world seed are never sent out. No spoilers.

• Stats. Per player: time played, visits, deaths, distance, portal trips,

biomes. Per server: day, explored %, pieces built, trees, who was online last 24 h.

• Events. Joins, leaves, deaths, chat, pings. Saved to events.jsonl.
• Export. Pick an area, get a 3D file. Ground, water, every building and

object, trees, markers. Opens in Blender, Unreal, Unity, Godot. Unreal pack has a heightmap too. See docs/EXPORT.md.

• Share links. The address bar follows you: #x,z,zoom in 2D,

#x,z,zoom,3d,distance,heading,tilt in 3D. Copy it (link button) and the other person lands on the same spot, same camera.

• Also: search, works on phone, dark UI, Discord webhook, POST /announce

to shout at everyone.

Install

Get the zip from GitHub Releases (each release has a SHA256SUMS next to it, for people who pin things), from Thunderstore, or from Nexus. Same zip everywhere.

1. Put [BepInEx] on the server. Unzip. Copy the plugins/WebMap folder to

<server>/BepInEx/plugins/WebMap

Folder holds WebMap.dll, websocket-sharp.dll, web/. Mod managers (r2modman, Gale, Thunderstore) do this for you. Lost the web/ folder? No matter: a copy lives inside the DLL and the map still shows. Put a web/ folder next to the DLL and it wins, so you can change the page.

Docker (lloesche/valheim-server): with BEPINEX=true, BepInEx lives at /opt/valheim/bepinex/BepInEx on the data volume. /config/bepinex is only config. Plugin goes to /opt/valheim/bepinex/BepInEx/plugins/WebMap. Easiest: bind-mount a host folder there. Example in tools/docker-compose.test.yml. Config lands in <config volume>/bepinex/com.valheimwebmap.server.cfg. Open the port: -p 3000:3000/tcp.

1. Start server once. It writes the default config to BepInEx/config.
2. Edit config if you want. Restart. Config is read at start only.
3. Open port 3000. Visit http://your_ip:3000.

Map data lives in plugins/WebMap/map_data/<World>/. Model library in plugins/WebMap/map_data/models/. Keep both when you update.

Behind Cloudflare or another cache? Purge it after every update, or set a rule to not cache this host. The mod already sends the right headers.

First start

Server draws the zoomed-out map first (zoom 0–5, ~500 tiles, one to two minutes on one core). Then close-up tiles where players walked. Page works right away: missing tiles show the zoomed-out one blown up, swap in when done. Counter bottom-left: drawn / waiting.

First start also exports the 3D models. A couple of thousand prefabs, a few minutes. Done once, kept forever. Log: WebMap: models exported N (readable meshes R, ...).

Textures