Valheim Live Map: Difference between revisions

From Survival Servers
Jump to navigation Jump to search
Link the ValheimOne player install guide
[wiki:ss-claude-11372] Fixes: wrong or outdated steps, labels and facts corrected, current pictures, dead links fixed, search title and description
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 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.


== Live map or seed preview? ==
== Live map or seed preview? ==


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"
! !! 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.
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.
Line 29: Line 15:
[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. [[How to Install ValheimOne on Your PC]] has the player steps.
[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. [[How to Install ValheimOne on Your PC]] has the player steps.


[[File:valheimone-live-map-20260909-r3.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>
Line 42: Line 28:
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.
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.


[[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 original translucent fog treatment; the optional opaque cover is configured separately.]]


=== Deep zoom, heatmap and timelapse ===
=== Deep zoom, heatmap and timelapse ===
Line 54: Line 40:
=== What else is in the box ===
=== What else is in the box ===


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 63: Line 49:
* '''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 never allows a single admin action. 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. 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.
'''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 ==
Line 76: Line 60:
# 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 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.
# 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 used, and allow your chosen 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 local or trusted-network access, open <code><nowiki>http://your-server-ip:8790/?token=YOUR_ADMIN_TOKEN</nowiki></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.
# 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 enable <code>PublicView</code> for the restricted, tokenless view. Configure the fog and public layers before distributing that link. Never share the admin token.


Line 85: Line 69:
=== 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 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.


== Only want to preview a seed? ==
== Only want to preview a seed? ==
Line 95: Line 79:


== Watch it in 78 seconds ==
== Watch it in 78 seconds ==
{{#ev:youtube|w2-gAIoS_T8|640|center}}
[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.
A short walkthrough of the live map, the layers and the browser console on a real server.


Line 108: 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: press Browse next to the Mod field in the Command Center, pick ValheimOne, then press Save Settings & Restart. The live map, console and share links show up under TOOLS > ValheimOne as soon as the server is running.

Revision as of 06:13, 28 October 2026

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.

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 is going on in the world your friends are playing, you need a live map.

What ValheimOne shows

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. How to Install ValheimOne on Your PC has the player steps.

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 incorporates exploration recorded at cartography tables. FogMode = off 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 FogHideUnexplored = true with FogMode = trails or explored 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.

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 scrubs back through explored fog, base growth and movement history, and 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 is in the box

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 never allows a single admin action. Give it to the people playing.
  • Public is read only. Its terrain visibility depends on FogMode and FogHideUnexplored; 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.

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. The 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.
  2. Stop the server before replacing plugin files. Extract the ZIP into the dedicated server's root folder, so the plugin is at BepInEx/plugins/ValheimOne.dll. When updating, preserve your existing BepInEx/config/valheimone.cfg rather than replacing it with the packaged defaults. For a Full installation on Linux, use the included start_server_bepinex.sh launcher with your server's normal launch arguments.
  3. Start once to let BepInEx load the plugin and create any missing config, then stop the server before editing the initial setup. In BepInEx/config/valheimone.cfg, set Enabled = true in the existing [LiveMap] section. The map is disabled 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 used, and allow your chosen port through the server firewall for the people who should have access.
  5. Start the server and wait for its world to load. For local or trusted-network access, open http://your-server-ip:8790/?token=YOUR_ADMIN_TOKEN, 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.
  6. To share the map, set a separate ShareToken for trusted players, or enable PublicView for the restricted, tokenless view. Configure the fog and public layers before distributing that link. Never share the admin token.

Set EntityLayer = true in [LiveMap] if you want the optional ships, carts and portals layer. To enable browser commands, also set ConsoleEnabled = true in [LiveMap]; it is off by default. See browser admin-console setup. Building the dedicated server itself is covered in 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.

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.

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 is free to use in your browser, with no mod or account required.

If you just want to scout a seed, a seed preview site is the right tool. 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 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.


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: press Browse next to the Mod field in the Command Center, pick ValheimOne, then press Save Settings & Restart. The live map, console and share links show up under TOOLS > ValheimOne as soon as the server is running.