Valheim Live Map: Difference between revisions

From Survival Servers
Jump to navigation Jump to search
Update Valheim 1.0 save guidance and ValheimOne map, fog and client requirements
[wiki:wiki-operator] Reworded to the house writing rules; facts that were wrong today corrected (approved by Ryan, Nov 17)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#seo:
{{#seo:
|title=Valheim Live Map: See Your Real World in the Browser
|title=Valheim Live Map: See Your Real World in the Browser
|description=A Valheim live map shows your actual server world in a browser: players, ships, carts and portals moving in real time, configurable fog of war, and a public link you can share. How it differs from a seed preview, and how to add one to any dedicated server.
|description=A Valheim live map shows your real server world in a browser, with players, ships and portals moving live. How to share it and add it to any server.
}}
}}
A '''Valheim live map''' is a web page that shows the world your server is actually running, updated as people play. It is not the same thing as a seed map. A seed preview draws the terrain a seed would generate; a live map draws your real world and puts the players, ships, carts and portals on it as they move. This guide covers what a live map shows, how to share it without giving away admin, and how to add one to any Valheim dedicated server.
A '''Valheim live map''' is a web page that shows the world your server is actually running, updated as people play. It's not the same thing as a seed map. A seed preview draws the terrain a seed would generate. A live map draws your real world and puts the players, ships, carts and portals on it as they move.


== Live map or seed preview? ==
== Live map or seed preview? ==
Line 9: Line 9:
Two very different tools come up when you search for a Valheim server map, and they answer different questions.
Two very different tools come up when you search for a Valheim server map, and they answer different questions.


{| class="wikitable"
If you only want to look at a seed, skip to [[#Only want to preview a seed?|the seed preview section]]. If you want to see what's going on in the world your friends are playing, you need a live map.
! !! Seed preview !! Live map
|-
| What it draws || The terrain a seed would generate: biomes, coastlines, boss altars, the trader, dungeons. || Your actual world, generated from the server's own seed, with everything on it right now.
|-
| Players and ships || No. || Yes, moving in real time.
|-
| Explored area || The whole map, nothing hidden. || Configurable fog, with an optional opaque cover for unexplored areas on the Public view.
|-
| Runs where || A website. You type in a seed. || On the server, as a mod. You open a link.
|-
| Good for || Scouting a seed before you start a world. || Running and sharing a world that already exists.
|}
 
If you only want to look at a seed, skip to [[#Only want to preview a seed?|the seed preview section]]. If you want to see what is going on in the world your friends are playing, you need a live map.


== What ValheimOne shows ==
== What ValheimOne shows ==


[https://github.com/HumanGenome/ValheimOne ValheimOne] is a free, open source, server side mod for Valheim dedicated servers. Its live map is drawn from the server's seed with the game's own world generator, then updated from the running server. The map, browser console and alerts work with vanilla players on PC or console. Optional gameplay modules marked '''Synced''' require ValheimOne on each player's PC; console players cannot install those client mods.
[https://github.com/HumanGenome/ValheimOne ValheimOne] is a free, open-source mod that runs on Valheim dedicated servers. Its live map is drawn from the server's seed with the game's own world generator, then updated from the running server. The map, browser console and alerts work with vanilla players on PC or console. Optional gameplay modules marked '''Synced''' need ValheimOne on each player's PC. Console players can't install those mods. Player steps: [[How to Install ValheimOne on Your PC]].


[[File:ValheimOne_live_map_admin_view.png|none|800px|ValheimOne live map, admin view]]
[[File:valheimone-live-map-20260909-r3.png|none|800px|alt=ValheimOne live map of a Valheim world with biome names, the Deep North along the top edge and the Ashlands along the bottom.|ValheimOne live map, admin view]]


=== Players, ships, carts and portals ===
=== Players, ships, carts and portals ===


Every player is a marker that moves as they move. Ships, carts, portals, tombstones, wards and beds show where they are in the world, so you can see who sailed off with the longship, where the last tombstone dropped, and where every portal stands.
Every player is a marker that moves as they move. Ships, carts, portals, tombstones, wards and beds show where they are in the world, so you can see who sailed off with the longship, where the last tombstone dropped, and where every portal stands. Ships, carts and portals need the optional '''Entity Layer''' (<code>EntityLayer = true</code>), which is off by default.


<span id="Fog_of_war_that_matches_the_game"></span>
<span id="Fog_of_war_that_matches_the_game"></span>
=== Fog of war and unexplored areas ===
=== Fog of war and unexplored areas ===


Fog applies to the '''Public''' view. <code>FogMode = trails</code> follows player travel; <code>FogMode = explored</code> also incorporates exploration recorded at cartography tables. <code>FogMode = off</code> shows the full terrain.
Fog applies to the '''Public''' view. <code>FogMode = trails</code> follows player travel. <code>FogMode = explored</code> also adds the exploration recorded at cartography tables. <code>FogMode = off</code> shows the full terrain.


The default fog treatment is a translucent tint, so the coastline and biomes remain visible. In ValheimOne 0.13.4 and later, enable <code>FogHideUnexplored = true</code> with <code>FogMode = trails</code> or <code>explored</code> to draw an opaque cover over unexplored terrain and withhold unexplored region names, spawn and trader markers. On Survival Servers, use '''Hide unexplored areas completely''' in the tool's '''Share''' tab. The setting has no effect when fog is off, and it does not restrict the Admin or Shared views.
By default, fog is a see-through tint, so the coastline and biomes stay visible. In ValheimOne 0.13.4 and later, set <code>FogHideUnexplored = true</code> with <code>FogMode = trails</code> or <code>explored</code>. That draws a solid cover over unexplored land and hides unexplored region names, spawn and trader markers. On Survival Servers, use '''Hide unexplored areas completely''' in the tool's '''Share''' tab. The setting has no effect when fog is off, and it doesn't limit the Admin or Shared views.


[[File:ValheimOne_public_map_fog_of_war.png|none|800px|The Public view with the original translucent fog treatment; the optional opaque cover is configured separately.]]
[[File:ValheimOne_public_map_fog_of_war.png|none|800px|alt=ValheimOne public map view of a Valheim world with fog dimming unexplored land and the Layers list open on the right.|The Public view with the default see-through fog. The optional solid cover is a separate setting.]]


=== Deep zoom, heatmap and timelapse ===
=== Deep zoom, heatmap and timelapse ===


The map zooms from the whole world down to individual buildings. A heatmap layer shows where everyone has been over the last day or week. World Timelapse scrubs back through explored fog, base growth and movement history, and the Sagas leaderboard ranks playtime, deaths and distance travelled.
The map zooms from the whole world down to individual buildings. A heatmap layer shows where everyone has been over the last day or week. World Timelapse plays back explored fog, base growth and movement history. The Sagas leaderboard ranks playtime, deaths and distance travelled.


=== Inside dungeons ===
=== Inside dungeons ===


Click a dungeon entrance and the map opens a top down plan of its rooms, read from the game's own generated layout, with any players inside drawn where they stand.
Click a dungeon entrance and the map opens a top-down plan of its rooms, read from the game's own generated layout, with any players inside drawn where they stand.


=== What else is in the box ===
=== What else it adds ===


The same mod adds a browser admin console, covered in [[Valheim Console Commands|Valheim admin commands]], a searchable item codex, Discord alerts for joins, deaths and raids, server browser support for crossplay servers, and a set of optional server rules that are all off until you turn them on.
The same mod adds a browser admin console, covered in [[Valheim Console Commands|Valheim admin commands]]. It also adds a searchable item codex, Discord alerts for joins, deaths and raids, server browser support for crossplay servers, and a set of optional server rules that are all off until you turn them on.


== Sharing the map: Admin, Shared and Public ==
== Sharing the map: Admin, Shared and Public ==
Line 61: Line 47:


* '''Admin''' sees everything and has the console. Keep this link to yourself.
* '''Admin''' sees everything and has the console. Keep this link to yourself.
* '''Shared''' shows live players and every map layer, but never allows a single admin action. Give it to the people playing.
* '''Shared''' shows live players and every map layer, but allows no admin actions. Give it to the people playing.
* '''Public''' is read only. Its terrain visibility depends on <code>FogMode</code> and <code>FogHideUnexplored</code>; it is not automatically hidden just because the link is public. Cartography pins and web pins stay hidden unless their public-view settings are enabled. Open the link without your admin or shared token and check what visitors can see before posting it.
* '''Public''' is read only. What terrain it shows depends on <code>FogMode</code> and <code>FogHideUnexplored</code>. A public link doesn't hide the terrain by itself. Cartography pins and web pins stay hidden unless their public-view settings are on. Before you post the link, open it without your admin or shared token and check what visitors see.
 
'''Note:''' The Shared and Public links never expose the console or any admin action, so handing out the map does not hand out control of the server.


== How to get a live map on your server ==
== How to get a live map on your server ==


=== Self hosted dedicated server ===
=== Self-hosted dedicated server ===


ValheimOne runs on [https://github.com/BepInEx/BepInEx BepInEx 5.4], the standard Valheim mod loader.
ValheimOne runs on [https://github.com/BepInEx/BepInEx BepInEx 5.4], the standard Valheim mod loader.


# Download the current [https://github.com/HumanGenome/ValheimOne/releases/latest GitHub release]. The [https://www.nexusmods.com/valheim/mods/3571 Nexus listing] is another distribution channel; check that its file version matches GitHub before downloading. Use the plugin-only ZIP if BepInEx is installed, or the Full ZIP for a fresh installation.
# Download the current [https://github.com/HumanGenome/ValheimOne/releases/latest GitHub release]. You can also get it from the [https://www.nexusmods.com/valheim/mods/3571 Nexus listing]. Check that its file version matches GitHub before you download. Use the plugin-only ZIP if BepInEx is installed, or the Full ZIP for a fresh install.
# Stop the server before replacing plugin files. Extract the ZIP into the dedicated server's root folder, so the plugin is at <code>BepInEx/plugins/ValheimOne.dll</code>. When updating, preserve your existing <code>BepInEx/config/valheimone.cfg</code> rather than replacing it with the packaged defaults. For a Full installation on Linux, use the included <code>start_server_bepinex.sh</code> launcher with your server's normal launch arguments.
# Stop the server before replacing plugin files. Extract the ZIP into the dedicated server's main folder, so the plugin is at <code>BepInEx/plugins/ValheimOne.dll</code>. When you update, keep your existing <code>BepInEx/config/valheimone.cfg</code> instead of replacing it with the defaults in the ZIP. For a Full install on Linux, use the included <code>start_server_bepinex.sh</code> launcher with your server's normal launch options.
# Start once to let BepInEx load the plugin and create any missing config, then stop the server before editing the initial setup. In <code>BepInEx/config/valheimone.cfg</code>, set <code>Enabled = true</code> in the existing <code>[LiveMap]</code> section. The map is disabled by default.
# Start the server once so BepInEx loads the plugin and creates any missing settings, then stop it before you edit them. In <code>BepInEx/config/valheimone.cfg</code>, set <code>Enabled = true</code> in the existing <code>[LiveMap]</code> section. The map is off by default.
# In that same section, set <code>AccessToken</code> to a long, unique secret. Set <code>PublicView = false</code> while you configure the map. Leave <code>Port = 8790</code> unless that TCP port is already used, and allow your chosen port through the server firewall for the people who should have access.
# In that same section, set <code>AccessToken</code> to a long, unique secret. Set <code>PublicView = false</code> while you configure the map. Leave <code>Port = 8790</code> unless that TCP port is already in use. Allow your port through the server firewall for the people who should have access.
# Start the server and wait for its world to load. For local or trusted-network access, open <code>http://your-server-ip:8790/?token=YOUR_ADMIN_TOKEN</code>, replacing the address, port and token with your own values. Use HTTPS through a reverse proxy for Internet access to an authenticated map or console.
# Start the server and wait for its world to load. For access on your own or a trusted network, open <code><nowiki>http://your-server-ip:8790/?token=YOUR_ADMIN_TOKEN</nowiki></code> with your own address, port and token. For access over the internet, put the map and console behind HTTPS with a reverse proxy.
# To share the map, set a separate <code>ShareToken</code> for trusted players, or enable <code>PublicView</code> for the restricted, tokenless view. Configure the fog and public layers before distributing that link. Never share the admin token.
# To share the map, set a separate <code>ShareToken</code> for trusted players, or turn on <code>PublicView</code> for the limited view that needs no token. Set up the fog and public layers before you share that link. Never share the admin token.


To enable browser commands, also set <code>ConsoleEnabled = true</code> in <code>[LiveMap]</code>; it is off by default. See [[Valheim Console Commands#Running admin commands from a browser|browser admin-console setup]]. Building the dedicated server itself is covered in [[How to Create a Valheim Server Guide]].
Set <code>EntityLayer = true</code> in <code>[LiveMap]</code> if you want the optional ships, carts and portals layer. To turn on browser commands, also set <code>ConsoleEnabled = true</code> in <code>[LiveMap]</code>. It's off by default. Setup steps: [[Valheim Console Commands#Running admin commands from a browser|browser admin-console setup]]. How to build the dedicated server itself: [[How to Create a Valheim Server Guide]].


'''Note:''' A Valheim update can require an update to BepInEx or individual plugins. Match the plugin release to your game version and check its release notes before enabling gameplay changes. [[Valheim Incompatible Version Error]] covers game-version mismatches; they are not the only possible cause of a failed connection.
'''Note:''' A Valheim update can require an update to BepInEx or individual plugins. Match the plugin release to your game version and check its release notes before you turn on gameplay changes. [[Valheim Incompatible Version Error]] covers game version mismatches. They aren't the only cause of a failed connection.


=== Rented server ===
=== Rented server ===


Some hosts ship ValheimOne pre installed as a mod option in the control panel, with the map, console and share links wired into the panel. Check your host's Valheim page or mod list; if it is there, turning it on is a settings change and a restart, and players do not need the plugin for the map, browser console or alerts. Optional Synced gameplay settings still need ValheimOne on each participating PC.
Some hosts ship ValheimOne preinstalled as a mod option in their control panel, with the map, console and share links built in. Check your host's Valheim page or mod list. If it's there, turning it on is a settings change and a restart, and players don't need the plugin for the map, browser console or alerts.


== Only want to preview a seed? ==
== Only want to preview a seed? ==


If you just want to scout a seed, a seed preview site is the right tool. [https://valheim-map.world/ valheim-map.world] and [https://www.valheim.tools/seed-map valheim.tools] draw the terrain, biomes, boss altars, trader and dungeons for any seed you type in, without loading the game. They cannot show buildings, players, or what has been explored, because none of that exists until a world is created and played. Check that a viewer supports your game and world-generation version; a migrated world can have locations that a fresh seed preview does not reproduce. Finding the seed of a world you already have is covered in [[How to Find Your Valheim Seed]].
Our [https://www.survivalservers.com/tools/valheim-map/ Valheim seed map] previews terrain, biomes, boss locations and trader candidates for a fresh Valheim 1.0 world. It's free to use in your browser, with no mod or account required.
 
To scout a seed, use a seed preview site. [https://valheim-map.world/ valheim-map.world] and [https://www.valheim.tools/seed-map valheim.tools] draw the terrain, biomes, boss altars, trader and dungeons for any seed you type in, without loading the game. They can't show buildings, players or what's been explored, because none of that exists until a world is created and played. Check that a viewer supports your game and world generation version. A world carried over from an older version can have locations that a fresh seed preview doesn't show. To find the seed of a world you already have: [[How to Find Your Valheim Seed]].
 
 
== Watch it in 78 seconds ==
[https://www.youtube.com/watch?v=w2-gAIoS_T8 Watch the 78-second walkthrough&nbsp;on&nbsp;YouTube]
 
A short walkthrough of the live map, the layers and the browser console on a real server.


== See also ==
== See also ==


:[[How to Install ValheimOne on Your PC]]
:[[How to Find Your Valheim Seed]]
:[[How to Find Your Valheim Seed]]
:[[Valheim Console Commands|Valheim admin commands]]
:[[Valheim Console Commands|Valheim admin commands]]
Line 100: Line 93:
:[[Valheim Incompatible Version Error]]
:[[Valheim Incompatible Version Error]]


ValheimOne is included with [https://www.survivalservers.com/services/game_servers/valheim/ Valheim server hosting] from Survival Servers: press Browse next to the Mod field in the control panel, pick ValheimOne, then Save Settings and restart the server. The live map, console and share links show up in the panel as soon as the server is running.
ValheimOne is included with [https://www.survivalservers.com/services/game_servers/valheim/ Valheim server hosting] from Survival Servers: click Browse next to the Mod field in the Command Center, pick ValheimOne, then click Save Settings & Restart. The live map, console and share links show up under TOOLS > ValheimOne as soon as the server is running.

Latest revision as of 09:10, 17 November 2026

A Valheim live map is a web page that shows the world your server is actually running, updated as people play. It's not the same thing as a seed map. A seed preview draws the terrain a seed would generate. A live map draws your real world and puts the players, ships, carts and portals on it as they move.

Live map or seed preview?

Two very different tools come up when you search for a Valheim server map, and they answer different questions.

If you only want to look at a seed, skip to the seed preview section. If you want to see what's going on in the world your friends are playing, you need a live map.

What ValheimOne shows

ValheimOne is a free, open-source mod that runs on Valheim dedicated servers. Its live map is drawn from the server's seed with the game's own world generator, then updated from the running server. The map, browser console and alerts work with vanilla players on PC or console. Optional gameplay modules marked Synced need ValheimOne on each player's PC. Console players can't install those mods. Player steps: How to Install ValheimOne on Your PC.

ValheimOne live map of a Valheim world with biome names, the Deep North along the top edge and the Ashlands along the bottom.

Players, ships, carts and portals

Every player is a marker that moves as they move. Ships, carts, portals, tombstones, wards and beds show where they are in the world, so you can see who sailed off with the longship, where the last tombstone dropped, and where every portal stands. Ships, carts and portals need the optional Entity Layer (EntityLayer = true), which is off by default.

Fog of war and unexplored areas

Fog applies to the Public view. FogMode = trails follows player travel. FogMode = explored also adds the exploration recorded at cartography tables. FogMode = off shows the full terrain.

By default, fog is a see-through tint, so the coastline and biomes stay visible. In ValheimOne 0.13.4 and later, set FogHideUnexplored = true with FogMode = trails or explored. That draws a solid cover over unexplored land and hides unexplored region names, spawn and trader markers. On Survival Servers, use Hide unexplored areas completely in the tool's Share tab. The setting has no effect when fog is off, and it doesn't limit the Admin or Shared views.

ValheimOne public map view of a Valheim world with fog dimming unexplored land and the Layers list open on the right.

Deep zoom, heatmap and timelapse

The map zooms from the whole world down to individual buildings. A heatmap layer shows where everyone has been over the last day or week. World Timelapse plays back explored fog, base growth and movement history. The Sagas leaderboard ranks playtime, deaths and distance travelled.

Inside dungeons

Click a dungeon entrance and the map opens a top-down plan of its rooms, read from the game's own generated layout, with any players inside drawn where they stand.

What else it adds

The same mod adds a browser admin console, covered in Valheim admin commands. It also adds a searchable item codex, Discord alerts for joins, deaths and raids, server browser support for crossplay servers, and a set of optional server rules that are all off until you turn them on.

Sharing the map: Admin, Shared and Public

ValheimOne serves three views of the same map, each behind its own link, and you decide who gets which.

  • Admin sees everything and has the console. Keep this link to yourself.
  • Shared shows live players and every map layer, but allows no admin actions. Give it to the people playing.
  • Public is read only. What terrain it shows depends on FogMode and FogHideUnexplored. A public link doesn't hide the terrain by itself. Cartography pins and web pins stay hidden unless their public-view settings are on. Before you post the link, open it without your admin or shared token and check what visitors see.

How to get a live map on your server

Self-hosted dedicated server

ValheimOne runs on BepInEx 5.4, the standard Valheim mod loader.

  1. Download the current GitHub release. You can also get it from the Nexus listing. Check that its file version matches GitHub before you download. Use the plugin-only ZIP if BepInEx is installed, or the Full ZIP for a fresh install.
  2. Stop the server before replacing plugin files. Extract the ZIP into the dedicated server's main folder, so the plugin is at BepInEx/plugins/ValheimOne.dll. When you update, keep your existing BepInEx/config/valheimone.cfg instead of replacing it with the defaults in the ZIP. For a Full install on Linux, use the included start_server_bepinex.sh launcher with your server's normal launch options.
  3. Start the server once so BepInEx loads the plugin and creates any missing settings, then stop it before you edit them. In BepInEx/config/valheimone.cfg, set Enabled = true in the existing [LiveMap] section. The map is off by default.
  4. In that same section, set AccessToken to a long, unique secret. Set PublicView = false while you configure the map. Leave Port = 8790 unless that TCP port is already in use. Allow your port through the server firewall for the people who should have access.
  5. Start the server and wait for its world to load. For access on your own or a trusted network, open http://your-server-ip:8790/?token=YOUR_ADMIN_TOKEN with your own address, port and token. For access over the internet, put the map and console behind HTTPS with a reverse proxy.
  6. To share the map, set a separate ShareToken for trusted players, or turn on PublicView for the limited view that needs no token. Set up the fog and public layers before you share that link. Never share the admin token.

Set EntityLayer = true in [LiveMap] if you want the optional ships, carts and portals layer. To turn on browser commands, also set ConsoleEnabled = true in [LiveMap]. It's off by default. Setup steps: browser admin-console setup. How to build the dedicated server itself: How to Create a Valheim Server Guide.

Note: A Valheim update can require an update to BepInEx or individual plugins. Match the plugin release to your game version and check its release notes before you turn on gameplay changes. Valheim Incompatible Version Error covers game version mismatches. They aren't the only cause of a failed connection.

Rented server

Some hosts ship ValheimOne preinstalled as a mod option in their control panel, with the map, console and share links built in. Check your host's Valheim page or mod list. If it's there, turning it on is a settings change and a restart, and players don't need the plugin for the map, browser console or alerts.

Only want to preview a seed?

Our Valheim seed map previews terrain, biomes, boss locations and trader candidates for a fresh Valheim 1.0 world. It's free to use in your browser, with no mod or account required.

To scout a seed, use a seed preview site. valheim-map.world and valheim.tools draw the terrain, biomes, boss altars, trader and dungeons for any seed you type in, without loading the game. They can't show buildings, players or what's been explored, because none of that exists until a world is created and played. Check that a viewer supports your game and world generation version. A world carried over from an older version can have locations that a fresh seed preview doesn't show. To find the seed of a world you already have: How to Find Your Valheim Seed.


Watch it in 78 seconds

Watch the 78-second walkthrough on YouTube

A short walkthrough of the live map, the layers and the browser console on a real server.

See also

How to Install ValheimOne on Your PC
How to Find Your Valheim Seed
Valheim admin commands
How to Create a Valheim Server Guide
How to Set Up a Valheim Crossplay Server
How to Download Your Valheim World
Valheim Incompatible Version Error

ValheimOne is included with Valheim server hosting from Survival Servers: click Browse next to the Mod field in the Command Center, pick ValheimOne, then click Save Settings & Restart. The live map, console and share links show up under TOOLS > ValheimOne as soon as the server is running.