ValheimWebMap

Valheim WebMap

Mod for your Valheim server. Makes a live map of your world you open in a

browser. Share 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 drawn on top as their own

layer. Checkbox turns them off. 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.

• 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),, or. Same zip everywhere.

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

/BepInEx/plugins/WebMap

Folder holds WebMap.dll, websocket-sharp.dll, web. Mod managers

(r2modman, Gale, ) 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

/bepinex/com.valheimwebmap.server.cfg. Open the port:

-